speckit-constitution

Create or update the project constitution and sync dependent spec-kit templates.

1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/trungenglish/SHOPWISE --skill speckit-constitution-trungenglish
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/trungenglish/SHOPWISE/tree/main/.cursor/skills/speckit-constitution
Command: npx skills add https://github.com/trungenglish/SHOPWISE --skill speckit-constitution-trungenglish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across spec-kit templates is error-prone when done manually. This Skill fills the constitution template at .specify/memory/constitution.md with concrete values and propagates amendments to dependent plan, spec, and task templates. ## Core Features & Use Cases - Constitution Authoring: Replaces placeholder tokens in the constitution template with values derived from user input or repository context, applying semantic versioning rules for MAJOR, MINOR, and PATCH bumps. - Consistency Propagation: Validates and updates plan-template.md, spec-template.md, tasks-template.md, and command templates so they align with amended principles. - Sync Impact Report: Prepends an HTML comment summarizing version changes, modified principles, and templates requiring follow-up. - Extension Hooks: Executes optional or mandatory before/after hooks declared in .specify/extensions.yml. - Use Case: A team adopting spec-driven development runs this Skill to ratify their first constitution, then re-runs it when adding a new testing principle so all workflow templates stay aligned. ## Quick Start Ask the assistant to create or update the project constitution with your principles, for example: update the constitution to add a principle requiring integration tests for every public API.

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?▼

Run the constitution command with your principles as input. The Skill loads .specify/memory/constitution.md, replaces bracketed placeholder tokens with your values or values inferred from the repository, and writes the completed file back.

How does constitution versioning work in spec-kit?▼

Versioning follows semantic rules: MAJOR for backward-incompatible principle removals or redefinitions, MINOR for new principles or expanded guidance, and PATCH for clarifications or typo fixes. The Skill proposes reasoning when the bump type is ambiguous.

Does updating the constitution sync other spec-kit templates?▼

Yes. The Skill reads plan-template.md, spec-template.md, tasks-template.md, and command templates to verify alignment with amended principles, then records their status in a Sync Impact Report prepended to the constitution.

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 filling placeholders. It never creates a new template from scratch.

What are extension hooks in the constitution workflow?▼

Hooks are commands declared under hooks.before_constitution or hooks.after_constitution in .specify/extensions.yml. Mandatory hooks execute automatically before proceeding, while optional hooks are presented for manual invocation.