Write a Codebase Onboarding Guide for New Developers with Claude

New developers spend days trying to understand a codebase. Claude can generate a comprehensive onboarding guide by reading the actual code — not stale wiki pages.

Read through the entire project structure and generate an onboarding guide
for a new developer joining the team. Include:
- High-level architecture overview
- Key directories and what they contain
- How data flows from the API to the database
- Important patterns and conventions used
- How to set up the local dev environment
- Common gotchas and things that aren't obvious from the code
Write it as a markdown file called ONBOARDING.md

Claude will crawl the project, read key files like config, routes, models, and middleware, and produce a document that actually reflects the current state of the codebase.

You can make it more targeted for specific roles:

Write an onboarding guide for a frontend developer joining this project.
Focus on the component architecture, state management approach,
API integration patterns, and the styling conventions.
Include how to run the frontend locally and how to add a new page.

Run this periodically or as a CI step to keep the guide fresh:

claude --print "Read the codebase and update ONBOARDING.md with any changes since the last version. Preserve the existing structure." > ONBOARDING.md

The best onboarding doc is one generated from the code itself — not someone's memory of how things used to work.