← Back to list
validation-constitution
by deepeshBodh
SPEC-first multi-agent framework for Claude Code.
⭐ 7🍴 0📅 Jan 24, 2026
Run in ManusSKILL.md
name: validation-constitution description: This skill should be used when the user asks to "review constitution", "validate principles", "check quality", or mentions "constitution review", "quality check", "version bump", "anti-patterns", or "constitution audit". Provides checklists, anti-pattern detection, and version bump guidance.
Validating Constitution
Purpose
Verify constitution quality before finalization. This skill provides checklists, anti-pattern detection, and version bump guidance. Use after authoring with authoring-constitution or brownfield-constitution skills.
Quantification Requirements
Vague language MUST be replaced with measurable criteria:
| Vague | Quantified |
|---|---|
| "Code should be clean" | "Zero lint warnings from configured rules" |
| "Functions should be short" | "Functions MUST NOT exceed 40 lines" |
| "Tests should cover the code" | "Coverage MUST be ≥80% for new code" |
| "Response should be fast" | "API MUST respond in <200ms p95" |
| "Secure by default" | "All inputs MUST be validated; auth required on all endpoints" |
Version Bump Rules
| Bump | Trigger | Example |
|---|---|---|
| MAJOR | Principle removed | Removing "Test-First" principle |
| MAJOR | Incompatible redefinition | Changing coverage from 80% to 50% |
| MINOR | New principle added | Adding "Observability" principle |
| MINOR | Significant expansion | Adding 5 new rules to existing principle |
| PATCH | Clarification | Rewording for clarity, typo fixes |
| PATCH | Non-semantic change | Formatting, comment updates |
Quality Checklist
Before finalizing a constitution, verify all items in QUALITY-CHECKLIST.md.
Summary of checks:
- Principle Quality (Enforcement, Testability, Rationale present)
- Structure Quality (all mandatory sections)
- No Placeholders Rule (actual tools, not
[PLACEHOLDER]) - Governance Quality (versioning, amendment process)
Anti-Patterns to Avoid
See ANTI-PATTERNS.md for common mistakes and fixes.
Quick reference:
| Anti-Pattern | Fix |
|---|---|
| Vague principle | Define specific metrics |
| Missing enforcement | Add CI check, code review rule, or audit |
| Untestable rule | Define layer rules with import constraints |
| Cargo-cult rule | Add rationale explaining the "why" |
| Over-engineering | Start with 5-7 core principles |
| No escape hatch | Define exception registry |
| Placeholder syndrome | Use detected tools or industry defaults |
| Generic thresholds | Specify numeric values |
Workflow
- After authoring: Run through the Quality Checklist
- Review each principle: Verify three-part rule (Enforcement/Testability/Rationale)
- Check for anti-patterns: Compare against common mistakes
- Determine version bump: Use Version Bump Rules table
- Final sign-off: All checklist items pass
Related Skills
- authoring-constitution - Core authoring for greenfield
- brownfield-constitution - Authoring for existing codebases
Score
Total Score
65/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
○説明文
100文字以上の説明がある
0/10
○人気
GitHub Stars 100以上
0/15
✓最近の活動
1ヶ月以内に更新
+10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
✓タグ
1つ以上のタグが設定されている
+5
Reviews
💬
Reviews coming soon
