Explore

Phase 2: Architecture Discovery

• Map top-level directories via Glob
• Find entry points: src/index.*, src/main.*, src/app.*, src/server.*, cmd/, bin/
• Read entry points (first 50-80 lines) to understand bootstrap
• Identify architecture pattern: MVC, hexagonal, event-driven, microservices, layered, etc.
• Trace key imports from entry points using Grep
• Map module boundaries: major subsystems and how they communicate

Phase 3: Key File Inventory

Catalog 15-30 of the most important files across these categories:

Phase 4: Patterns & Conventions

Identify recurring patterns:

• Error handling (custom error types, result types)
• Logging (structured, levels, setup)
• Testing (framework, unit/integration/e2e split)
• Naming (file naming convention, variable style)
• State management (how state flows through the app)

Token Efficiency

• Glob before Read — always search for files before reading them
• Read with limits — limit: 50 for source, limit: 30 for config
• Grep to trace — find imports and definitions instead of reading whole files
• Parallel Glob — make multiple Glob calls in parallel for different file types
• Skip large files — note them and move on

Report Output

Write to: ~/.tron/workspace/explore/YYYY-MM-DD-<slug>/report.md

Generate the timestamp from current time, slug from project name.

Write is restricted to ~/.tron/workspace/ only.

Format

---