speckit-constitution

Create or update the project constitution from provided principle inputs.

9|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/timcsy/semorphe --skill speckit-constitution-timcsy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/timcsy/semorphe/tree/main/.claude/skills/speckit-constitution
Command: npx skills add https://github.com/timcsy/semorphe --skill speckit-constitution-timcsy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using spec-driven development need a single, versioned governance document that defines project principles, but drafting and maintaining a constitution manually is error-prone and inconsistent. This Skill fills the constitution template at .specify/memory/constitution.md with concrete values, enforces semantic versioning, and keeps governance changes auditable. ## Core Features & Use Cases - Template-Driven Constitution Updates: Loads the existing constitution template, identifies every placeholder token, and replaces it with values derived from user input or repository context. - Semantic Versioning of Governance: Automatically bumps the constitution version using MAJOR/MINOR/PATCH rules and records ratification and amendment dates in ISO format. - Sync Impact Report: Prepends an HTML comment summarizing version changes, modified principles, added or removed sections, and deferred TODOs. - Scope Guard & Extension Hooks: Rejects non-governance requests (deferring them to other Spec Kit commands) and executes optional or mandatory pre/post hooks defined in .specify/extensions.yml. - Use Case: A team adopting Spec Kit runs the constitution command with principles like "code review required" and "test coverage mandatory" to produce a ratified, versioned governance document that all later spec, plan, and task commands reference. ## Quick Start Ask the assistant to create or update the project constitution with your chosen principles, for example by requesting a constitution with three principles covering code quality, testing, and documentation.

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 and provide your principles as input, or let it infer values from repository context. It fills the template at .specify/memory/constitution.md, assigns a semantic version, and writes a sync impact report.

How does constitution versioning work in Spec Kit?▼

The constitution uses semantic versioning: MAJOR for backward-incompatible principle removals or redefinitions, MINOR for new principles or sections, and PATCH for clarifications or wording fixes. The version bump is decided during each update.

What happens if the constitution file is missing?▼

If .specify/memory/constitution.md does not exist, the template is copied from .specify/templates/constitution-template.md first, then placeholders are filled. This requires the Spec Kit project structure to be initialized.

Can the constitution command also implement features or write code?▼

No. A scope guard restricts it to governance content only. Feature implementation, code generation, or deployment requests are extracted as deferred intents and listed under Next Actions with a suggested follow-up command like /speckit-specify.

What are extension hooks in the constitution workflow?▼

Hooks are commands defined under hooks.before_constitution or hooks.after_constitution in .specify/extensions.yml. Optional hooks are suggested to the user, while mandatory hooks are executed automatically before the workflow continues.