skills.rest
whw23
whw23COMMUNITY
Explore all skills by this author →
GitHub

speckit-constitution

Creates and updates project constitution files while syncing dependent spec-kit templates.

Updated May 28, 2026
Search Tags:#constitution#semantic versioning#governance#spec-driven development#spec-kit#template sync#extension hooks
One-click install
npx skills add https://github.com/whw23/PingoGate --skill speckit-constitution-whw23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/whw23/PingoGate/tree/main/.claude/skills/speckit-constitution
Command: npx skills add https://github.com/whw23/PingoGate --skill speckit-constitution-whw23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across a spec-kit project is tedious: the constitution file, plan/spec/tasks templates, and command files all drift out of sync when principles change. This Skill fills the constitution template, versions amendments semantically, and propagates changes across 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) and ISO-format governance dates. - Consistency Propagation: Validates and updates plan, spec, tasks, and command templates so they align with amended principles, then emits a Sync Impact Report. - Extension Hooks: Executes optional or 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; the Skill drafts the constitution, bumps it to v1.0.0, flags templates needing updates, and suggests a commit message. ## Quick Start Ask the assistant to create or update the project constitution with your principles, for example: "Update the project constitution to add a principle requiring observability for all services."

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 placeholder token with concrete values, assigns a semantic version, 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 sections, and PATCH for clarifications or wording 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 files to verify alignment with amended principles, then records each template as updated or pending 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 and always operates on the existing memory file.

What are extension hooks in the constitution workflow?▼

Hooks are commands declared under hooks.before_constitution or hooks.after_constitution in .specify/extensions.yml. Optional hooks are suggested to the user, while mandatory hooks execute automatically before the update proceeds.

Related Skills

Explore More Software Engineering Skills→
auravibes-appsauravibes-apps

speckit-constitution

Updates the project constitution and syncs dependent templates.

Official
Advanced
MicrockMicrock
322

spec-kit-skill

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

Community
Advanced
yareliCamachoyareliCamacho

speckit-constitution

Replace constitution template placeholders with governance rules and synchronize downstream templates.

Community
Advanced
Avila-TekAvila-Tek

documentation-and-adrs

Record architectural decisions and API changes in structured ADR templates.

Official
Intermediate