Using AI to increase codebase understanding

AI is getting increasingly good at understanding codebases now thanks to large context windows. Here are my suggestions:

1. Do you have MAX mode enabled? this is crucial for large codebases because it uses large context windows. but is more expensive
2. use reasoning models. This is a must. (gemini 2.5 pro, claude thinking, chatGPT o3). I prefer o3 the most
3. Use agent mode. This lets the model recursively investigate by running queries, looking at the outputs, and running more queries
4. Keep resetting the chat. You're better of doing a hard restart instead of keeping on correcting cursor for the 10th time. If it doesnt work once, improve your prompt and do a hard restart
5. Context is incredibly important. Make sure to spend enough time doing a clear write up on what you know, what you need. What the bug is. What the ideal state should be. Make sure to use @PullRequest to tag the correct branch/PR that did not have the bug. The model cannot read minds and talk to it like its your coworker. I like to use chatGPT's voice dictate mode and brain dump everything in a 5 minute yap session. Itconverts my yap to text. I edit it and then add in any examples that cant be dictated
6. Before you code, you need to spend enough time priming the chat window with enough context about the problem and codebase. Almost like generating a PRD
7. Use @Web to let cursor search docs
8. I'm also fundamentally shifting how I generate docs. I try to make ensure docs I write are searchable by LLMs by making sure if something important is in an image, theres keywords to ensure it can be searched by text

https://docs.cursor.com/context/@-symbols/@-git

https://docs.cursor.com/guides/working-with-context (this is gold)

https://x.com/gdb/status/1878489681702310392 (how to write a prompt)