How does the verification process work?

The skill analyzes code against existing tenets and provides a compliance status (COMPLIANT or VIOLATED) along with a confidence score based on explicit evidence or patterns found in the code.

Can I ignore specific tenet violations?

Yes, you can manage exceptions using a central table in AGENTS.md for legacy code or via inline code comments using the 'governor:ignore' syntax for specific instances.

What is a tenet in this context?

A tenet is an architectural constraint that requires human-like judgment to verify, such as 'Domain must not import infrastructure,' which is more nuanced than a standard machine-checkable linting rule.

Where are these tenets stored?

Tenets are typically managed and stored within your project's AGENTS.md file, providing a centralized location for project-specific rules and their validation criteria.

Architectural Tenet Governance

Name: Architectural Tenet Governance
Author: dnlopes

bydnlopes

0•

Developer Tools

Manages and verifies high-level architectural constraints and project tenets that require human-like judgment to enforce.

Tenet Governance provides a structured framework for defining, validating, and verifying architectural tenets—critical project constraints that go beyond simple linting rules. It helps maintain system integrity by enforcing boundaries (like domain-driven design rules), establishing severity levels for violations, and managing exceptions within AGENTS.md. By grounding rules in codebase evidence and providing confidence-scored verification, it ensures that long-term architectural decisions are respected throughout the development lifecycle, preventing technical debt and architectural drift.

Key Features

01Standardized tenet formatting with clear severity levels from Critical to Low

020 GitHub stars

03Evidence-based validation to ensure tenets are grounded in actual codebase patterns

04Confidence scoring (1-100) to distinguish between explicit and probable violations

05Comprehensive exception management via inline comments or AGENTS.md tables

06Automated verification of code against established architectural constraints

Use Cases

01Setting up and managing project-specific architectural constraints in AGENTS.md

02Enforcing domain-driven design boundaries and preventing illegal cross-package imports

03Auditing codebases for technical debt and deviations from established design patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dnlopes/claude-code-plugins tenet-governance

For use in Claude.ai and ChatGPT

Download Skill