정의
CLAUDE.md as Contributor Onboarding Infrastructure는 CLAUDE.md와 유사한 repository instruction 파일을 단순한 agent prompt가 아니라 신규 contributor와 AI agent가 codebase에 진입하는 onboarding layer로 보는 관점이다.
AI 시대의 contributor는 반드시 기존 engineer만이 아니다. 새 engineer, designer, non-engineer, background agent 모두가 codebase에 들어올 수 있다. 이때 code reviewer가 “그 framework를 쓰면 안 된다”거나 “우리 architecture pattern과 맞지 않는다”고 뒤늦게 reject한다면, 그 지식은 아직 인프라화되지 않은 것이다.
핵심 속성
- zero additional context: prompter가 매번 설명하지 않아도 agent가 시작할 수 있다.
- review-before-review: 반복 review 기준을 agent가 작업 전부터 알게 한다.
- architecture affordance: codebase가 어떤 변경을 허용하고 어떤 변경을 금지하는지 명시한다.
- non-engineer enablement: designer나 PM이 agent를 통해 기여할 때도 팀의 기술 규칙을 따르게 한다.
- living document: review comment와 실패 사례가 생길 때마다 instruction이 갱신된다.
포함해야 할 정보
- setup/build/test command
- architectural boundaries
- preferred frameworks and forbidden alternatives
- naming conventions
- review checklist
- known pitfalls
- security/privacy constraints
- examples of accepted patterns