Explore the codebase, research best practices, evaluate alternatives, and recommend the best solution with clear reasoning.
Key Constraints
- Read project instructions first —
CLAUDE.mdorAGENTS.mdat repo root, plus stack-specific files. - Search before suggesting — check if something already exists before recommending new implementations.
- Evaluate 2-3 approaches — describe each, compare pros/cons specific to this codebase, and recommend one.
- Justify with WHY — every recommendation needs reasoning tied to the specific codebase, not generic advice.
- Be specific — include file paths, function names, line numbers. Vague findings aren't useful.
Output
Produce a report with these sections:
- Problem Statement
- Codebase Context — existing patterns, utilities, integration points (with file paths)
- Best Practices — industry recommendations with sources
- Alternative Approaches — 2-3 approaches with description, pros, cons, codebase fit
- Recommendation — which approach and WHY it fits this codebase
- Open Questions