Prompt file imported from jam0ng/nodecalc (
.claude/commands/plan.md). Fill in{{arguments}}before use. Copyright stays with the author.
cat > .claude/commands/plan.md << 'EOF'
description: 새 기능 작업 전 3종 문서 작성 (계획서·맥락노트·체크리스트)
기능 계획 수립
작업할 기능: {{arguments}}
다음 순서로 진행하세요:
1. 현재 코드베이스 빠르게 훑기
Glob/Grep으로 관련 파일·구조를 파악하세요.
2. dev/active/{{arguments}}/ 폴더에 3개 파일 작성
파일 1: dev/active/{{arguments}}/plan.md (계획서)
무엇을 만들 것인가 — 건축의 설계도
# {{arguments}} — 계획서
## 목표
이 기능이 왜 필요한가, 어떤 사용자 흐름을 만드는가
## 범위
- 포함: 이번 작업에 들어가는 것
- 제외: 이번 작업에 안 들어가는 것 (다음으로 미루는 것)
## 변경할 파일
- 새로 만들 파일: ...
- 수정할 파일: ...
## 외부 의존성
- 새로 추가할 라이브러리: ...
- 환경 변수: ...
파일 2: dev/active/{{arguments}}/context.md (맥락 노트)
왜 이렇게 결정했는가 — 건축의 시방서
# {{arguments}} — 맥락 노트
## 핵심 결정과 이유
- 왜 이 방식을 선택했나
- 고려했던 대안과 기각 사유
## 관련 자료 위치
- 참고한 기존 코드: ...
- 참고한 외부 문서/링크: ...
- 관련된 이전 결정: dev/decisions/...
## 가정·제약
- 이 작업이 의존하는 가정 (이게 깨지면 재검토)
- 제약 사항 (시간·기술·도메인)
## 주의할 함정
- 이 작업하면서 빠질 수 있는 함정
파일 3: dev/active/{{arguments}}/checklist.md (체크리스트)
뭘 끝냈고 뭐가 남았나 — 건축의 공정표
# {{arguments}} — 체크리스트
## 단계별 작업
- [ ] 1. ...
- [ ] 2. ...
- [ ] 3. ...
## 확인 방법
- [ ] 어떻게 동작 확인하는가 (수동 테스트 시나리오)
- [ ] 자동 테스트 작성 여부
## 완료 조건
- [ ] 이 작업이 "끝났다"고 부를 수 있는 기준
3. 작성 완료 후 멈추세요
사용자가 3개 파일을 검토하고 OK 하면 그때 구현 시작. 검토 전에 코드를 작성하지 마세요.
4. 구현 중에는 checklist.md의 체크박스만 업데이트
- 작업 완료하면 [x]로 변경
- 계획이 바뀌면 plan.md/context.md도 함께 업데이트
- 새로운 가정·결정이 생기면 context.md에 추가
5. 작업 완료 시
- 모든 체크박스 [x] 확인
- 폴더를 dev/active/{{arguments}}/ → dev/done/{{arguments}}/ 로 이동 EOF
echo "✅ /plan 커맨드 3종 문서 버전으로 업데이트됨"
