diegosouzapw Agentic Layer Audit Skill
Evaluate a codebase's agentic layer maturity and identify investment opportunities.
When to Use
- Assessing current agentic layer coverage
- Identifying gaps in automation
- Planning agentic layer investments
- Measuring progress toward 50%+ agentic time
Core Concept
"Am I working on the agentic layer or am I working on the application layer?"
This skill helps answer that question by auditing what exists.
Audit Checklist
1. Commands Directory
Check for .claude/commands/ or equivalent:
Look for:
- chore.md # Chore planning template
- bug.md # Bug fix template
- feature.md # Feature planning template
- implement.md # Implementation HOP
- test.md # Test execution template
- review.md # Review template
2. Specs Directory
Check for specs/ or equivalent:
Look for:
- Issue-based specs (issue-*.md)
- Generated plans (chore-*.md, feature-*.md)
- Deep specs (complex multi-file architectures)
3. ADW Directory
Check for adws/ or equivalent:
Look for:
- adw_modules/agent.py # Core agent execution
- Gateway scripts (adw_prompt.py, adw_slash_command.py)
- Composed workflows (adw_*_*.py)
- Triggers (trigger_*.py)
4. Hooks Directory
Check for .claude/hooks/ or equivalent:
Look for:
- pre_tool_use hooks
- post_tool_use hooks
- user_prompt_submit hooks
5. Agent Output Directory
Check for agents/ or equivalent:
Look for:
- ADW ID directories
- State files (adw_state.json)
- Output files (cc_*.jsonl, cc_*.json)
6. Worktree Support
Check for trees/ or equivalent:
Look for:
- Git worktree setup
- Isolation configuration
- Port allocation patterns
Coverage Scoring
| Component | Points | Present? |
|---|---|---|
| .claude/commands/ | 20 | |
| specs/ | 15 | |
| adws/ | 25 | |
| adw_modules/agent.py | 20 | |
| hooks/ | 10 | |
| agents/ | 5 | |
| trees/ | 5 |
Total: 100 points
| 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 |
Key Memory References
- @agentic-layer-structure.md - What to look for
- @the-guiding-question.md - Why this matters
- @agentic-vs-application.md - Layer separation
Output Format
## Agentic Layer Audit Report
**Project:** {name}
**Audit Date:** {date}
**Coverage Score:** {score}/100
### Components Found
- [x] .claude/commands/ (5 templates)
- [x] specs/ (12 specs)
- [ ] adws/ (not found)
- [ ] hooks/ (not found)
### Maturity Level
{Level} - {Recommendation}
### Gaps Identified
1. No ADW scripts for workflow orchestration
2. No hooks for event-driven automation
3. No worktree isolation for parallelization
### Recommended Investments
1. Create adws/adw_modules/agent.py
2. Add gateway script (adw_prompt.py)
3. Create composed workflow for common tasks
### Time Investment Analysis
- Current: ~20% agentic layer
- Target: 50%+ agentic layer
- Gap: Need 30% more investment in agentic work
Anti-Patterns to Identify
- Commands exist but no specs (templates unused)
- Specs exist but no ADWs (manual execution)
- Many one-off scripts instead of composed workflows
- Application layer dominant (>70% of codebase)
Version History
- v1.0.0 (2025-12-26): Initial release
Last Updated
Date: 2025-12-26 Model: claude-opus-4-5-20251101