---

id: 9331e103-1087-4015-b506-a03abb78dc59 title: 'spec: embed starter in binary; init writes it; new f0rge spec verb (dead-link fix)' state: closed labels: [] assignees: [] milestone: null created: 2026-09-08T09:42:24.497366457Z updated: 2026-09-08T10:11:04.959909658Z

SOURCE: swarm friction #1 (verified: f0rge init creates NO spec/; every -h "docs: spec/schema.md SSection" pointer is a dead link on fresh projects — the doc-truth wave only ever verified against the f0rge repo which has spec/ from M0). OWNER DECISION: embed the canonical spec/schema.md IN THE BINARY (single source of truth — no scrubbed copy, no drift): include_str! from the cli crate to repo ../../spec/schema.md. f0rge init writes it to spec/schema.md ONLY IF ABSENT (never clobber a project's own file); new verb f0rge spec prints it anytime; f0rge spec --write overwrites the file. Added to command tree + root help within budgets. DONE: fresh init -> spec/schema.md exists; f0rge spec prints it; all -h SSection pointers resolve on any project; budgets + tests green.