Claude Skill

brooks-audit

Architecture audit that maps module dependencies, checks layering integrity, and flags structural decay across a codebase, drawing on twelve classic engineering books. Triggers when: user asks to audit architecture, review folder/module structure, check for circular imports, unde

LLM Mart · 0 points · 2 views 157 listing impressions 0 install-command copies
Download hyhmrright-brooks-lint-skills_brooks-audit-17cdd1c.zip · 6 KB

Install

skills CLI npx skills add https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-audit
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install hyhmrright-brooks-lint@llmmart
Git git clone https://github.com/hyhmrright/brooks-lint.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole hyhmrright/brooks-lint collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Brooks-Lint — Architecture Audit

Setup

Read in order:

  1. ../_shared/common.md — Iron Law, Project Config, Report Template, Health Score
  2. ../_shared/source-coverage.md — book coverage, exceptions, tradeoffs
  3. ../_shared/decay-risks.md — symptom definitions and source attributions
  4. architecture-guide.md (this directory) — the audit framework

Process

Onboarding mode: If the user asks for an onboarding report, codebase tour, or "explain this codebase to a new developer", read onboarding-guide.md from this directory and follow it instead of architecture-guide.md. This mode explains rather than diagnoses — no Health Score, no Iron Law findings.

Scope: if the user did not specify files or a directory, apply Auto Scope Detection (../_shared/common.md) first.

  1. Gather codebase context and draw the module dependency graph as Mermaid (Steps 0–1 of the guide)
  2. Scan for each decay risk in the order specified (Steps 2–4 of the guide)
  3. Assign node colors in the Mermaid diagram based on findings (red/yellow/green) — after Step 4
  4. Run the Testability Seam Assessment (Step 5 of the guide)
  5. Run the Conway's Law check (Step 6 of the guide)
  6. Output using the Report Template from common.md — Mermaid graph FIRST, then Findings

Mode line in report: Architecture Audit

Files (brooks-lint)
  • architecture-guide.md 8.4 KB
    Loading…
  • onboarding-guide.md 2.9 KB
    Loading…
  • SKILL.md 2.1 KB
    ---
    name: brooks-audit
    description: >
      Architecture audit that maps module dependencies, checks layering integrity, and
      flags structural decay across a codebase, drawing on twelve classic engineering books.
      Triggers when: user asks to audit architecture, review folder/module structure,
      check for circular imports, understand how the codebase is organized, or asks
      "does this follow clean architecture?" or "why does everything depend on everything?".
      Also triggers for onboarding requests: "explain this codebase to a new developer"
      or "give me a codebase tour" (use onboarding mode).
      Do NOT trigger for: PR-level code review (use brooks-review) or line-level refactoring
      questions — this skill analyzes structural/module-level concerns, not individual functions.
    metadata:
      opencode/slash: "true"
    ---
    
    # Brooks-Lint — Architecture Audit
    
    ## Setup
    
    Read in order:
    
    1. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score
    2. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs
    3. `../_shared/decay-risks.md` — symptom definitions and source attributions
    4. `architecture-guide.md` (this directory) — the audit framework
    
    ## Process
    
    **Onboarding mode:** If the user asks for an onboarding report, codebase tour, or
    "explain this codebase to a new developer", read `onboarding-guide.md` from this
    directory and follow it instead of `architecture-guide.md`. This mode explains rather
    than diagnoses — no Health Score, no Iron Law findings.
    
    **Scope:** if the user did not specify files or a directory, apply Auto Scope Detection
    (`../_shared/common.md`) first.
    
    1. Gather codebase context and draw the module dependency graph as Mermaid (Steps 0–1 of the guide)
    2. Scan for each decay risk in the order specified (Steps 2–4 of the guide)
    3. Assign node colors in the Mermaid diagram based on findings (red/yellow/green) — after Step 4
    4. Run the Testability Seam Assessment (Step 5 of the guide)
    5. Run the Conway's Law check (Step 6 of the guide)
    6. Output using the Report Template from common.md — Mermaid graph FIRST, then Findings
    
    **Mode line in report:** `Architecture Audit`
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.