audit-layer

Audit Layer

Audit a codebase for agentic layer coverage and identify investment opportunities.

Arguments

• $ARGUMENTS: Target directory to audit (defaults to current directory)

Instructions

You are auditing a codebase to assess its agentic layer maturity.

Step 1: Check Commands Directory

Look for .claude/commands/ or equivalent:

# Check existence
ls -la .claude/commands/ 2>/dev/null || echo "Not found"

# List templates if exists
ls .claude/commands/*.md 2>/dev/null | wc -l

Score: 20 points if exists with 3+ templates

Step 2: Check Specs Directory

Look for specs/ or equivalent:

# Check existence and count
ls specs/*.md 2>/dev/null | wc -l

Score: 15 points if exists with specs

Step 3: Check ADW Directory

Look for adws/ or equivalent:

# Check for core module
ls adws/adw_modules/agent.py 2>/dev/null

# Count workflow scripts
ls adws/adw_*.py 2>/dev/null | wc -l

Score: 25 points if adws/ exists, +20 if agent.py exists

Step 4: Check Hooks

Look for .claude/hooks/:

ls .claude/hooks/*.py 2>/dev/null | wc -l

Score: 10 points if hooks exist

Step 5: Check Observability

Look for agents/ output directory:

ls -d agents/*/ 2>/dev/null | wc -l

Score: 5 points if agent output exists

Step 6: Check Worktrees

Look for trees/ isolation:

ls -d trees/*/ 2>/dev/null | wc -l
git worktree list 2>/dev/null | wc -l

Score: 5 points if worktrees exist

Scoring

Component	Max Points
.claude/commands/	20
specs/	15
adws/	25
adw_modules/agent.py	20
hooks/	10
agents/	5
trees/	5
Total	100

Maturity Levels

Score	Level	Recommendation
0-20	None	Start with minimum viable layer
21-40	Basic	Add composed workflows
41-60	Developing	Add hooks and triggers
61-80	Advanced	Add worktree isolation
81-100	Complete	Focus on optimization

Output

Provide audit report:

## Agentic Layer Audit Report

**Directory:** {target}
**Date:** {today}
**Score:** {score}/100
**Level:** {level}

### Components Found
- [x/o] .claude/commands/ ({count} templates)
- [x/o] specs/ ({count} specs)
- [x/o] adws/ ({count} workflows)
- [x/o] adw_modules/agent.py
- [x/o] hooks/ ({count} hooks)
- [x/o] agents/ (output directory)
- [x/o] trees/ (worktree isolation)

### Gaps Identified
1. {missing component}
2. {missing component}

### Recommended Investments
1. {next investment}
2. {next investment}

### Time Investment Analysis
- Estimated current: {percent}% on agentic layer
- Target: 50%+ on agentic layer

Notes

• Higher scores indicate more mature agentic layers
• Focus investments on highest-impact gaps first
• Target is 50%+ engineering time on agentic layer