Code Tour

Create CodeTour .tour files for codebase walkthroughs that open directly to real files and line ranges. Tours live in .tours/ and are meant for the CodeTour format, not ad hoc Markdown notes.

A good tour is a narrative for a specific reader: what they are looking at, why it matters, and what path to follow next.

Only create .tour JSON files. Do not modify source code.

When to Use

• User asks for a code tour, onboarding tour, architecture walkthrough, or PR tour
• User says "explain how X works" and wants a reusable guided artifact
• Onboarding a new maintainer or reviewer
• Documenting an RCA failure path or security trust boundary

When NOT to Use