Planning Phase

Context

Context-driven development의 1단계: 구현 전 필요한 정보 수집 및 검증

적용 조건: 004-she-context-driven-development의 Phase 1 상태일 때

핵심 원칙

Context 우선 순위 (Top-down 방식)

큰 그림에서 세부 사항으로 진행

  1. 필수 (Must): 요구사항, 페이지/컴포넌트 매핑, 데이터 구조

  2. 중요 (Should): 상태 관리, 동작 프로세스

  3. 선택 (Could): UI 세부사항, 최적화

Context 수집 체크리스트

1. 요구사항 검토

  • [ ] 작업 유형 파악 (Bugfix / Feature / Enhancement)

  • [ ] 도메인 지식 및 비즈니스 로직 이해

  • [ ] 영향도 및 우선순위 파악

  • [ ] 기술적/비기능적 요구사항 확인

  • [ ] 참고하면 좋은 Page/Component 요청 (요구사항과 유사한 기능 혹은 프로세스가 있을 경우)

2. Page & Component 매핑

  • [ ] 영향받는 URL/Route 확인 (Next.js의 경우 Url을 보고 Page를 찾을 수 있음, 없을 경우 component 확인 요청)

  • [ ] 관련 Component 계층 구조 파악

  • [ ] Component 간 의존성 분석

  • [ ] 재사용 가능한 Component 확인

  • [ ] 실제 개선 필요한 Component 확인

3. 상태 관리 분석

  • [ ] Local State (useState) 파악

  • [ ] Global State (Store) 연결 확인

  • [ ] Server State (API 상태) 확인

  • [ ] State 변경에 따른 Side Effect 파악

4. 동작 프로세스 구체화

  • [ ] User Interaction Flow 정의

  • [ ] Event Handler 시퀸스 정리

  • [ ] API 호출 순서 및 조건 확인

  • [ ] Error/Loading 상태 처리 계획

5. 데이터 구조 확인

  • [ ] Request/Response Schema 확인

  • [ ] Data Type 및 Interface 정의 필요사항

  • [ ] Validation Rule 확인

  • [ ] 표준 타입 존재 여부 확인

구현 준비 완료 기준

Context가 완료되지 않으면 계속 진행

진행 가능

  • 필수 항목(1,2,5) 100% 완료

  • 중요 항목 (3,4) 80% 이상 완료

  • 모든 Edge Case 식별 완료

  • 명확한 구현 계획 수립

더 조사 필요

  • 필수 항목 미완료

  • 핵심 로직 불명확

  • 기술적 의존성 미파악

  • 사용자 요구사항 모호

Context 정리 템플릿

다음 단계 진행 조건

Planning 단계 완료 후

  • ✅ 구현 가능 상태 → 명시적 트리거 → 004 오케스트레이션이 1002-she-context-act.mdc 호출

  • ❌ 더 조사 필요 → 부족한 Context 추가 수집 후 재평가

Planning 핵심 원칙

목적: 전체 그림 이해 → 세부사항 파악

산출물: 명확한 구현 계획

체크포인트: 모든 Edge Case 식별

  • Plan 단계는 기획 단계로서 개발자에게 요청하는 개발요청서를 자세하게 쓰는 단계다.

Last updated