speckit-constitution

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

Updated May 22, 2026

Search Tags:#templates #versioning #markdown #constitution #governance #spec-kit #project principles

Ready to run

npx skills add https://github.com/WU-MAO-CHIA/AI_tset_platfrom --skill speckit-constitution-wu-mao-chia

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/WU-MAO-CHIA/AI_tset_platfrom/tree/main/.opencode/skills/speckit-constitution
Command: npx skills add https://github.com/WU-MAO-CHIA/AI_tset_platfrom --skill speckit-constitution-wu-mao-chia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project's governing principles consistent across the constitution file and all dependent spec-kit templates is error-prone manual work; this Skill automates drafting, versioning, and propagation of amendments. ## 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). - Template Synchronization: Validates and updates plan, spec, tasks, and command templates so they stay aligned with amended principles. - Sync Impact Report: Prepends an HTML comment summarizing version changes, modified principles, and pending template updates. - Use Case: After adopting a new testing-discipline principle, run this Skill to amend the constitution, bump the version, and flag every template that references the old governance rules. ## Quick Start Ask the assistant to update the project constitution with your new engineering 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 a project constitution in spec-kit?▼

Provide your principles or values as input, and the Skill fills the placeholder tokens in .specify/memory/constitution.md, bumps the version semantically, and writes the completed file back. It also validates dependent templates for consistency.

How does constitution versioning work in spec-kit?▼

Versioning follows semantic rules: MAJOR for backward-incompatible principle removals, MINOR for new principles or sections, and PATCH for clarifications or wording fixes. If the bump type is ambiguous, the Skill proposes reasoning before finalizing.

What happens if the constitution file does not exist yet?▼

If .specify/memory/constitution.md is missing, the Skill copies it from .specify/templates/constitution-template.md before filling placeholders. It always operates on the existing file rather than creating a new template.

Does the constitution update sync other spec-kit templates?▼

Yes, it reads plan-template.md, spec-template.md, tasks-template.md, and command files to verify alignment with updated principles. A Sync Impact Report lists each template as updated or pending with file paths.

What are extension hooks in the constitution workflow?▼

Hooks are optional or mandatory commands defined in .specify/extensions.yml under before_constitution or after_constitution keys. Enabled hooks without conditions are executed or suggested as slash commands around the constitution update.