ReddRadar
Agent skill
brooks-audit
Architecture audit drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks to audit architecture, review module structure, check system design, or assess project organization. Also triggers when user mentions: clean architecture / dependency inversion / hexagonal architecture / bounded contexts / module coupling / package structure. Use this skill proactively when project structure or module dependencies are discussed.
Install this agent skill to your Project
npx add-skill https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-audit
SKILL.md
Brooks-Lint — Architecture Audit
Setup
- Read
../_shared/common.mdfor the Iron Law, Project Config, Report Template, and Health Score rules - Read
../_shared/source-coverage.mdfor book-level coverage, exceptions, and tradeoffs - Read
../_shared/decay-risks.mdfor symptom definitions and source attributions - Read
architecture-guide.mdin this directory for the audit framework
Process
- Draw the module dependency graph as a Mermaid diagram (Step 1 of the guide)
- Scan for each decay risk in the order specified in the guide
- Assign node colors in the Mermaid diagram based on findings (red/yellow/green)
- Run the Conway's Law check
- Output using the Report Template from common.md — Mermaid graph FIRST, then Findings
Mode line in report: Architecture Audit
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
hyhmrright/brooks-lint
brooks-test
Test quality review drawing on twelve classic engineering books, with primary focus on xUnit Test Patterns, The Art of Unit Testing, How Google Tests Software, and Working Effectively with Legacy Code. Triggers when: user asks about test quality, flaky tests, mock abuse, test debt, legacy code testability, or shares test files for review. Also triggers when user mentions: test smells / characterization tests / test pyramid / test doubles / over-mocking / brittle tests. Use this skill proactively whenever test files are shared for review.
hyhmrright/brooks-lint
brooks-debt
Tech debt assessment drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks about tech debt, where to refactor, health check, or systemic maintainability questions. Also triggers when user asks why the codebase is hard to maintain, why adding developers isn't helping, or why complexity keeps growing. Use this skill proactively when maintainability or refactoring priorities are discussed.
hyhmrright/brooks-lint
brooks-review
PR code review drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks to review code, check a PR, review a pull request, or shares a diff for feedback. Also triggers when user mentions: Brooks's Law / Mythical Man-Month / conceptual integrity / second system effect / code smells / refactoring / clean architecture / DDD / domain-driven design / SOLID principles / Hyrum's Law / deep modules / tactical programming. Use this skill proactively whenever code, a diff, or a PR is shared for review.
sickn33/antigravity-awesome-skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
sickn33/antigravity-awesome-skills
claude-code-expert
Especialista profundo em Claude Code - CLI da Anthropic. Maximiza produtividade com atalhos, hooks, MCPs, configuracoes avancadas, workflows, CLAUDE.md, memoria, sub-agentes, permissoes e integracao com ecossistemas.
sickn33/antigravity-awesome-skills
lex
Centralized 'Truth Engine' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.
Didn't find tool you were looking for?