arch-audit

Classify ADR/DCL assertions into ENFORCED, SPECIFIED, or UNASSESSED compliance categories.

2|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill arch-audit-remaker-digital
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-audit
Source: https://github.com/Remaker-Digital/groundtruth-kb/tree/main/.claude/skills/arch-audit
Command: npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill arch-audit-remaker-digital

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces the risk of architectural drift by checking whether ADR/DCL decisions are implemented and still consistent with the intended architecture across major component families.

Core Features & Use Cases

  • Horizontal compliance matrix: Classifies ADR/DCL artifacts into ENFORCED/SPECIFIED/UNASSESSED (and highlights failing assertions) and groups them by architecture family.
  • Assertion-driven verification: Uses --dry-run assertion evaluation to determine whether each artifact is passing, specified, implemented, or unassessed.
  • Optional knowledge-base recording: Records audit results as a KB document when --record is enabled for prime-run workflows.

Quick Start

Run the audit with --record to create a compliance document in the KB: gt arch-audit --record.

Frequently Asked Questions about arch-audit

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

FAQPage Schema
How do I check ADR compliance across architecture families?

Architecture compliance audits check ADR/DCL assertions by classifying them into ENFORCED, SPECIFIED, or UNASSESSED states, grouping results by architecture family to reveal drift or failing decisions.

What is an architecture compliance matrix used for?

An architecture compliance matrix groups ADR and DCL artifacts by architecture family, classifying assertion states to verify whether governance decisions are implemented and consistent with the intended architecture.

How do I run an architecture audit and save the results?

Run the architecture audit with the record flag to classify ADR and DCL assertions, generate a horizontal compliance matrix, and save the results as a knowledge base document.

Can I dry-run assertion evaluation before recording compliance results?

Dry-run assertion evaluation executes to determine whether each ADR or DCL artifact is passing, specified, implemented, or unassessed before you commit to recording the compliance matrix.

Does architecture audit cover RBAC and transport governance checks?

Architecture audits apply to governance checks across horizontal architecture families including transport, isolation, plugins, MCP, governance infrastructure, RBAC, and contract enforcement.

Why are some architecture decisions showing as UNASSESSED in the compliance audit?

Assertions are classified as UNASSESSED during the audit when the dry-run evaluation determines the ADR or DCL artifact lacks sufficient evidence to confirm implementation or specification status.