Stats
Actions
Tags
From governor
Use when working with architectural tenets - project constraints that require human judgment to verify. This skill provides guidance on tenet format, severity levels, validation criteria, and verification patterns. Load when setting up, managing, or verifying tenets in AGENTS.md.
How this skill is triggered — by the user, by Claude, or both
Slash command
/governor:skills/tenet-governanceThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Guidance for managing architectural tenets - constraints that must be followed in all work on a codebase.
Guidance for managing architectural tenets - constraints that must be followed in all work on a codebase.
Tenets are architectural constraints that require human judgment to verify. They differ from linting rules:
| Tenets | Linting Rules |
|---|---|
| Architectural boundaries | Code style |
| "Domain must not import infrastructure" | "Use 2-space indentation" |
| Require judgment to verify | Machine-checkable |
| Few (3-7 per project) | Many (hundreds) |
| Project-specific decisions | Industry conventions |
### T<N>. <Name>
<Description: 2-4 sentences explaining constraint and rationale>
**Severity:** <critical | high | medium | low>
**Evidence:**
- `<file:line>` - <observation>
| Level | Meaning | Verification Behavior |
|---|---|---|
| critical | Breaks system invariants | Always fail |
| high | Causes significant tech debt | Fail by default |
| medium | Reduces code quality | Warn by default |
| low | Guideline, not requirement | Info only |
Table (in AGENTS.md):
## Tenet Exceptions
| File | Tenet | Reason | Approved |
|------|-------|--------|----------|
| `src/legacy/adapter.go` | T1 | Legacy integration | 2024-01-15 |
Inline (in code):
// governor:ignore T1 - Legacy adapter, tracking in #123
import "infrastructure/db"
Validation (setup/manage): Is this tenet grounded in reality?
Verification (verify): Does this code follow the tenets?
| Score | Criteria | Example |
|---|---|---|
| 90-100 | Explicit violation | Forbidden import present |
| 70-89 | Likely violation | Pattern suggests violation |
| 50-69 | Possible violation | Ambiguous code |
| 1-49 | Uncertain | Probably false positive |
For detailed specifications and examples:
npx claudepluginhub dnlopes/claude-code-plugins --plugin governorAuthors enforceable project constitutions for greenfield projects with testable principles, enforcement mechanisms, rationale, and amendment processes.
Encodes human-readable governance policies into machine-executable JSON constraints for AI agents and CI pipelines to validate automatically. Outputs rule files in .ai/governance/.
Analyzes multi-language projects (Java, Kotlin, TypeScript, Python, Rust, Go) to extract etalon classes, patterns, and layer-based architecture. Generates convention documents and rules in .claude/convention/.