skills.rest
AndyRace
AndyRaceCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

speckit-constitution

Creates and updates the project constitution file in Spec Kit repositories.

Updated Sep 12, 2026
Search Tags:#constitution#semantic versioning#governance#spec-kit#project principles#extension hooks#template resolution
One-click install
npx skills add https://github.com/AndyRace/heart-rate-graph --skill speckit-constitution-andyrace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/AndyRace/heart-rate-graph/tree/main/.github/skills/speckit-constitution
Command: npx skills add https://github.com/AndyRace/heart-rate-graph --skill speckit-constitution-andyrace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintaining a consistent, versioned project constitution is tedious and error-prone when done by hand. This Skill automates drafting, amending, and semantically versioning the governance document at .specify/memory/constitution.md from interactive or provided principle inputs. ## Core Features & Use Cases - Template-Resolved Drafting: Resolves the active constitution template through the Spec Kit preset/template resolution stack and fills every placeholder with concrete values. - Semantic Versioning of Governance: Automatically bumps the constitution version (MAJOR/MINOR/PATCH) based on the nature of principle changes, with a Sync Impact Report for review. - Extension Hook Support: Executes optional and mandatory pre/post hooks declared in .specify/extensions.yml around the constitution update. - Use Case: A team adopting Spec Kit wants to codify five engineering principles. Invoke this Skill with the principles, and it produces a validated, dated, versioned constitution with a suggested commit message. ## Quick Start Update the project constitution to add a principle requiring automated tests for every new feature.

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

Invoke the speckit-constitution skill with your principles as input. It resolves the active constitution template, fills all placeholders, and writes the result to .specify/memory/constitution.md with a version and ratification date.

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 sections, and PATCH for clarifications or wording fixes. The skill proposes a bump type with reasoning before finalizing.

Does speckit-constitution require a specific project structure?▼

Yes, it requires a Spec Kit project with a .specify/ directory, including the scripts/powershell template resolver and the memory folder where constitution.md is written. Without this structure, template resolution fails.

Can I update only one principle without rewriting the whole constitution?▼

Yes, partial updates are supported. The skill loads the existing constitution, preserves applicable content, applies your change, and still runs full validation and version-bump decisions before writing the file back.

What are extension hooks in the constitution workflow?▼

Hooks are commands declared in .specify/extensions.yml under before_constitution or after_constitution keys. Optional hooks are suggested to the user, while mandatory hooks are executed automatically before the workflow continues.

Related Skills

Explore More Software Engineering Skills→
EsriEsri
32

speckit-constitution

Create or update the project constitution from interactive principle inputs.

Official
Advanced
PiklarPiklar

speckit-constitution

Synchronize principle definitions and governance metadata across project documentation templates.

Community
Advanced
heidsoftheidsoft
57

speckit-constitution

Derive and update governance principles from user inputs and repository context.

Community
Advanced
fhltafhlta

speckit-constitution

Create and update spec-kit project constitutions with semantic versioning and template sync.

Community
Advanced