speckit-constitution

Create or update the project constitution from interactive principle inputs.

32|9|Updated Feb 2, 2024
One-click install
npx skills add https://github.com/Esri/arcgis-gitops --skill speckit-constitution-esri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/Esri/arcgis-gitops/tree/main/.github/skills/speckit-constitution
Command: npx skills add https://github.com/Esri/arcgis-gitops --skill speckit-constitution-esri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using Spec Kit need a governed, versioned project constitution that defines non-negotiable principles, but drafting and amending it consistently across template layers is error-prone. This Skill automates constitution creation and amendment with semantic versioning, placeholder resolution, and validation. ## Core Features & Use Cases - Constitution Authoring: Resolves the active constitution template through the Spec Kit preset/template stack and fills every placeholder from user input or repository context. - Semantic Versioning & Sync Impact Report: Automatically bumps MAJOR/MINOR/PATCH versions based on the nature of governance changes and generates a review report of modified principles. - Extension Hooks: Executes pre- and post-constitution hooks declared in .specify/extensions.yml, supporting both optional and mandatory hook flows. - Use Case: A team adopting Spec Kit runs the constitution command to codify five engineering principles, producing a ratified .specify/memory/constitution.md with version 1.0.0 and a suggested 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 automated tests for all new features."

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 speckit-constitution command with your principle inputs. It resolves the constitution template, fills placeholders from your input or repository context, and writes the result to .specify/memory/constitution.md with a version number and ratification date.

How does constitution versioning work in Spec Kit?

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

Does speckit-constitution require a specific project structure?

Yes, it requires a Spec Kit project with a .specify/ directory, including .specify/scripts/powershell/resolve-template.ps1 for template resolution. The constitution itself is written to .specify/memory/constitution.md.

What are extension hooks in the constitution workflow?

Hooks are commands registered in .specify/extensions.yml under hooks.before_constitution or hooks.after_constitution. Optional hooks are suggested to the user, while mandatory hooks (optional: false) are executed automatically before the workflow continues.

Can the constitution command modify application source code?

No, a scope guard restricts it to updating only .specify/memory/constitution.md. Feature implementation, code generation, or deployment requests in the input are extracted as deferred intents and listed under Next Actions instead of being executed.