arch-evaluate

Audits a codebase against its architecture brief and ADRs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cjennings/rulesets --skill arch-evaluate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-evaluate
Source: https://github.com/cjennings/rulesets/tree/main/arch-evaluate
Command: npx skills add https://github.com/cjennings/rulesets --skill arch-evaluate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit architecture conformance of an existing codebase against its brief and ADRs, enabling early detection of architectural drift and policy violations.

Core Features & Use Cases

  • Framework-agnostic checks for cycles, layer violations, and public API drift, augmented by language-specific linters when configured.
  • Detect open decisions and forbidden dependencies by cross-referencing briefs and ADRs, to guide remediation and governance.
  • Produce a structured architecture evaluation report suitable for CI gates and architectural reviews.

Quick Start

Run arch-evaluate to audit the current codebase against its architecture brief and ADRs and generate a report.

Frequently Asked Questions about arch-evaluate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit architecture conformance against ADRs in an existing codebase?

To audit architecture conformance, this Skill cross-references your architecture brief and ADRs to infer allowed dependencies and module boundaries, then reports violations with severity levels and pointers to the relevant documentation sections.

What is architecture conformance checking and how does it detect architectural drift?

Architecture conformance checking validates that codebase dependencies comply with declared architectural decisions. It detects architectural drift by identifying cycles, layer violations, and public API drift through framework-agnostic static analysis and optional language-specific linters.

Can I detect layer violations and cyclic dependencies without configuring a specific linter?

Yes, you can detect layer violations and cyclic dependencies framework-agnostically by default. The Skill infers allowed module boundaries from your architecture docs and brief, with optional language-specific linters available for augmented static analysis if configured.

How do I generate an architecture evaluation report suitable for CI gates?

You generate a structured architecture evaluation report by running the audit against your brief and ADRs. The resulting report includes severity ratings and documentation pointers, making it suitable for automated CI gates and architectural reviews.

Does architecture conformance analysis work with any programming language or framework?

Architecture conformance analysis works framework-agnostically across languages by default to surface cycles and layer violations. You can configure optional language-specific linters and tooling to augment the default checks for more precise static analysis.