계획 수립은(는) 무엇을 하나요?
목표
사용자 프롬프트를 최종 어시스턴트 메시지에서 전달되는 단일 실행 가능한 계획으로 전환합니다.
최소 워크플로우
전체 워크플로우 동안 읽기 전용 모드로 작동합니다. 파일을 쓰거나 업데이트하지 마세요.
-
컨텍스트를 빠르게 스캔
README.md및 명백한 문서(docs/,CONTRIBUTING.md,ARCHITECTURE.md)를 읽습니다.- 관련 파일(가장 수정될 가능성이 높은 파일)을 훑어봅니다.
- 제약 조건(언어, 프레임워크, CI/테스트 명령어, 배포 형태)을 식별합니다.
-
차단되는 경우에만 후속 질문
- 최대 1-2개의 질문만 합니다.
- 책임감 있게 계획을 세울 수 없을 때만 질문하며, 객관식 형태를 선호합니다.
- 확실하지 않지만 차단되지 않는 경우, 합리적인 가정을 하고 진행합니다.
-
아래 템플릿을 사용하여 계획 수립
- 의도와 접근 방식을 설명하는 1개의 짧은 문단으로 시작합니다.
- 범위 내(In scope) 와 범위 외(Out scope) 를 간략히 명확히 표시합니다.
- 그런 다음 작은 체크리스트(기본 6-10개 항목)를 제공합니다.
- 각 체크리스트 항목은 구체적인 작업이어야 하며, 도움이 될 때 파일/명령어를 언급합니다.
- 항목을 원자적이고 순서대로 만듭니다: 발견 → 변경 → 테스트 → 배포.
- 동사 우선: "추가...", "리팩터...", "확인...", "배포...".
- 해당되는 경우 테스트/검증 항목과 에지 케이스/위험 항목을 각각 하나 이상 포함합니다.
- 알려지지 않은 사항이 있는 경우 작은 열린 질문 섹션(최대 3개)을 포함합니다.
-
계획 앞에 메타 설명을 두지 마세요. 템플릿에 따라 계획만 출력하세요.
계획 템플릿 (정확히 따르세요)
# 계획
<1-3 문장: 무엇을, 왜, 그리고 높은 수준의 접근 방식을 설명합니다.>
## 범위
- 범위 내:
- 범위 외:
## 실행 항목
[ ] <1단계>
[ ] <2단계>
[ ] <3단계>
[ ] <4단계>
[ ] <5단계>
[ ] <6단계>
## 열린 질문
- <질문 1>
- <질문 2>
- <질문 3>
체크리스트 항목 가이드
좋은 체크리스트 항목:
- 파일/모듈을 가리킵니다: src/..., app/..., services/...
- 구체적인 검증을 명명합니다: "npm test 실행", "X에 대한 단위 테스트 추가"
- 해당되는 경우 안전한 배포를 포함합니다: 기능 플래그, 마이그레이션 계획, 롤백 노트
피해야 할 것:
- 모호한 단계 ("백엔드 처리", "인증 구현")
- 너무 많은 마이크로 단계
- 코드 스니펫 작성 (계획을 구현에 독립적으로 유지)