speckit-constitution

Update Speckit constitution placeholders and propagate changes to dependent templates.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures your Speckit project constitution stays accurate when principles change, and that any dependent templates remain in sync.

Core Features & Use Cases

  • Interactive or provided principle input: Use conversation-provided updates (if any) to amend governance and principles.
  • Template-driven constitution updates: Fills placeholders in .specify/memory/constitution.md with concrete values (no leftover tokens).
  • Hook-aware execution: Runs configured pre/post extension hooks from .specify/extensions.yml when enabled, without evaluating hook conditions itself.
  • Consistency propagation: Checks alignment with plan/spec/task templates and command templates, updating references as required.
  • Sync Impact reporting: Writes an HTML comment report (version change, modified principles, and template update status) into the constitution file.

Quick Start

Use the speckit-constitution skill to update the constitution in .specify/memory/constitution.md from your provided principles and ensure all related templates are synchronized.

Frequently Asked Questions about speckit-constitution

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

FAQPage Schema
How do I update project constitution placeholders with concrete governance values?▼

To update project constitution placeholders, the skill replaces tokens in .specify/memory/constitution.md with concrete principle and governance values supplied interactively. It ensures no leftover tokens remain while applying governance versioning and date management validations.

How does template sync work when Speckit principles change?▼

Template sync propagates principle changes by checking alignment with dependent plan, spec, task, and command templates. It updates references automatically across all related templates to ensure consistency whenever the constitution is amended.

Can I use YAML hooks for documentation automation during constitution updates?▼

Yes, hook-aware execution runs configured pre and post extension hooks from .specify/extensions.yml when enabled. The skill respects hook execution paths without evaluating hook conditions itself, ensuring documentation automation integrates with existing workflows.

What is a sync impact report in project scaffolding governance?▼

A sync impact report is an HTML comment written into the constitution file that details version changes, modified principles, and template update status. It provides a transparent audit trail of all modifications made during the governance versioning process.

Do I need existing plan and spec templates to use constitution governance versioning?▼

Yes, consistency propagation checks alignment with existing plan, spec, and task templates alongside command templates. The skill updates references within these dependent files, requiring them to be present to execute full synchronization.

Why does my constitution update leave leftover placeholder tokens?▼

Leftover placeholder tokens occur when principle inputs are incomplete. The skill validates required inputs and fills placeholders in .specify/memory/constitution.md with concrete values, ensuring no tokens remain if the supplied governance values are valid.