Cartograph

Extract a structural map of any TypeScript/JS web app: surfaces, features, entities, relationships, operations, flows, and compartments. Four orthogonal axes — surfaces are where you go (pages/entry points), features are what you can do (standalone capabilities), entities are what the app works with (data), and compartments are how the code is organized (logical file groupings that bridge product concepts to the underlying codebase).

Workflow

The workflow runs in 5 waves plus a parallel health pass (Wave 3.5). Within each wave, spawn the listed agents in parallel, wait for all of them to finish, then move to the next wave. Each agent should return its results as a JSON array (or arrays) matching the schema in references/json-schema.md. Between waves, you are the orchestrator — collect agent outputs and pass them as context to the next wave's agents.

Wave 0: Discover Codebase Structure

Run this yourself (no agent needed — it's fast and every later agent needs the results).

1. Read package.json for project name and dependencies (framework detection)
2. Glob for key structural files:
   • Schema: **/*.prisma, **/schema.*, **/models/**
   • Routes/Pages: app/**/page.{tsx,ts,jsx,js}, app/api/**/*.{ts,js}, pages/**/*.{tsx,ts}
   • Server actions: grep for "use server"