What does reality validation mean?

Reality validation is a process where the skill checks your documented requirements (like test coverage or CI/CD usage) against the actual state of the codebase to identify gaps.

What is an engineering constitution in this context?

An engineering constitution is a living document that outlines a project's core principles, architectural standards, and coding requirements to ensure team consistency.

How does this skill help with AI agent alignment?

It automatically synchronizes the rules defined in your constitution with agent-specific files like CLAUDE.md, ensuring AI assistants follow your latest project standards.

Why use semantic versioning for documentation?

Semantic versioning helps teams understand the impact of changes: Major versions for breaking rule changes, Minor for new additions, and Patch for simple clarifications.

Constitution Governance

Name: Constitution Governance
Author: sirkirby

bysirkirby

•

Collaboration Tools

Manages engineering constitutions through automated amendment workflows, semantic versioning, and AI agent instruction synchronization.

The Constitution Governance skill provides a comprehensive framework for maintaining and evolving project-specific engineering constitutions. It facilitates a structured amendment process using semantic versioning, ensuring that coding standards, architectural principles, and testing requirements remain up-to-date. By providing a validation rubric and synchronization tools, it bridges the gap between high-level documentation and project reality, automatically updating agent instruction files like CLAUDE.md to ensure AI assistance remains perfectly aligned with the team's latest standards.

Key Features

01Automated amendment workflows with semantic versioning (Major, Minor, Patch)

02Quality rubric scoring to evaluate clarity and enforceability

03Comprehensive change log maintenance and compliance monitoring

0444 GitHub stars

05Agent instruction synchronization for tools like CLAUDE.md

06Structural and reality-alignment validation for project requirements

Use Cases

01Standardizing architectural patterns and coding practices across a distributed engineering team

02Aligning AI agent behavior with evolving project requirements and documentation

03Auditing codebase reality against documented standards to identify technical debt

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sirkirby/unifi-network-rules constitution-governance

For use in Claude.ai and ChatGPT

Download Skill