What problem does it solve?
The skill automates updating the project's constitution template, removing manual drift between governance principles and operational templates, and ensuring amendments are tracked, versioned, and propagated consistently.
Core Features & Use Cases
- Placeholder Resolution: Detects all [ALL_CAPS_IDENTIFIER] tokens in the constitution template and replaces them with user-supplied or inferred values from repository context.
- Governance Versioning: Applies semantic versioning rules to determine MAJOR/MINOR/PATCH bumps, sets ISO governance dates, and documents rationale when ambiguous.
- Propagation & Validation: Updates dependent templates and command docs, runs a checklist to validate no unexplained tokens remain, and prepends a Sync Impact Report to the constitution file.
- Auditable Output: Writes the completed constitution to .specify/memory/constitution.md and produces a clear summary and suggested commit message for maintainers.
- Use Case: When governance principles change during a release, run the skill to fill the constitution template, update templates, and create an auditable impact report.
Quick Start
Use the speckit.constitution skill to update .specify/memory/constitution.md by replacing placeholders from repository context, deciding the semantic version bump, and generating a sync impact report.