What is a project constitution in Claude Code?

A project constitution is a set of foundational principles and rules that guide how an AI agent or developer should behave, write code, and make decisions within a specific codebase.

What anti-patterns does this skill detect?

It identifies issues such as 'placeholder syndrome' (using generic terms instead of real tools), missing rationale for rules, and the definition of untestable requirements.

How does it handle versioning for principles?

It provides clear triggers for semantic versioning: MAJOR for removing principles or incompatible redefinitions, MINOR for adding new principles, and PATCH for clarifications or formatting.

How does this skill improve project documentation?

It replaces vague language like 'clean code' with quantifiable metrics such as 'zero lint warnings,' making guidelines objectively testable and easier for AI to follow.

When should I run the validation-constitution skill?

You should run it after drafting a new constitution using authoring tools, during a quality audit, or whenever you need to determine the impact of a change on your project's versioning.

Constitution Validator

Name: Constitution Validator
Author: deepeshBodh

bydeepeshBodh

•

学習とドキュメンテーション

Validates project constitutions through automated quality checklists, anti-pattern detection, and semantic versioning enforcement.

概要

The validation-constitution skill ensures that your project's guiding principles—often referred to as 'constitutions'—are measurable, actionable, and maintainable. It bridges the gap between vague architectural goals and concrete enforcement by replacing ambiguous language with quantifiable metrics, detecting common governance anti-patterns, and providing a rigorous framework for versioning. This skill is essential for teams using SPEC-first development to maintain a high-quality source of truth for their AI agents and developers alike.

主な機能

Validation of the three-part rule structure: Enforcement, Testability, and Rationale
Quantification engine to transform vague goals into measurable criteria
7 GitHub stars
Anti-pattern detection to identify untestable rules and placeholder syndrome
Semantic versioning guidance for Major, Minor, and Patch updates
Automated quality checklists for principle integrity and testability

ユースケース

Auditing a newly authored constitution for measurable performance metrics before finalization
Determining the appropriate version bump after modifying core development principles
Reviewing existing project guidelines to identify and fix common architectural anti-patterns

概要

主な機能

Validation of the three-part rule structure: Enforcement, Testability, and Rationale
Quantification engine to transform vague goals into measurable criteria
7 GitHub stars
Anti-pattern detection to identify untestable rules and placeholder syndrome
Semantic versioning guidance for Major, Minor, and Patch updates
Automated quality checklists for principle integrity and testability

ユースケース

Auditing a newly authored constitution for measurable performance metrics before finalization
Determining the appropriate version bump after modifying core development principles
Reviewing existing project guidelines to identify and fix common architectural anti-patterns