speckit-constitution

Creates or updates the project constitution from principle inputs using Spec Kit templates.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/MagnoAlves1993/handy --skill speckit-constitution-magnoalves1993
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/MagnoAlves1993/handy/tree/main/.github/skills/speckit-constitution
Command: npx skills add https://github.com/MagnoAlves1993/handy --skill speckit-constitution-magnoalves1993

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining consistent project governance principles is difficult when teams lack a structured, versioned constitution. This Skill automates creating and amending the .specify/memory/constitution.md file with semantic versioning, placeholder resolution, and validation. ## Core Features & Use Cases - Constitution Authoring: Resolves the active constitution template through the Spec Kit preset stack and fills placeholders from user input or repository context. - Semantic Versioning: Automatically bumps the constitution version (MAJOR/MINOR/PATCH) based on the nature of governance changes. - Sync Impact Report: Generates an HTML-comment report summarizing version changes, modified principles, and deferred TODOs. - Use Case: A team adopting Spec-Driven Development needs to ratify five core engineering principles; invoke this Skill to draft, validate, and write the constitution with proper dates and governance sections. ## Quick Start Ask the assistant to create or update the project constitution with your desired principles, for example by requesting a constitution with principles for 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?

Invoke the speckit-constitution command with your desired principles as input. It resolves the constitution template, fills placeholders from your input or repository context, and writes the result 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 rationale when the type is ambiguous.

What is the Sync Impact Report in a constitution update?

The Sync Impact Report is an HTML comment placed at the top of the constitution file after an update. It lists the version change, modified principles, added or removed sections, and deferred TODOs, and is meant to be removed before committing.

Can the constitution command modify application source code?

No. The Skill has a scope guard that forbids creating, modifying, or deleting application source files, tests, or deployment artifacts. Non-governance requests are extracted as deferred intents with suggested follow-up commands.

What happens if the constitution template resolution fails?

The Skill stops and reports the resolution error rather than continuing with a partial template layer. Template resolution through the Spec Kit preset stack must succeed before any constitution content is drafted.