speckit-constitution

Creates or updates the project constitution from interactive or provided principle inputs.

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

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: Identifies every [ALL_CAPS] token in the constitution template and fills it from user input or repository context. - Semantic Versioning of Governance: Automatically bumps the 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 and Extension Hooks: Separates governance content from feature-implementation requests and executes optional or mandatory hooks defined in .specify/extensions.yml before and after the update. - Use Case: A team lead says "add a principle requiring all API changes to be backward compatible" and the Skill amends the constitution, bumps the minor version, and reports the change without touching application code. ## Quick Start Ask the agent to update the project constitution with your principle, for example: "Update the constitution to add a principle that all database migrations must be reversible."

Frequently Asked Questions about speckit-constitution

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

FAQPage Schema
How do I update a project constitution in a spec-kit project?

Invoke the constitution command with your principle text as input. The Skill loads .specify/memory/constitution.md, fills placeholder tokens with your values or inferred context, validates the result, 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 expanded guidance, and PATCH for clarifications and wording 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 the template from .specify/templates/constitution-template.md first, then proceeds with placeholder collection and filling as usual.

Can the constitution command also implement features or change code?

No. A scope guard classifies all input as either governance content or deferred non-governance intent. Feature implementation, refactoring, or deployment requests are extracted into a Next Actions section and never executed by this Skill.

What are extension hooks in the constitution workflow?

Hooks are commands listed 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 constitution update proceeds.