Use when: 기능 구현 계획, 구현 전 설계, 스코프 정의, 작업 분해, 3개 이상 파일 변경, 기능 추가, feature planning, 구현 어떻게 할까, 큰 작업, 복잡한 기능, 어디부터 시작, 작업 순서. NOT for: 단순 버그 수정, 1-2 파일 변경, 오타 수정.
Install
npx skillscat add nomik94/claude-code-preset/feature-planner Install via the SkillsCat registry.
SKILL.md
기능 플래너
코드 작성 전 기능을 설계합니다. 기능이 3개 이상의 파일에 영향을 주거나 아키텍처 결정이 필요할 때 실행됩니다.
1단계: 요구사항 명확화
시작하기 전에 아래 네 가지 질문에 답하세요:
- 무엇: 기능에 대한 한 문장 설명
- 범위 밖: 이 기능이 하지 않는 것을 명시적으로 나열
- 완료 기준: "완료"에 대한 구체적이고 테스트 가능한 조건
- 제약 조건: 기술 스택 제한, 성능 요구사항, 데드라인
어떤 질문에도 답할 수 없다면, 진행하기 전에 사용자에게 확인하세요.
2단계: 기존 코드 분석
설계 전에 코드베이스를 조사하세요:
- 관련 코드: 이 기능이 영향을 주는 기존 모듈, 서비스, 모델 찾기
- 패턴: 이미 사용 중인 컨벤션 파악 (네이밍, 에러 핸들링, 응답 형식)
- 재사용 vs 신규: 확장할 수 있는 것과 새로 만들어야 하는 것 결정
- 영향 범위: 읽기, 수정, 생성될 모든 파일 나열
3단계: 구현 계획
순서가 있는 작업 목록을 작성하세요:
- 각 작업에 순번 부여
- 병렬 실행 가능한 작업과 순차 실행해야 하는 작업 표시
- 각 작업별: 영향받는 파일, 예상 복잡도 (S/M/L)
- 위험 요소 표시: 마이그레이션, 공유 유틸리티, 핵심 추상화
- 10개 이상 파일에 영향을 주면, 독립 배포 가능한 단계로 분할
4단계: 범위 확정
구현을 시작하기 전에:
- 범위 내와 범위 밖 목록을 명시적으로 출력
- 사용자 확인 받기: "이 계획은 X를 포함합니다. 진행할까요?"
- 범위가 확정될 때까지 코딩을 시작하지 않음
규칙
- 과잉 구현 금지: 요청받은 것만 빌드, 그 이상은 금지
- MVP 경로 우선: 가장 단순한 작동 버전 먼저, 이후 반복
- 불확실한 점은 즉시 표면화: 불명확하면 멈추고 질문
- 10개 이상 파일 변경 = 단계별 접근 필수
- 각 단계는 독립적으로 테스트 및 배포 가능해야 함
출력 형식
## Feature: [name]
### Requirements
- What: ...
- NOT in scope: ...
- Acceptance criteria: ...
- Constraints: ...
### Affected Code
| File | Action | Complexity |
|------|--------|------------|
| path/to/file.py | modify | S |
### Implementation Plan
| # | Task | Files | Parallel | Risk |
|---|------|-------|----------|------|
| 1 | ... | ... | no | low |
### Scope Lock
- IN: ...
- OUT: ...