github/github-spec-kit
1
0
Fork 0
mirror of https://github.com/github/spec-kit.git synced 2026-07-03 12:28:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: broaden Article VI beyond constitution-only versioning

Browse Source 
Article VI now covers governance and versioning of all project
artifacts (constitution, specs, plans, tasks), not just constitution
amendments. This matches what spec-driven.md itself describes:
specifications versioned in branches, requirement changes propagating
across artifacts, and cross-artifact consistency.
This commit is contained in:
Manfred Riem
2026-05-11 09:28:59 -05:00
parent 85fc96b284
commit 058256758f
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
spec-driven.md
View File

@@ -347,16 +347,16 @@ Without this article, LLMs default to functional-only implementations—code tha
#### Article VI: Governance and Versioning
The constitution itself must be versioned, and changes must propagate consistently across all project artifacts:
All project artifacts—constitution, specifications, plans, and tasks—must be versioned, and changes must propagate consistently across dependent artifacts:
```text
Constitution amendments MUST:
- Follow semantic versioning (MAJOR.MINOR.PATCH)
- Include a sync impact report across all templates
Artifact changes MUST:
- Be versioned and traceable through version control
- Propagate to all dependent artifacts when modified
- Maintain cross-artifact consistency after every change
```
This article ensures that governance is not static. When principles evolve, plan templates, spec templates, task templates, and command files must remain aligned. Version bumps are classified by impact—major for removed or redefined principles, minor for additions, patch for clarifications—creating an auditable trail of architectural decisions.
This article ensures that governance is not static and that drift between artifacts is caught rather than silently accumulated. When a specification changes, affected plans and tasks must be re-evaluated. When principles evolve, templates and command files must remain aligned. Version bumps are classified by impact—major for removed or redefined principles, minor for additions, patch for clarifications—creating an auditable trail of architectural decisions.
#### Articles VII & VIII: Simplicity and Anti-Abstraction