Guided Onboarding
Walk a new developer through the codebase in structured stages.
When NOT To Use
- Ad-hoc questions outside a staged path (use
gauntlet:challenge) - The knowledge base does not exist yet (use
gauntlet:extract)
Stages
| Stage | Focus | Categories | Difficulty |
|---|---|---|---|
| 1 | Big picture | architecture, data_flow | 1-2 |
| 2 | Core domain | business_logic | 2-3 |
| 3 | Interfaces | api_contract, data_flow | 3 |
| 4 | Patterns | pattern, dependency | 3-4 |
| 5 | Hardening | error_handling, business_logic | 4-5 |
Steps
- Load onboarding progress
- Show current stage and progress summary
- Present 5 challenges from current stage
- Enable hints on first attempt
- Track mastery (correct twice = mastered)
- Check advancement (80% across 10+ challenges)
- Report progress
Graduation
After stage 5, the developer enters the regular gauntlet. Answer history carries over.
Exit Criteria
- Onboarding progress persists across invocations: current stage and challenge count survive session restarts and are loaded at Step 1
- Advancement to the next stage requires 80% correct across 10+ challenges in the current stage; partial completion does not advance
- Mastery tracking requires correct answers twice for a given challenge before it is marked mastered
- After Stage 5 completion, the developer's answer history carries over into the regular gauntlet challenge pool without loss