03-실전

03. 실전 — 30분 부트스트랩 레시피

새 리포에서 첫 세션을 시작하는 표준 절차. 한 번만 하면 된다.

0~5분: 작업 트리 정렬

• 작업하려는 모노레포 루트 또는 서비스 루트로 cd.
• git status가 깨끗한지 확인 (안 그러면 /init이 untracked 파일을 잘못 해석할 수 있다).

5~10분: /init 1차 실행

> /init

• 결과 CLAUDE.md를 덮어쓰지 말고 별도 패널에서 본다.
• 빌드/테스트 명령이 정확한지, 잘못 추정된 디렉토리 의미가 없는지 검증.

10~20분: 가드레일로 다듬기

초안에서 삭제부터 한다. 다음만 남기는 것을 목표로:

1. 빌드/테스트 명령 (검증 가능, 1~2줄).
2. 금지 행동 (“DB 마이그레이션을 직접 돌리지 말 것” 같은 강한 부정).
3. 디렉토리 의미 (“src/api/ 안만 핸들러, 그 외는 유틸”).
4. 리뷰 게이트 (“PR 만들기 전 npm test와 npm run lint 통과”).

피해야 할 것: 회사 소개, 도메인 용어 사전, 전체 파일 트리 — 이런 건 별도 문서로 두고 @로 멘션한다.

20~25분: 스코프 분리

• 회사 정책(보안/감사) → managed policy 스코프.
• 팀 공유 → ./CLAUDE.md (git).
• 개인 선호 → ~/.claude/CLAUDE.md.
• 샌드박스 URL/테스트 데이터 → ./CLAUDE.local.md (gitignore).

25~30분: 첫 검증 사이클

• 새 세션을 열고 “이 리포에 추가하는 새 API 핸들러는 어디에 두지?” 같은 검증 질문 1개.
• 답이 정확하면 통과. 틀리면 CLAUDE.md의 해당 줄을 더 구체적으로 고친다.
• 통과한 CLAUDE.md를 커밋. 메시지: chore: bootstrap CLAUDE.md.