{"id":50967855,"url":"https://github.com/flyte/claude-code-guided-tour","last_synced_at":"2026-06-18T22:30:56.136Z","repository":{"id":365106542,"uuid":"1270584531","full_name":"flyte/claude-code-guided-tour","owner":"flyte","description":"Interactive guided tour that teaches you an unfamiliar codebase. Partner to claude-code-quiz-master.","archived":false,"fork":false,"pushed_at":"2026-06-15T21:42:47.000Z","size":30,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-15T23:22:49.873Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flyte.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-15T21:25:37.000Z","updated_at":"2026-06-15T21:42:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/flyte/claude-code-guided-tour","commit_stats":null,"previous_names":["flyte/claude-code-guided-tour"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/flyte/claude-code-guided-tour","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyte%2Fclaude-code-guided-tour","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyte%2Fclaude-code-guided-tour/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyte%2Fclaude-code-guided-tour/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyte%2Fclaude-code-guided-tour/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flyte","download_url":"https://codeload.github.com/flyte/claude-code-guided-tour/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flyte%2Fclaude-code-guided-tour/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34510281,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-18T22:30:55.930Z","updated_at":"2026-06-18T22:30:56.114Z","avatar_url":"https://github.com/flyte.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# claude-code-guided-tour\n\nAn interactive guided tour that **teaches** you (or an agent) an unfamiliar\ncodebase. Claude explores the repo with a recon subagent, fans out parallel\nsubagents to study each subsystem, then walks you through a sequenced lesson\none stop at a time — high-level first, grounded in real code.\n\nIt is the teaching partner to\n[`claude-code-quiz-master`](https://github.com/flyte/claude-code-quiz-master):\nthe **tour teaches**, the **quiz tests**.\n\n## Install\n\n```\n/plugin marketplace add flyte/claude-plugins\n/plugin install claude-code-guided-tour@flyte\n```\n\n## Use\n\n- `/tour` — take the overall guided tour of the whole codebase.\n- `/tour-dive \u003carea\u003e` — deep dive into one subsystem (e.g. `/tour-dive auth`).\n\nDuring the overall tour you drive the pace: `next`, `dig in`, `skip`,\n`jump \u003carea\u003e`, `stop`.\n\n### Options\n\n- `--level \u003cbeginner|intermediate|expert\u003e` — depth for this session.\n- `--set-level \u003clevel\u003e` — set and remember your level.\n- `--refresh` — re-explore the codebase from scratch.\n- `--model \u003chaiku|sonnet|opus\u003e` — override the model used by the exploration\n  subagents for this run.\n- `--smoke` — run a self-check that the plugin is installed correctly (no tour).\n\n## How it works\n\nThe first run explores the codebase and caches a **curriculum** at\n`.claude/tour-map.json` (an ordered set of teaching \"stops\"). Later runs reuse\nit and only re-explore when the codebase has changed meaningfully, so they're\nfast. The cache is git-ignored.\n\n## Models \u0026 cost\n\nExploration is the dominant token cost (one subagent per subsystem, run in\nparallel), so the subagents default to cheaper models rather than inheriting\nyour main session model:\n\n| Phase | Default model |\n|-------|---------------|\n| Recon | Haiku |\n| Deep-dive fan-out | Sonnet |\n| Deep-dive re-drill (`/tour-dive`) | Sonnet |\n| Synthesis (curriculum assembly) | your session model |\n\nOverride per run with `--model \u003chaiku\\|sonnet\\|opus\u003e`. If your environment sets\n`CLAUDE_CODE_SUBAGENT_MODEL`, that takes precedence over both the defaults and\n`--model`.\n\n## Requirements\n\n`git` and `jq` on PATH. Staleness tracking needs a git repo; outside one the\ntour still works but won't auto-refresh.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflyte%2Fclaude-code-guided-tour","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflyte%2Fclaude-code-guided-tour","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflyte%2Fclaude-code-guided-tour/lists"}