speckit-constitution

Create or update the project constitution from provided principle inputs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using Spec Kit need a governed project constitution that defines non-negotiable principles, but drafting and versioning it consistently is error-prone. This Skill fills the constitution template at .specify/memory/constitution.md with concrete values, enforces semantic versioning, and produces a sync impact report. ## Core Features & Use Cases - Template-Driven Constitution Updates: Loads the existing constitution template, identifies all placeholder tokens, and replaces them with values derived from user input or repository context. - Semantic Versioning & Sync Impact Report: Automatically bumps the constitution version (MAJOR/MINOR/PATCH) and prepends an HTML comment report listing modified principles, added or removed sections, and deferred TODOs. - Extension Hook Support: Executes optional or mandatory pre- and post-hooks defined in .specify/extensions.yml before and after the constitution update. - Use Case: A team lead wants to add a new testing principle to their Spec Kit project. They invoke the Skill with the principle text, and it updates the constitution, bumps the minor version, and suggests a commit message. ## Quick Start Ask the assistant to update the project constitution with your principles, for example: "Update the project constitution to add a principle requiring integration tests for all public APIs."

Frequently Asked Questions about speckit-constitution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the project constitution in Spec Kit?

Invoke the speckit-constitution command with your principle inputs as arguments. The Skill loads .specify/memory/constitution.md, replaces placeholder tokens with your values, bumps the version semantically, and writes the updated file back.

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

What happens if the constitution file is missing?

If .specify/memory/constitution.md does not exist, the Skill copies it from .specify/templates/constitution-template.md before proceeding. It always operates on the existing file rather than creating a new template.

Can I run hooks before or after a constitution update?

Yes, if .specify/extensions.yml exists, hooks under hooks.before_constitution and hooks.after_constitution are evaluated. Mandatory hooks execute automatically, while optional hooks are suggested with their command and description.

What are the limitations of the constitution command?

The command only modifies the constitution file itself and refuses to execute feature implementation, code generation, or deployment requests. Such non-governance intents are deferred and listed in a Next Actions section with suggested follow-up commands.