codebase-recon
Use before non-trivial changes in an unfamiliar or mature repository to map real entry points, data flow, trust boundaries, similar working patterns, commands, tests, and deployment assumptions.
SKILL.md.agents/skills/codebase-recon/SKILL.md
GitHubCodebase Recon
- Read project control-plane files first.
- Locate the real entry point and trace the relevant user/request/data flow end to end.
- Find at least one similar working implementation before inventing a new pattern.
- Identify server/client boundaries, auth checks, persistence, external calls, and error handling.
- Verify actual package scripts/commands; never invent a command because it is conventional.
- Inspect nearby tests and runtime logs/errors.
- Return a compact implementation map: key files, invariants, likely blast radius, unknowns, and verification route.
- Stop exploring when enough evidence exists to make the bounded change safely.