onboardlisted

# /onboard — Project Onboarding Wizard Bring Claude Code + the control plane from "template installed" to "fully understands this project". 8 stages, ~4-6 hours interactive, hybrid (auto-do mechanical work · prompt only for context the user alone has). ## Token budget (MANDATORY) - Stages 0-1 use Bash scripts (topology) + ONE parallel Explore dispatch — no full file Reads in the main session. - Stage 2 interview uses `AskUserQuestion` (≤4 per round) — never free-form prose questions. - Stage 3 mining uses 3 parallel Explore agents — output stages to `_onboard-staging/` for the drafting agent, never read back into main context. - Stage 4 drafting is delegated to `onboarding-engineer` agent — do not re-read the drafts in main context; trust its summary. - Stage 5 ratification reads only `_onboard-staging/a-rule-candidates.md` with `limit: 200`. - Stage 6 state capture uses `AskUserQuestion` + paste-friendly textboxes — no scanning of foreign tools (Jira / Linear) in-session. - **Hard cap: 50k tokens** main-session context across all 8 stages for a medium project. ## Subcommands - `/onboard` — fresh full wizard (Stages 0-7). Stage 8 (retro) runs separately after the first sprint closes. - `/onboard refresh` — re-onboard mode. Skip stages whose input hasn't changed; re-mine git history; present DELTA only. - `/onboard scan` — Stage 1 only. Regenerate `docs/setup/codebase-orientation.md`. Cheap; safe to re-run whenever the codebase shape changes substa