Understand a Codebase – Understand a codebase prompt for ChatGPT and Claude
Free with your account
- Free with an account
- Copy filled in or download
- Updates included
Claude Opus 5.5
This prompt gives you a working map of a codebase you just joined. Paste the file tree, a few key files and your first task; you get a map, one traced flow and where to start.
What you get
- A short summary of what the system does, its stack and its pattern
- A map of the main folders and files with when to open each, guesses marked as guesses
- One request traced from the entry point to the database, the one your task touches
- The files to read and change for your task, plus questions to ask the team
How to use it
- 1Export the file tree
Run tree or git ls-files in the repository, leave out generated folders such as node_modules, and paste the result.
- 2Pick the key files
Add the package file, the entry point, the data model and the files nearest your task, each under its path.
- 3Check the guesses
Open every file marked (from name) or (not shown) before you rely on what the answer says about it, and take its questions to your team.
Better results
- Follow up by pasting the files it tells you to read first, and ask it to correct the flow with what they show.
- Leave out lock files, build output and vendored code. They fill the chat without telling the AI anything about your system.
- Take the questions it lists to the team before you write code; the answers usually decide the design.
Questions
Can ChatGPT read a whole codebase?
ChatGPT reads what you paste or upload, so it can work through a small codebase, but a large repository will not fit in one chat. Paste the file tree and the key files instead, or use a coding agent that reads your repository directly.
Can ChatGPT see my VS Code project?
In a plain chat, ChatGPT sees only what you paste or upload, not your VS Code project. To work with your open files, use an assistant that runs in your editor, such as GitHub Copilot, or a coding agent that works inside your repository.
How do I get up to speed on a new codebase quickly?
Start with one real flow instead of reading files in order: find the entry point, follow one request to the database, then read the files your first task touches. An AI map helps, but open the files it guesses about before you trust them.
Updated 6 Oct 2026
























