speckit-constitution

Create or update the project constitution and sync dependent spec-kit templates.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/Carl-Fabri/TestAngularSpecDriven --skill speckit-constitution-carl-fabri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/Carl-Fabri/TestAngularSpecDriven/tree/main/test-angular/.claude/skills/speckit-constitution
Command: npx skills add https://github.com/Carl-Fabri/TestAngularSpecDriven --skill speckit-constitution-carl-fabri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across spec-kit artifacts is error-prone when done manually. This Skill fills the constitution template at .specify/memory/constitution.md with concrete values and propagates amendments to dependent templates. ## Core Features & Use Cases - Constitution Authoring: Replaces placeholder tokens in the constitution template with values from user input or repository context, applying semantic versioning rules for amendments. - Template Synchronization: Validates and updates plan, spec, tasks, and command templates so they stay aligned with changed principles. - Sync Impact Report: Prepends an HTML comment report listing version changes, modified principles, and templates requiring follow-up. - Use Case: A team adopting spec-kit defines five core engineering principles; the Skill drafts the constitution, bumps the version, and flags which templates need updates. ## Quick Start Update the project constitution with principles focused on code quality, testing discipline, and observability.

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?

Invoke the constitution command with your principles as input. The Skill fills placeholder tokens in .specify/memory/constitution.md, deriving missing values from repository context like the README, and writes the completed file back.

How does constitution versioning work in spec-kit?

Versioning follows semantic rules: MAJOR for backward-incompatible principle removals, MINOR for new principles or sections, and PATCH for clarifications. If the bump type is ambiguous, the Skill proposes reasoning before finalizing.

Does the constitution update sync other spec-kit templates?

Yes. The Skill reads plan-template.md, spec-template.md, tasks-template.md, and command templates to verify alignment with updated principles, then records their status in a Sync Impact Report prepended to the constitution.

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 before filling placeholders. It never creates a new template from scratch.

What are extension hooks in the constitution workflow?

Hooks are optional or mandatory commands defined in .specify/extensions.yml under before_constitution or after_constitution keys. Mandatory hooks are executed and awaited; optional hooks are suggested for manual invocation.