What is architectural drift?

Architectural drift occurs when the actual implementation in the code deviates from the agreed-upon design patterns, constraints, or requirements defined in ADRs and specifications.

How does the --scrum flag work?

The --scrum flag initiates a virtual triage ceremony involving five specialized AI agents (PO, SM, Architects, and Engineers) to prioritize findings, estimate effort, and resolve disputes between documentation and implementation.

What happens if my project is missing ADRs or specs?

The skill will identify the missing directories and recommend using specific commands like /design:adr or /design:spec to initialize your project's design governance.

Can I audit a specific part of my project?

Yes, you can provide a scope argument such as a directory path or a topic keyword (e.g., 'api' or 'security') to limit the audit's focus.

What are the severity levels used in the audit report?

Findings are classified as CRITICAL (requirement violations), WARNING (guideline/constraint violations), or INFO (coverage gaps and minor policy suggestions).

Design Compliance & Architecture Audit

Name: Design Compliance & Architecture Audit
Author: joestump

byjoestump

•

Security & Testing

Performs comprehensive audits of code alignment with Architecture Decision Records (ADRs) and OpenSpec specifications to detect and resolve technical drift.

This skill automates the complex task of ensuring source code remains faithful to its governing design documents. By cross-referencing implementation against ADRs and OpenSpec requirements, it identifies critical drift, coverage gaps, and stale documentation. It features an advanced 'Scrum Triage' mode that spawns a virtual team of specialists—including Product Owners and Architects—to prioritize findings, estimate remediation effort, and resolve architectural disputes, ensuring your project's design intent is maintained throughout the development lifecycle.

Key Features

01Automated drift detection between source code, ADRs, and OpenSpec specifications

02Multi-agent team review mode for validated, high-accuracy audit findings

034 GitHub stars

04Integrated Scrum Triage ceremony for functional theme grouping and business prioritization

05Smart identification of undocumented code areas and outdated design artifacts

06Comprehensive reporting with prioritized severity levels (Critical, Warning, Info)

Use Cases

01Conducting pre-release architectural compliance reviews to ensure all MUST requirements are implemented

02Identifying technical debt by locating high-risk code sections that lack governing design documentation

03Facilitating automated triage sessions to align engineering, product, and architecture on remediation priorities

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design audit

For use in Claude.ai and ChatGPT

Download Skill