speckit-constitution

Create and update project constitutions while syncing dependent spec-kit templates.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/zhangliuliuzhang/memcached-rvv-v2 --skill speckit-constitution-zhangliuliuzhang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/zhangliuliuzhang/memcached-rvv-v2/tree/main/.claude/skills/speckit-constitution
Command: npx skills add https://github.com/zhangliuliuzhang/memcached-rvv-v2 --skill speckit-constitution-zhangliuliuzhang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a project constitution manually leads to stale governance documents and inconsistent templates across a spec-kit project. This Skill fills the constitution template with concrete principles, applies semantic versioning, and propagates changes to all dependent artifacts. ## Core Features & Use Cases - Constitution Authoring: Fills placeholder tokens in .specify/memory/constitution.md from user input or repository context, with semantic version bumping (MAJOR/MINOR/PATCH). - Template Synchronization: Validates and updates plan, spec, tasks, and command templates so they stay aligned with amended principles. - Sync Impact Report: Prepends an HTML comment report listing version changes, modified principles, and pending template updates. - Extension Hooks: Executes optional or mandatory before/after hooks defined in .specify/extensions.yml. - Use Case: A team adopting spec-kit wants to codify five engineering principles; the Skill drafts the constitution, bumps it to v1.0.0, and flags which templates need follow-up edits. ## Quick Start Ask the assistant to create or update the project constitution with your principles, for example: "Update the constitution with principles for test-driven development and API versioning."

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 all bracketed placeholder tokens with concrete values, assigns a semantic version, and writes the completed document back.

How does constitution versioning work in spec-kit?

Versioning follows semantic rules: MAJOR for backward-incompatible principle removals, MINOR for new principles or sections, and PATCH for clarifications or typo fixes. The Skill proposes a bump rationale when the 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 listed under `hooks.before_constitution` or `hooks.after_constitution` in `.specify/extensions.yml`. Mandatory hooks execute automatically before proceeding, while optional hooks are suggested for manual invocation.