speckit-constitution

Update Spec-kit constitution files by filling placeholder tokens with governance principles.

Updated Aug 23, 2025

Search Tags:#versioning #constitution #governance #spec-kit #project maintenance #yaml frontmatter #template sync

Ready to run

npx skills add https://github.com/engakhattab/DEPI_Angular_project --skill speckit-constitution-engakhattab

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: speckit-constitution
Source: https://github.com/engakhattab/DEPI_Angular_project/tree/main/Backend/HR/.agents/skills/speckit-constitution
Command: npx skills add https://github.com/engakhattab/DEPI_Angular_project --skill speckit-constitution-engakhattab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures your project constitution is created or updated from your provided principles while keeping all dependent Spec-kit templates in sync, so governance rules don’t drift from the rest of the system.

Core Features & Use Cases

Constitution creation and updates: Initializes or overwrites .specify/memory/constitution.md by filling placeholder tokens with concrete governance and principle content.
Consistency propagation: Validates and synchronizes constitution-driven expectations against Spec-kit templates (plan/spec/tasks/commands) to avoid outdated references.
Versioned governance updates: Increments CONSTITUTION_VERSION using semantic versioning and records amendment impacts in a sync report.

Quick Start

Run the speckit-constitution skill and provide your principle inputs so it updates the constitution and aligns the dependent templates.

Frequently Asked Questions about speckit-constitution

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

FAQPage Schema

How do I keep my project constitution consistent with spec-kit templates?▼

Update the project constitution by replacing placeholder tokens with concrete governance values, which propagates the principles across all dependent spec-kit templates to prevent configuration drift.

What is a project constitution file used for in software governance?▼

A project constitution file defines core governance rules and principles, acting as the central source of truth that establishes behavioral expectations and technical standards for repository maintenance.

How do I update governance principles using YAML frontmatter?▼

Update governance principles by providing new inputs to overwrite the constitution file, which increments the semantic versioning metadata in the YAML frontmatter and records amendment impacts in a validation report.

Can I initialize a missing constitution file from an existing template?▼

Yes, you can initialize a missing constitution file from the existing template, which populates placeholder tokens with user inputs or repo context to generate a complete governance document.

Does spec-kit template sync validate version and placeholder completeness?▼

Yes, template sync validates version numbers, dates, and placeholder completeness, ensuring all constitution-driven expectations are fully populated before synchronizing updates across the repository structure.

What happens when governance rules drift from dependent spec-kit templates?▼

When governance rules drift, the system validates the constitution against dependent templates and generates a sync report, identifying outdated references and applying corrections to realign the structure.