speckit-constitution

Create or update the project constitution and propagate amendments across spec-kit templates.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-constitution-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-constitution
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-constitution-narenkarthikbm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across spec-kit artifacts is tedious: updating the constitution file alone leaves plan, spec, and tasks templates out of sync. This Skill fills the constitution template with concrete values, versions it semantically, and propagates changes to every dependent template. ## 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 dates. - Consistency Propagation: Validates and updates plan, spec, tasks, and command templates so principle changes stay aligned across the spec-kit project. - Sync Impact Report: Prepends an HTML-comment report listing version changes, modified principles, and templates requiring follow-up. - Extension Hooks: Executes optional or mandatory before/after hooks declared in .specify/extensions.yml. - Use Case: After adopting a new testing principle, run this Skill to amend the constitution to v2.0.0 and automatically flag every template that must reflect the new rule. ## Quick Start Ask the agent to update the project constitution with your new principles and keep all spec-kit templates in sync.

Frequently Asked Questions about speckit-constitution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update the project constitution in spec-kit?

Run the speckit-constitution skill with your principles as input. It loads .specify/memory/constitution.md, replaces placeholder tokens with concrete values, bumps the version semantically, and writes the updated 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 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 updated 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, so a spec-kit project structure with a .specify directory is required.

What are extension hooks in spec-kit constitution updates?

Hooks are commands declared under hooks.before_constitution or hooks.after_constitution in .specify/extensions.yml. Mandatory hooks are executed automatically before or after the update; optional hooks are suggested for manual execution.