speckit-constitution

Creates or updates the project constitution file from resolved Spec Kit templates and user inputs.

1|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill speckit-constitution-igorganapolsky
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/IgorGanapolsky/Random-Timer/tree/main/.cursor/skills/speckit-constitution
Command: npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill speckit-constitution-igorganapolsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a consistent, versioned project constitution in a Spec Kit workflow requires manual template resolution, placeholder replacement, semantic version bumps, and governance validation, which is error-prone when done by hand. ## Core Features & Use Cases - Template Resolution: Runs the Spec Kit template resolver to compose the active constitution scaffold from project overrides, preset layers, and core fallbacks. - Semantic Versioning: Automatically increments the constitution version (MAJOR/MINOR/PATCH) based on the nature of governance changes and records ratification and amendment dates. - Sync Impact Report: Generates an HTML-comment report summarizing version changes, modified principles, added or removed sections, and deferred TODOs. - Extension Hooks: Executes optional and mandatory pre/post hooks declared in .specify/extensions.yml around the constitution update. - Use Case: A team adopting Spec Kit wants to codify engineering principles; invoke this Skill with the desired principles and it writes a validated, versioned constitution to .specify/memory/constitution.md. ## Quick Start Ask the agent to update the project constitution with your principles, for example: create a constitution with five principles covering code quality, 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 speckit-constitution command with your desired principles as input. It resolves the active constitution template, fills placeholders, validates the result, and writes the file to .specify/memory/constitution.md.

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 wording fixes. The Skill proposes a bump type with reasoning before finalizing.

Does speckit-constitution require a specific project structure?▼

Yes, it requires a Spec Kit project with a .specify/ directory containing scripts like resolve-template.sh and the memory folder. Without this structure, template resolution fails and the update stops.

What happens if template resolution fails during a constitution update?▼

The Skill stops and reports the resolution error instead of continuing with a partial template layer. It never writes back to versioned template source files, only to .specify/memory/constitution.md.

Can I update only one principle without rewriting the whole constitution?▼

Yes, partial updates are supported. The Skill still performs full validation, version decision, and date handling, preserving existing applicable content while applying your changes.