{"slug":"claude-code-repo-map","title":"Map a repo for someone who cloned it this morning","summary":"Claude Code writes a one-page map of how to run, test, and change the system. It does not edit application code.","agent":"Claude Code","agentSlug":"claude-code","category":"Coding","categorySlug":"coding","roles":["Software engineer","Product manager"],"roleSlugs":["software-engineer","product-manager"],"industries":["Software"],"industrySlugs":["software"],"jobs":["shipping-code"],"topic":"Dev & Coding","topicSlug":"dev-and-coding","score":24,"difficulty":"easy","estCost":"One Claude Code session. No extra services.","costTier":"low","timeSaved":"A half day of wandering for a new teammate, if the map is checked by someone who already knows the repo.","prompt":"Do not edit application code. You may add a single doc if I ask for a file at the end.\n\nRead the repository and write a map with:\n- How to install and run tests, using scripts that actually exist. Quote the script names.\n- The five directories a newcomer will touch first, and what lives there.\n- Where configuration and secrets are expected. Name the env example file if there is one. Do not print secret values.\n- One golden path: the function or route that handles the core action, with file paths.\n- Known traps you can see in comments, CI config, or docs.\n\nIf you are unsure, say unsure. Do not invent a makefile.","steps":[{"title":"Run Claude Code from a clean clone","detail":"The overview docs cover opening a project. A clean clone shows missing setup the old checkout hides."},{"title":"Paste the prompt and forbid code edits","detail":"The first sentence is the safety rail. Stop the session if files start changing."},{"title":"Have a current owner correct the map","detail":"A confident wrong golden path is worse than no map. Mark corrections in the doc."},{"title":"Commit the doc only after that read","detail":"Ask for the file in a second turn so the draft can be fixed first."}],"sourceUrl":"https://code.claude.com/docs/en/overview","sourceNote":"Official documentation URL, checked when this seed was written. The prompt and steps are an original AI Playbook Gems playbook, not a quotation of a customer story, and have not been re-run.","date":"2026-10-02","verified":false,"status":"unverified","sponsorUrl":"","metrics":[{"label":"Hands-on time","value":"20 minutes of fact-checking"},{"label":"You still approve","value":"Publishing the map as truth"},{"label":"Cost bucket","value":"Low"}],"faq":[{"question":"Has this Claude Code playbook been re-run for the catalog?","answer":"No. Status is unverified. Paste the prompt, keep the version that worked, and do not treat the time or cost lines as measurements."},{"question":"Can a product manager run this?","answer":"Yes, if someone technical checks the script names and the golden path. The playbook is a reading aid, not a permission to deploy."}],"url":"https://aiplaybookgems.com/usecases/claude-code-repo-map","jsonUrl":"https://aiplaybookgems.com/api/usecases/claude-code-repo-map"}