Convos.dev 004: Tips to onboard to a large codebase
Sep 10, 2025
Practical tips for ramping into a large codebase, including patience, tiny starter tasks, and onboarding buddies. The value of thorough internal docs, contribution guides, and logging friction for future devs. Ways to use AI and voice tools to speed documentation and derive docs from commits. A look at AI observability, cost metrics, and UI components for chat apps.
AI Snips
Chapters
Transcript
Episode notes
Prioritize Patience Over Early Pressure
- Be patient when onboarding and resist proving yourself in the first 48 hours.
- Take days to grok the codebase before making larger changes.
Ship Practical Internal Documentation
- Create clear internal docs that explain structure, tools, and how to run the project.
- Use those docs to help humans and AI understand the codebase faster.
Write Friction Notes For The Next Person
- Record friction points you encounter while onboarding.
- Turn those notes into runbooks so future devs don't repeat the same struggles.