speckit-constitution

Create and update project constitution files with template propagation and version control.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across spec-kit templates is tedious and error-prone; this Skill fills the constitution template, versions changes semantically, and propagates amendments to dependent artifacts. ## Core Features & Use Cases - Constitution Authoring: Fills placeholder tokens in .specify/memory/constitution.md from user input or repository context, producing declarative, testable principles. - Semantic Versioning: Automatically bumps the constitution version (MAJOR/MINOR/PATCH) based on the nature of governance changes and records ratification and amendment dates. - Sync Impact Report: Validates dependent templates (plan, spec, tasks, command files) and prepends an HTML-comment report listing modified principles and pending updates. - Use Case: After deciding your team requires test-first development and observability as non-negotiable principles, run this Skill to rewrite the constitution, bump it to a new minor version, and flag which spec-kit templates need alignment. ## Quick Start Update the project constitution to add a principle requiring integration tests for all public APIs and propagate the change to dependent templates.

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 every bracketed placeholder with concrete values derived from your input or repository context, and writes the completed file back.

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. The Skill proposes a bump type with reasoning and records dates in ISO YYYY-MM-DD format.

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

Yes. After updating the constitution, the Skill reads plan-template.md, spec-template.md, tasks-template.md, and command files to verify alignment, then prepends a Sync Impact Report listing updated or pending templates.

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 optional or mandatory commands declared in `.specify/extensions.yml` under `before_constitution` or `after_constitution` keys. Mandatory hooks are executed automatically; optional hooks are suggested with their invocation command.