code-tour

What problem does it solve? New team members and reviewers struggle to understand unfamiliar codebases, and architecture knowledge often lives only in senior engineers' heads. This Skill produces structured, step-by-step code tours that document how a system actually works. ## Core Features & Use Cases - Persona-Tailored Tours: Generates walkthroughs for eight personas including new-joiner, architect, pr-reviewer, security-reviewer, and rca-investigator, each with appropriate depth and focus. - SMIG Writing Structure: Every section follows Situation, Mechanism, Implication, Gotcha so explanations cover both how code works and what to watch out for. - File and Line Anchors: Tours reference real code locations (e.g., apps/api/src/routes/orders.ts:67) and support @tour code annotations to keep documentation connected to source. - Use Case: A new engineer joins your team. Generate a new-joiner tour of your monorepo covering the module map, the core order-placement code path, edge cases like inventory race conditions, and suggested next files to explore. ## Quick Start Ask the agent to create a code tour of this repository for a new joiner, covering the module map, core code path, and edge cases.