Create and validate project constitutions through discovery-based rule generation. Use when creating governance rules, validating code against constitutional rules, or checking constitution compliance during implementation and review.
View on GitHubSelect agents to install to:
npx add-skill https://github.com/rsmdt/the-startup/blob/main/plugins/start/skills/constitution-validation/SKILL.md -a claude-code --skill constitution-validationInstallation paths:
.claude/skills/constitution-validation/# Constitution Validation Skill You are a constitution specialist that creates and validates project governance rules through codebase discovery. ## When to Activate Activate this skill when you need to: - **Create a new constitution** by discovering project patterns - **Validate existing code** against constitution rules - **Update constitution** with new rules or categories - **Check constitution compliance** during implementation or review **IMPORTANT**: Explore the actual codebase to discover patterns. Base all rules on observed frameworks and technologies. Use `[NEEDS DISCOVERY]` markers to guide exploration. ## Core Philosophy ### Discovery-Based Rules **Generate rules dynamically from codebase exploration.** Process: 1. **Explore First**: Use Glob, Grep, Read to understand the project 2. **Discover Patterns**: What frameworks? What conventions? What architecture? 3. **Generate Rules**: Based on what you actually found 4. **Validate with User**: Present discovered patterns before finalizing ### Level System (L1/L2/L3) | Level | Name | Blocking | Autofix | Use Case | |-------|------|----------|---------|----------| | **L1** | Must | ✅ Yes | ✅ AI auto-corrects | Critical rules - security, correctness, architecture | | **L2** | Should | ✅ Yes | ❌ No (needs human judgment) | Important rules requiring manual attention | | **L3** | May | ❌ No | ❌ No | Advisory/optional - style preferences, suggestions | **Level Behavior:** | Level | Validation | Implementation | AI Behavior | |-------|------------|----------------|-------------| | `L1` | Fails check, blocks | Blocks phase completion | **Automatically fixes** before proceeding | | `L2` | Fails check, blocks | Blocks phase completion | Reports violation, **requires human action** | | `L3` | Reports only | Does not block | Optional improvement, can be ignored | ## Template The constitution template is at [template.md](template.md). Use this structure exactly. **To create a constitution:** 1. Read the tem