Skill155 repo starsupdated 18d ago

module-audit-agent

Use when asked to audit a module, check its health, or assess whether it should be refactored. Runs structural query, risk check, and test generation automatically.

View source Repository: ai-agent-skills

Install in Claude Code

Copy

git clone --depth 1 https://github.com/wednesday-solutions/ai-agent-skills /tmp/module-audit-agent && cp -r /tmp/module-audit-agent/skills/agents/module-audit ~/.claude/skills/module-audit-agent

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Module Audit Agent

## When to use
- "Audit this module"
- "Is it safe to refactor X?"
- "What is the health of this service?"
- "Should we rewrite X?"

## What to do

1. **In parallel:**
   - **brownfield-chat** — Read `dep-graph.json` and `summaries.json` for the target module. Report: what it does, its imports, what imports it, and any known conflicts.
   - **brownfield-fix** — Run `wednesday-skills score <module>` and `wednesday-skills blast <module>`. Report risk band and total dependent count.

2. Present the combined audit report:
   - Purpose summary (from summaries.json)
   - Risk score + band (0–30 low / 31–60 medium / 61–80 high / 81–100 critical)
   - Blast radius (dependent count, cross-language flagged separately)
   - Architecture violations or danger zone warnings (from MASTER.md)
   - Recommendation: proceed / review / senior sign-off / do not touch

3. **brownfield-tests** — Only run if coverage < 30% AND risk > 50:
   - Run `wednesday-skills gen-tests --file <module>`
   - Show generated test file to dev for review before writing

## Never
- Recommend refactoring a critical file (risk > 80) without flagging the blast radius
- Read raw source to answer structural questions — use graph only
- Auto-write test files without showing the dev first

More from this repository

onboard-dev-agentSkill

Use when a dev is new to the project, asks for an overview, or wants to get oriented quickly. Fills graph gaps then runs a guided codebase interview.

pr-review-agentSkill

Full PR review orchestrator. Use when asked to review a PR or check if it is ready to merge. Runs blast radius + drift check on changed files, then hands off to pr-review for comment triage and fixes. Do NOT use pr-review directly for full reviews — use this.

brownfield-driftSkill

Enforces architecture boundaries defined in PLAN.md. Use when a PR crosses module/service boundaries, when the dev asks "are we following the architecture?", or as a scheduled architecture health check. Not for querying what a module does — use brownfield-chat for that.

codebase-intelSkill

Unified codebase intelligence. Handles all questions about structure, logic, risk, and dependencies. Combines natural-language Q&A with deterministic lookups and pre-edit blast radius checks.

deploy-checklistSkill

Pre-deploy and post-deploy checklist skill. Ensures env vars, migrations, CI, rollback plan, smoke tests, and monitoring are verified before and after every deployment.

greenfieldSkill

Parallel persona planning for new projects. Research agent runs first to build domain context, then Architect, PM, and Security agents run in parallel. Synthesis agent combines all perspectives into a detailed GSD-style PLAN.md with Tensions section.

pr-reviewSkill

Fix engine for PR review comments. Fetches review comments (Gemini bot or human), categorizes by impact, posts a prioritized fix queue, and applies fixes on dev approval. Called directly for quick fixes, or internally by pr-review-agent as part of full PR review.

standards-kitSkill

Unified development and design standards. Enforces code quality (complexity < 8), strict naming conventions, and the mandatory use of approved UI component libraries.