skills.rest
speeddesigns
speeddesignsCOMMUNITY
Explore all skills by this author →
GitHub

speckit-constitution

Create or update the project constitution from interactive or provided principle inputs.

Updated Aug 2, 2026
Search Tags:#workflow#template#versioning#constitution#governance#spec-kit#project principles
One-click install
npx skills add https://github.com/speeddesigns/cvusd-calendars --skill speckit-constitution-speeddesigns
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/speeddesigns/cvusd-calendars/tree/main/.agents/skills/speckit-constitution
Command: npx skills add https://github.com/speeddesigns/cvusd-calendars --skill speckit-constitution-speeddesigns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governance constitution consistent, versioned, and free of placeholder tokens is tedious and error-prone when done manually. This Skill automates filling the constitution template at .specify/memory/constitution.md with concrete principles, dates, and semantic version bumps. ## 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 increments the constitution version using MAJOR/MINOR/PATCH rules and records ratification and amendment dates. - 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 edits from feature requests, defers non-governance intents, and runs optional or mandatory pre/post hooks from .specify/extensions.yml. - Use Case: A team adopting spec-kit wants to ratify five engineering principles; the Skill fills the template, bumps the version to 1.0.0, validates dates, and suggests a commit message. ## Quick Start Ask the agent to update the project constitution with your principles, for example: create a constitution with principles for code quality, testing, and documentation.

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, and the Skill fills the template at .specify/memory/constitution.md. It derives missing values from repository context, assigns dates, and validates that no unexplained placeholder tokens remain.

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 the change in a Sync Impact Report.

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 and always operates on the existing constitution file.

Can I update only one principle without rewriting everything?▼

Yes, partial updates are supported. The Skill still performs full validation and version decision steps, updates only the affected sections, and records the change in the Sync Impact Report with the appropriate version bump.

What are extension hooks in the constitution workflow?▼

Hooks are commands defined in .specify/extensions.yml under before_constitution or after_constitution keys. Mandatory hooks execute automatically around the update, while optional hooks are suggested with their command and description for manual invocation.

What are the limitations of the constitution command?▼

The command only modifies the constitution file and refuses feature implementation, code generation, or deployment requests. Non-governance intents are extracted as deferred items in a Next Actions section instead of being executed.

Related Skills

Explore More Software Engineering Skills→
lightspeedwplightspeedwp

speckit-constitution

Creates or updates the project constitution file from provided governance principles.

Official
Advanced
MicrockMicrock
322

spec-kit-skill

Generate structured feature specifications across seven constitution-driven development phases.

Community
Advanced
180VRisLife180VRisLife

spec-constitution

Create and amend versioned project governance constitutions with semantic versioning.

Community
Advanced
chaimtchaimt

architect-specify

Transform PRDs into MADR-compliant Architecture Decision Records through guided exploration.

Community
Advanced