Claude Code 병렬 session: 격리와 handoff

병렬 작업은 독립 task에만 맞습니다. 두 변경이 같은 file을 필요로 하면 한 owner를 정하고 순차 처리합니다. 별도 API workflow에서는 BetterToken Claude Code 가이드로 자신의 API Key를 설정할 수 있지만 Claude.ai subscription이나 shared account가 아닙니다.

task와 file 매핑

task	허용 범위	완료 조건
빈 amount	parser/, tests/import/	validation error 반환
--dry-run	cmd/, tests/cli/	plan 표시, data 미작성

공유 file은 병렬 실행을 멈추라는 신호입니다.

worktree 격리

git status --short
git worktree add ../project-fix-empty-amount -b fix/empty-amount
git worktree add ../project-cli-dry-run -b feat/cli-dry-run

모르는 변경을 숨기거나 버리지 마세요. worktree는 files/branches, session은 context를 나누지만 conflict를 해결하지 않습니다.

prompt 경계 설정

허용 directory, 금지 사항, test를 적습니다. 공유 parser/schema.ts가 필요하면 조용히 수정하지 말고 blocker로 멈춥니다.

handoff 계약

Task: empty amount returns validation error
Worktree / branch: ../project-fix-empty-amount / fix/empty-amount
Changed: parser/amount.ts, tests/import/empty-amount.test.ts
Verified: npm test -- tests/import/empty-amount.test.ts
Not verified: full integration suite
Next: review diff before merge

대화가 아니라 state와 재현 command를 전달합니다.

검증과 rollback

git status --short
git diff --check
npm test -- tests/import/empty-amount.test.ts

받는 session은 worktree에 들어가 command를 반복합니다. 재현되지 않으면 미검증이므로 변경을 되돌리거나 owner에게 돌려줍니다.

Git, 권한, secret

overlap은 owner가 두 diff를 읽어 한 branch에 통합하고 두 test를 실행합니다. 범위 밖의 broad permission을 주지 마세요. API Key, cookie, .env, 개인 data, 전체 sensitive log를 handoff나 commit에 넣지 않습니다.

CTA와 sources

현재 가이드로 자신의 Key만 설정하고 secret은 정상 secret mechanism으로 전달하세요.

• Claude Code documentation
• Git worktree documentation