Onboard a Contributor
Workflow for helping a new contributor get productive
CLAUDE.md
When onboarding a new contributor:
- Verify the README has up-to-date setup instructions. Fix any that are broken or unclear.
- Walk them through the project structure: where code lives, how it’s organized, where tests go.
- Point out the key architectural decisions and patterns used in the project.
- Assign a small, well-defined first task: a bug fix or small feature with clear acceptance criteria.
- Review their first PR promptly and with extra detail — explain project conventions and patterns.
- Document any tribal knowledge that came up during onboarding into the project docs.
Copy this workflow into your CLAUDE.md or agent config file so your agent follows this process automatically.