| name | build-structure |
| description | Generate and refresh the structural artifacts of this knowledge base โ category index pages, a timeline, a master index/TOC, and cross-reference links. Use when new topic files were added and indices need updating, when building repository structure beyond flat content, or when running a structure item from the roadmap. Concept-agnostic and idempotent โ derives everything from the concept and existing content; only rewrites generated regions. |
Build Structure (Claude Code adapter)
Canonical procedure: .github/skills/build-structure/SKILL.md. Read that file and follow it exactly. Read the Concept Definition in seed.md first (subject, taxonomy, conventions).
Summary โ regenerate structural artifacts from existing content, idempotently. Every generated file/region is wrapped in markers so regeneration only replaces generated content:
<!-- BEGIN GENERATED: <artifact> โ maintained by build-structure; do not edit by hand -->
...
<!-- END GENERATED: <artifact> -->
Artifacts:
- Category index pages
<category-slug>/index.md โ list every topic file in that folder (link + one-line description).
- Timeline
TIMELINE.md โ only if the subject is time-oriented; dated items sorted chronologically.
- Master index
index.md (lowercase โ it becomes the Pages site root index.html) โ all content grouped by concept.taxonomy, plus pointers to category indices and the timeline.
- Cross-references โ a
## Related block (2โ4 links) inside each dedicated topic file.
Never alter hand-written content outside the markers, and never touch seed.md sections 1โ7 (that's sync-seed's job). Keep output deterministic (stable ordering) so reruns are diff-free. Report created / updated / unchanged.
