speckit-constitution

Create or update the project constitution from interactive or provided principle inputs.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/thechibbis/mythicreviewer --skill speckit-constitution-thechibbis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/thechibbis/mythicreviewer/tree/main/.agents/skills/speckit-constitution
Command: npx skills add https://github.com/thechibbis/mythicreviewer --skill speckit-constitution-thechibbis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using spec-driven development need a single, versioned governance document that defines non-negotiable 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 Placeholder Resolution: Detects every [ALL_CAPS] placeholder in the constitution template and fills it from user input or repository context. - Semantic Versioning of Governance: Automatically bumps 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 as deferred intents and executes before/after hooks declared in .specify/extensions.yml. - Use Case: A team lead says "add a principle requiring all APIs to be versioned" and the Skill updates the constitution, bumps the minor version, and reports the change. ## Quick Start Ask the agent to update the project constitution with your principles, for example: "Update the constitution to add a principle that all code changes require peer review."

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 speckit-constitution command and provide your principles as input. The Skill loads .specify/memory/constitution.md, replaces every bracketed placeholder with concrete values, and writes the completed constitution back with a version bump.

How does constitution versioning work in spec-kit?

The constitution uses semantic versioning: MAJOR for backward-incompatible principle removals, MINOR for new principles or sections, and PATCH for clarifications or typo fixes. The Skill proposes the bump type with reasoning before finalizing.

What happens if the constitution file does not exist yet?

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

Can the constitution command also implement features or write code?

No. A scope guard classifies all input, and any feature implementation, refactoring, or deployment requests are extracted as deferred intents. They are listed in a Next Actions section with a suggested follow-up command instead of being executed.

What are extension hooks in the constitution workflow?

Hooks are commands declared under hooks.before_constitution or hooks.after_constitution in .specify/extensions.yml. Mandatory hooks are executed automatically before or after the update, while optional hooks are only suggested to the user.