speckit-constitution

Creates or updates the project constitution file from principle inputs.

Updated Aug 12, 2026
One-click install
npx skills add https://github.com/lluisfont/clickup-reporting --skill speckit-constitution-lluisfont
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/lluisfont/clickup-reporting/tree/main/.agents/skills/speckit-constitution
Command: npx skills add https://github.com/lluisfont/clickup-reporting --skill speckit-constitution-lluisfont

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using Spec Kit need a governed, versioned project constitution that defines non-negotiable principles, but manually filling the template, tracking versions, and keeping dates consistent is error-prone. ## Core Features & Use Cases - Constitution Authoring: Fills the .specify/memory/constitution.md template by replacing placeholder tokens with values from user input or repository context. - Semantic Versioning: Automatically bumps the constitution version (MAJOR/MINOR/PATCH) based on the nature of governance changes 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 & Hooks: Separates governance edits from feature implementation requests and executes optional or mandatory extension hooks before and after the update. - Use Case: A team lead wants to add a new testing principle to their Spec Kit project; the skill updates the constitution, bumps the minor version, and reports the impact. ## Quick Start Ask the assistant to update the project constitution with a new principle requiring all code changes to include tests.

Frequently Asked Questions about speckit-constitution

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

FAQPage Schema
How do I update a Spec Kit project constitution?

Provide your principle inputs or revisions, and the skill loads .specify/memory/constitution.md, replaces all placeholder tokens with concrete values, validates the result, and writes the updated file back with a sync impact report.

How is the constitution version number incremented?

The version follows semantic versioning: MAJOR for backward-incompatible principle removals or redefinitions, MINOR for new principles or expanded guidance, and PATCH for clarifications or wording fixes.

What happens if the constitution file does not exist yet?

If .specify/memory/constitution.md is missing, the template from .specify/templates/constitution-template.md is copied first, then placeholders are filled following the standard update flow.

Can the skill implement feature requests alongside constitution changes?

No. A scope guard classifies non-governance intents such as feature implementation or code generation as deferred items, listing them in a Next Actions section without executing them.

What are extension hooks in the constitution workflow?

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