Spec-Constitution
Create or update project constitution at .specify/memory/constitution.md.
Prerequisites: .specify/ directory structure must exist.
Workflow
- Load template - Read
.specify/memory/constitution.md - Find placeholders - Identify
[ALL_CAPS_IDENTIFIER]tokens - Collect values - From user input or repo context
- Draft constitution - Replace placeholders
- Propagate changes - Update dependent templates
- Validate - No unexplained placeholders
- Write file - Save constitution
- Report - Summary with commit suggestion
Placeholders
| Token | Description |
|---|---|
[PROJECT_NAME] | Project identifier |
[PRINCIPLE_N_NAME] | Principle titles |
[PRINCIPLE_N_DESCRIPTION] | Principle details |
[CONSTITUTION_VERSION] | MAJOR.MINOR.PATCH |
[RATIFICATION_DATE] | YYYY-MM-DD |
[LAST_AMENDED_DATE] | YYYY-MM-DD |
Version Bumping
- MAJOR: Breaking governance changes
- MINOR: New principles/sections
- PATCH: Clarifications, typos
Propagation Checklist
After updating constitution, check:
.specify/templates/plan-template.md.specify/templates/spec-template.md.specify/templates/tasks-template.md- README.md, quickstart.md
Sync Report Format
<!--
Version: 1.0.0 → 1.1.0
Modified: Old Title → New Title
Added: New Section
Templates: ✅ plan-template.md, ⚠ tasks-template.md
TODOs: TODO(RATIFICATION_DATE): Ask team
-->
Next Steps
After /spec-constitution:
/spec-specify- Create spec using new principles