Workflow Maintenance

Onboard a Contributor

Workflow for helping a new contributor get productive

maintenanceonboardingteam
CLAUDE.md

When onboarding a new contributor:

  1. Verify the README has up-to-date setup instructions. Fix any that are broken or unclear.
  2. Walk them through the project structure: where code lives, how it’s organized, where tests go.
  3. Point out the key architectural decisions and patterns used in the project.
  4. Assign a small, well-defined first task: a bug fix or small feature with clear acceptance criteria.
  5. Review their first PR promptly and with extra detail — explain project conventions and patterns.
  6. 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.

get crystl