planlisted

# 구현 계획 수립 ## 사용법 ``` /plan [기능 설명] /plan 사용자 인증 시스템 구현 /plan Redis 캐싱 레이어 추가 ``` ## 프로세스 1. **요구사항 분석** - 핵심 목표 정의 - 제약 조건 파악 - 성공 기준 설정 2. **현황 분석** - 기존 코드/아키텍처 확인 - 재사용 가능한 컴포넌트 식별 - 영향 범위 파악 3. **작업 분해** - 독립적으로 완료 가능한 단위로 분해 - 의존성 관계 명시 4. **실행 계획** - 작업 순서 결정 - 검증 포인트 정의 ## 작업 분해 기준 ### 대상 실행자 AI 에이전트 또는 엔지니어가 도구로 맥락을 조회하며 실행 가능해야 함 ### Deliverables 중심 각 작업은 "무엇을 달성하는가"를 명확히 정의: - 달성 목표: 이 작업이 완료되면 무엇이 가능한가 - 검증 방법: 완료를 증명하는 명령어 또는 기준 - 구현 방향: 방향만 제시 (세부 구현은 실행자 재량) ``` 각 작업에 포함할 내용: [ ] 달성 목표 (구체적 결과물) [ ] 검증 방법 (테스트 명령어, 예상 결과) [ ] 의존성 (선행 작업 번호) [ ] 구현 방향 (확실한 파일 경로만 명시, 불확실하면 "탐색 후 결정") ``` ### 주의: 과도한 사전 명세 금지 - 확실하지 않은 파일 경로를 확정하지 않음 - 구현 디테일을 계획 단계에서 확정하지 않음 (에러 계단식 전파 위험) - "무엇을(what)" 구체적으로, "어떻게(how)" 방향만 ## 열린 질문 종결 계약 (수렴 계약) 계획 중 발생한 모든 열린 질문은 아래 4가지 중 하나로 **반드시 종결**한다. 이외 상태("나중에 보자", 암묵적 방치)로 남기지 않는다. | 종결 유형 | 의미 | 기록 | |----------|------|------| | ① 사용자 제공 사실 | 사용자가 직접 답함 | 답변 내용 | | ② 레포 확인 사실 | 코드/문서에서 직접 확인 | 근거 경로 | | ③ 안전한 가정 | 로컬·가역·무해한 기본값 채택 | 가정임을 표기 + 근거 | | ④ 명시적 블로커 | 사용자만 결정 가능 (권한/선택/자격증명) | 필요한 결정 내용 | plan.md에는 "미해결 질문" 표(질문 / 종결 유형 / 근거)를 필수 포함한다. **④가 남아 있으면 구현 단계로 진행하지 않는다** — 사용자 질의가 다음 액션이다. ### 저장 위치 (선택) 복잡한 계획은 문서로 저장: ``` docs/plans/YYYY-MM-DD-<기능명>.md ``` ## 출력 예시 ``` ## 계획: 사용자 인증 시스템 ### 목표 - JWT 기반 인증 시스템 구현 ### 제약 조건 - 기존 세션 방식과 병행 운영 필요 - 토큰 만료 시간 1시간 ### 작업 목록 | # | 달성 목표 | 의존성 | 검증 | |---|----------|--------|------| | 1 | JWT sign/verify 가능 | - | 단위 테스트 통과 | | 2 |