Large Codebase Reading Methodology

A systematic approach to understanding large codebases efficiently: read to modify safely, not to memorize everything.

Core Principle

Goal-oriented reading: Always start with a concrete objective (fix bug, add feature, debug issue, security audit). Without a goal, you'll get lost in details.

Success criteria: You can explain the execution flow and modify code confidently, not that you've read every file.

Documentation Structure

When documenting your understanding, use this structure: