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 정리 템플릿

## Context Summary
**도메인**: [safety/health/environment/management/etc]
**작업 유형**: [Bugfix/Feature/Enhancement]
**핵심 기능**: [비즈니스 로직 간단 설명]

**Page & Component 매핑**:
- 페이지: [src/app/[locale]/(route)/...경로]
- 주요 컴포넌트: [domains/[domain]/components/...]
- 재사용 컴포넌트: [components/common/... Ehsms components/complex/...]

**상태 관리**:
- Local State: [useState 사용 부분]
- Global States: [domains/[domain]/store/...]
- Server State: [domains/[domain]/service/...]

**동작 프로세스**:
1. [사용자 액션 1] → [Event Handler] → [API 호출/State 변경]
2. [사용자 액션 2] → [Event Handler] → [결과 처리]
3. [완료/에러 처리]

**데이터 구조**: 
- Request: [API 요청 스키마]
- Response: [API 응답 스키마]
- Types: [domains/[domain]/types/... 또는 types/...]

**준비 상태**: [✅ 구현 가능 / ❌ 더 조사 필요]
**미해결 이슈**: [있다면 나열]

다음 단계 진행 조건

Planning 단계 완료 후

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

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

Planning 핵심 원칙

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

산출물: 명확한 구현 계획

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

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