What is an engineering constitution?

An engineering constitution is a living document that defines your team's architectural patterns, coding standards, and project principles used to guide both human developers and AI agents.

Does it support versioning for rules?

Yes, it implements a Semantic Versioning framework (Major.Minor.Patch) to categorize the impact of rule changes, from breaking architectural shifts to minor clarifications.

How does this sync with AI agents?

The skill includes commands to update agent-specific instruction files (such as CLAUDE.md) directly from the central constitution, ensuring the AI always follows the latest project rules.

What kind of validation does it perform?

It checks for structural integrity, identifies 'weak language' (like 'ideally' or 'should try to'), enforces RFC 2119 keywords, and validates that requirements match the reality of the codebase.

Constitution Governance

Name: Constitution Governance
Author: sirkirby

bysirkirby

•

生产力与工作流

Standardizes and automates the maintenance, amendment, and validation of engineering constitutions and agent instruction files.

The Constitution Governance skill provides a comprehensive framework for engineering teams to manage their project standards and architectural rules through a centralized 'constitution.' It automates the lifecycle of these living documents using semantic versioning, validation rubrics, and reality alignment checks that compare documentation against actual codebase evidence. By synchronizing these standards directly with agent instruction files like CLAUDE.md, it ensures that AI assistants remain perfectly aligned with current team practices, preventing rule drift and maintaining high-quality, compliant code output.

主要功能

01Automated validation of constitution structure, language, and metadata

02Synchronization of governance rules with AI agent instruction files

03Reality alignment checks to verify documentation against codebase state

04Semantic versioning for documentation amendments (Major, Minor, Patch)

0544 GitHub stars

06Quality rubric scoring for clarity, enforceability, and operational readiness

使用场景

01Formalizing and version-controlling team coding standards and architectural patterns

02Auditing project documentation for weak language or missing RFC 2119 keywords

03Keeping AI assistant instructions in sync with evolving project requirements

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