speckit-constitution

Create or update the project constitution from provided governance principles.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using Spec Kit need a single, versioned governance document that defines non-negotiable project principles, but drafting and maintaining a constitution with consistent versioning, placeholder resolution, and amendment tracking is error-prone manual work. ## Core Features & Use Cases - Constitution Authoring: Resolves the active constitution template through the Spec Kit preset/template stack and fills every placeholder from user input or repository context. - Semantic Versioning of Governance: Automatically increments the constitution version using MAJOR/MINOR/PATCH rules and records ratification and amendment dates in ISO format. - Sync Impact Reporting: Prepends an HTML comment report listing version changes, modified principles, added or removed sections, and deferred TODOs. - Scope Guard & Extension Hooks: Separates governance content from unrelated implementation requests and executes optional or mandatory pre/post hooks declared in .specify/extensions.yml. - Use Case: A tech lead wants to codify five engineering principles for a new project; the Skill drafts .specify/memory/constitution.md, bumps the version, and reports what changed. ## Quick Start Ask the agent to create or update the project constitution with your principles, for example: "Update the constitution with principles for code review, testing, and security."

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, and it resolves the active template, fills placeholders from your input or repository context, and writes the result to .specify/memory/constitution.md with a version bump and 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 expanded guidance, and PATCH for clarifications or wording fixes. The version line must match the sync impact report.

Does the constitution command require a .specify directory?▼

Yes, it requires a Spec Kit project structure with a .specify/ directory, since it runs .specify/scripts/powershell/resolve-template.ps1 and writes to .specify/memory/constitution.md. Without that structure, template resolution fails.

What happens if I include feature requests in constitution input?▼

The scope guard classifies non-governance input as deferred intents and does not execute them. After the constitution update, it lists each deferred intent in a Next Actions section with a suggested follow-up command such as /speckit-specify.

What are extension hooks in the constitution workflow?▼

Hooks are commands declared 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.