Skip to content

@adventurer

The adventurer is the first step in every pipeline. It explores unfamiliar code, traces dependencies, maps module relationships, and generates structured reconnaissance reports for downstream specialists.

  • Mode: subagent
  • Permissions: read/glob/grep/list/lsp: allow, edit: deny, bash: * ask

The adventurer is pure exploration — it never implements or designs. It handles one role per session: exploration only. Outputs are consumed by architects, planners, and builders.

  1. Entry point analysis — Find main entry points, routes, handlers
  2. Call chain tracing — Follow key functions through their call graph
  3. Module mapping — Map directory structure to responsibilities
  4. Pattern discovery — Identify conventions, patterns, anti-patterns
  5. Boundary identification — Find API surfaces, interfaces, extension points
  6. Reconnaissance report — Structured output with key files, call chains, data flow, and a discovery log
TierScopeDepth
SmallSingle file or componentTrace all paths, identify patterns
MediumModule or feature areaMap module structure, trace key paths
LargeCross-cutting concernMap relationships across modules
HugeEntire codebaseHigh-level architecture map, find leverage points

Every reconnaissance session produces a structured report:

  • Key files and their responsibilities
  • Call chains and data flow
  • Discovery log (surprises, risks, conventions found)
  • Recommendations for next steps