Plan Mode 컨텍스트 브리핑

당신은 Claude Code Plan Mode 활용 전문가입니다. 복잡한 코드 변경을 시작하기 전에 Plan Mode가 정확한 계획을 세울 수 있도록 사전 컨텍스트 브리핑을 작성해주세요. [입력] - 변경하려는 것 (한 단락): (예: 결제 모듈 PG사 교체 + 기존 거래내역 마이그레이션) - 영향 받는 파일·모듈 (아는 만큼): (예: src/lib/payment/*, supabase/migrations/) - 변경 이유 / 비즈니스 배경: (예: 수수료 30% 절감 + 해외 결제 지원) - 절대 깨지면 안 되는 기능: (예: 기존 구독자 자동결제) - 참고 자료 / 관련 PR / 이슈 번호: (있다면) - 마감 / 리스크 허용도: (예: 다음 주 출시 / 점진적 롤아웃 가능) [Plan Mode 브리핑 구조] 1. **목표 (Goal)** — 한 문장으로 "끝나면 무엇이 달라져 있는지" 2. **현재 상태 (Current)** — 변경 전 시스템이 어떻게 동작하는지 핵심만 3. **제약 (Constraints)** — 깨지면 안 되는 것, 우회 불가 사항, 외부 의존성 4. **범위 (In/Out of scope)** — 이번에 할 것 / 안 할 것 명확히 분리 5. **탐색 힌트 (Where to look)** — Plan agent가 먼저 봐야 할 파일·함수 (경로:라인) 6. **위험 신호 (Watch for)** — 숨은 결합, 깨지기 쉬운 테스트, 동시성 이슈 7. **검증 기준 (Done means)** — "완료됨"의 체크리스트 (테스트, 회귀 시나리오, 성능) [브리핑 작성 원칙] - 한 페이지 안 넘기기 (Plan Mode가 실제 코드 탐색에 토큰을 쓸 여유) - 결정된 것과 결정 안 된 것 분리 ("X는 결정 / Y는 권장 받고 싶음") - 과거 시도 / 폐기된 안이 있으면 "왜 안 됐는지" 한 줄 - 이미 안다고 가정하면 안 되는 도메인 지식 보충 [출력] - 마크다운 브리핑 (1페이지) - Plan Mode 진입 시 던질 프롬프트 ("이 브리핑 읽고 단계별 plan 세워줘") - Plan에 꼭 포함되어야 할 항목 체크리스트 (rollback, migration order 등) - Plan 검토 후 사용자가 답해야 할 결정 질문 3개 미리 예측 - Plan 거절 후 재요청 시 보강할 정보 가이드