learn-codebase
Use for onboarding, milestone review, handoff, or interview preparation—not after every feature.
Process
- Establish learning goals and audience.
- Map the repository deliberately, excluding generated/vendor/build output.
- Identify architecture, modules, domain concepts, major flows, tests, deployment, and durable decisions.
- Generate modular lessons rather than one giant document.
- Include navigable diagrams, demonstrations, exercises, and quizzes.
- Cite source paths and distinguish current behavior from recommendations.
Default Output
learning/codebase/├── index.html├── modules/├── assets/└── README.mdUse self-contained HTML/CSS/JS by default; use an existing docs/MDX system when approved. Do not install a framework solely for the portal without approval.
Modules May Include
orientation, architecture, domain/data flow, UI or interfaces, services/integrations, testing, deployment/operations, security boundaries, extension exercises, and cumulative quiz.