speckit-constitution

Create and update project constitution files while syncing dependent spec-kit templates.

Updated Jul 13, 2026
One-click install
npx skills add https://github.com/torikhayes/aeai-dotnet-brownfield --skill speckit-constitution-torikhayes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/torikhayes/aeai-dotnet-brownfield/tree/main/.claude/skills/speckit-constitution
Command: npx skills add https://github.com/torikhayes/aeai-dotnet-brownfield --skill speckit-constitution-torikhayes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across a spec-kit project is tedious: the constitution file, plan templates, spec templates, and task templates all drift out of sync when principles change. This Skill fills the constitution template with concrete values and propagates amendments across all dependent artifacts. ## Core Features & Use Cases - Constitution Authoring: Fills placeholder tokens in .specify/memory/constitution.md from user input or repository context, with semantic version bumping (MAJOR/MINOR/PATCH) based on the nature of changes. - Consistency Propagation: Validates and updates plan, spec, tasks, and command templates so they align with new or removed principles. - Sync Impact Report: Prepends an HTML comment summarizing version changes, modified principles, and templates requiring follow-up. - Extension Hooks: Executes optional or mandatory pre/post hooks declared in .specify/extensions.yml. - Use Case: A team adopting spec-kit wants to codify five engineering principles (e.g., test discipline, observability) and have every downstream template reflect them automatically. ## Quick Start Ask the assistant to create or update the project constitution with your principles, for example: "Update the project constitution to add an observability principle and bump the version."

Frequently Asked Questions about speckit-constitution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a project constitution with spec-kit?▼

Run the constitution command with your principles as input. The Skill loads `.specify/memory/constitution.md`, replaces every placeholder token with concrete values, and writes the completed file back with a version bump and sync impact report.

How does constitution versioning work in spec-kit?▼

Versioning follows semantic rules: MAJOR for backward-incompatible principle removals or redefinitions, MINOR for new principles or expanded guidance, and PATCH for clarifications or typo fixes. The Skill proposes reasoning when the bump type is ambiguous.

Does the constitution update sync other spec-kit templates?▼

Yes. After updating the constitution, the Skill reads plan-template.md, spec-template.md, tasks-template.md, and command templates to verify alignment with changed principles, flagging each as updated or pending in the Sync Impact Report.

What happens if the constitution file is missing?▼

If `.specify/memory/constitution.md` does not exist, the Skill copies it from `.specify/templates/constitution-template.md` first, then proceeds with placeholder collection and filling as usual.

What are extension hooks in the constitution workflow?▼

Hooks are commands declared in `.specify/extensions.yml` under `hooks.before_constitution` or `hooks.after_constitution`. Mandatory hooks execute automatically, optional hooks are suggested, and hooks with non-empty conditions are skipped for the HookExecutor to evaluate.