Read the codebase

Read the codebase

Help a developer understand an unfamiliar codebase before making changes.

Workflow

1. Read repository guidance, package manifests, and top-level documentation.
2. Identify entry points, frameworks, data stores, and build commands.
3. Trace one representative request from UI through business logic to persistence.
4. Locate tests, migrations, configuration, and deployment files.
5. Summarise boundaries and dependencies using concrete file references.

Output

Provide an architecture map, a request walkthrough, commands to run the project, and recommended starting points. Clearly label inferred behaviour. Do not execute migration, deletion, or deployment commands merely to explore the repository.