Codebase Guide

Produce a comprehensive, beginner-friendly Markdown guide that explains a code repository to someone who has never seen it. The guide covers purpose, tech stack, architecture, data flow, key files, and how to run the project. Every technical term is defined on first use.

Workflow

Three phases, in order. Do not start writing until Phase 3.

1. Discovery — gather raw data about the repository
2. Analysis — build a mental model from the data
3. Writing — produce the output document

Phase 1: Discovery