claude-plugins/plugins/claude-code-setup/skills/claude-automation-recommender/references/subagent-templates.md

Subagent Recommendations

Subagents are specialized Claude instances that run in parallel, each with their own context window and tool access. They're ideal for focused reviews, analysis, or generation tasks.

Note: These are common patterns. Design custom subagents based on the codebase's specific review and analysis needs.

Code Review Agents

code-reviewer

Best for: Automated code quality checks on large codebases

Recommend When	Detection
Large codebase (>500 files)	File count
Frequent code changes	Active development
Team wants consistent review	Quality focus

Value: Runs code review in parallel while you continue working Model: sonnet (balanced quality/speed) Tools: Read, Grep, Glob, Bash

---

security-reviewer

Best for: Security-focused code review

Recommend When	Detection
Auth code present	auth/, login, session patterns
Payment processing	stripe, payment, billing patterns
User data handling	user, profile, pii patterns
API keys in code	Environment variable patterns

Value: Catches OWASP vulnerabilities, auth issues, data exposure Model: sonnet Tools: Read, Grep, Glob (read-only for safety)

---

test-writer

Best for: Generating comprehensive test coverage

Recommend When	Detection
Low test coverage	Few test files vs source files
Test suite exists	tests/, __tests__/ present
Testing framework configured	jest, pytest, vitest in deps

Value: Generates tests matching project conventions Model: sonnet Tools: Read, Write, Grep, Glob

---

Specialized Agents

api-documenter

Best for: API documentation generation

Recommend When	Detection
REST endpoints	Express routes, FastAPI paths
GraphQL schema	.graphql files
OpenAPI exists	openapi.yaml, swagger.json
Undocumented APIs	Routes without docs

Value: Generates OpenAPI specs, endpoint documentation Model: sonnet Tools: Read, Write, Grep, Glob

---

performance-analyzer

Best for: Finding performance bottlenecks

Recommend When	Detection
Database queries	ORM usage, raw SQL
High-traffic code	API endpoints, hot paths
Performance complaints	User reports slowness
Complex algorithms	Nested loops, recursion

Value: Finds N+1 queries, O(n²) algorithms, memory leaks Model: sonnet Tools: Read, Grep, Glob, Bash

---

ui-reviewer

Best for: Frontend accessibility and UX review

Recommend When	Detection
React/Vue/Angular	Frontend framework detected
Component library	components/ directory
User-facing UI	Not just API project

Value: Catches accessibility issues, UX problems, responsive design gaps Model: sonnet Tools: Read, Grep, Glob

---

Utility Agents

dependency-updater

Best for: Safe dependency updates

Recommend When	Detection
Outdated deps	npm outdated has results
Security advisories	npm audit warnings
Major version behind	Significant version gaps

Value: Updates dependencies incrementally with testing Model: sonnet Tools: Read, Write, Bash, Grep

---

migration-helper

Best for: Framework/version migrations

Recommend When	Detection
Major upgrade needed	Framework version very old
Breaking changes coming	Deprecation warnings
Refactoring planned	Architectural changes

Value: Plans and executes migrations incrementally Model: opus (complex reasoning needed) Tools: Read, Write, Grep, Glob, Bash

---

Quick Reference: Detection → Recommendation

If You See	Recommend Subagent
Large codebase	code-reviewer
Auth/payment code	security-reviewer
Few tests	test-writer
API routes	api-documenter
Database heavy	performance-analyzer
Frontend components	ui-reviewer
Outdated packages	dependency-updater
Old framework version	migration-helper

---

Subagent Placement

Subagents go in .claude/agents/:

.claude/
└── agents/
    ├── code-reviewer.md
    ├── security-reviewer.md
    └── test-writer.md

---

Model Selection Guide

Model	Best For	Trade-off
haiku	Simple, repetitive checks	Fast, cheap, less thorough
sonnet	Most review/analysis tasks	Balanced (recommended default)
opus	Complex migrations, architecture	Thorough, slower, more expensive

---

Tool Access Guide

Access Level	Tools	Use Case
Read-only	Read, Grep, Glob	Reviews, analysis
Writing	+ Write	Code generation, docs
Full	+ Bash	Migrations, testing