speckit-constitution

Create and update project constitution files defining governing principles and development guidelines.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/alex-jordan547/agent-setup --skill speckit-constitution-alex-jordan547
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/alex-jordan547/agent-setup/tree/main/archive/speckit-constitution
Command: npx skills add https://github.com/alex-jordan547/agent-setup --skill speckit-constitution-alex-jordan547

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using spec-kit projects need a single source of truth for code quality standards, testing requirements, and architectural constraints, but drafting and maintaining a constitution document with consistent versioning and cross-template alignment is tedious and error-prone. ## Core Features & Use Cases - Template Filling: Replaces placeholder tokens in .specify/memory/constitution.md with concrete values derived from user input or repository context. - Semantic Versioning: Automatically increments the constitution version (MAJOR/MINOR/PATCH) based on the nature of governance changes. - Consistency Propagation: Validates that plan, spec, tasks, and command templates stay aligned with updated principles, and produces a Sync Impact Report. - Use Case: At the start of a new spec-kit project, run this Skill to establish five core principles (e.g., test-first development, documentation requirements) and propagate them across all project templates. ## Quick Start Ask the agent to create or update the project constitution with your desired principles, for example: "Update the project constitution to add a principle requiring integration tests for all API endpoints."

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 at project start after spec-kit setup initializes the .specify directory. The Skill fills the constitution template at .specify/memory/constitution.md with your principles, dates, and version, then validates alignment with other templates.

How does constitution versioning work in spec-kit?

The constitution follows semantic versioning: MAJOR for backward-incompatible principle removals or redefinitions, MINOR for new principles or expanded guidance, and PATCH for clarifications and wording fixes. The Skill proposes a bump type with reasoning when ambiguous.

Does the constitution skill require a spec-kit project structure?

Yes, it requires a .specify directory with memory/constitution.md and the plan, spec, and tasks templates. If the constitution file is missing, it is first copied from .specify/templates/constitution-template.md.

What happens to other templates when the constitution changes?

The Skill reads plan-template.md, spec-template.md, tasks-template.md, and command files to verify alignment with updated principles. It then prepends a Sync Impact Report to the constitution listing updated or pending templates and follow-up TODOs.

What if required constitution information is missing?

When critical values like the ratification date are unknown, the Skill inserts a TODO(<FIELD_NAME>) marker with an explanation and lists it under deferred items in the Sync Impact Report rather than blocking the update.