dev-cycle

Dev Cycle

전체 개발 사이클을 단계별로 진행합니다.

입력

$ARGUMENTS

자동 진행 모드

작업 시작 전 echo $CLAUDE_CODE_SKIP_PERMISSIONS를 실행하여 값을 확인하세요.

• 값이 1이면 bypass permissions 모드로, 각 단계의 사용자 확인을 자동 승인하고 즉시 다음 단계로 진행하세요.
• 값이 비어있거나 0이면 기존 방식대로 각 단계마다 사용자 확인을 받으세요.

진행 방식

각 단계 완료 후 반드시 사용자 확인을 받고 다음 단계로 넘어가세요. (bypass permissions 모드 제외) 사용자가 수정을 요청하면 해당 단계를 다시 수행하세요.

---

STEP 1 — Plan

$ARGUMENTS에서 작업 설명 부분을 추출하여 planner 스킬과 동일한 방식으로 계획을 수립하세요:

1. 프로젝트 구조와 관련 코드를 탐색하세요.
2. git rev-parse --show-toplevel 명령으로 프로젝트 루트 경로를 확인하세요.
3. docs/PLAN.md를 프로젝트 루트에 작성하세요. (docs/ 폴더가 없으면 생성하세요.)
4. 계획을 대화에 출력하세요.
5. bypass permissions 모드가 아닌 경우 사용자에게 확인을 요청하세요. bypass permissions 모드인 경우 확인 없이 바로 STEP 2로 진행하세요:

📋 계획이 작성되었습니다. docs/PLAN.md를 확인해주세요.
수정이 필요하면 알려주세요. 진행할까요? (y/수정 요청)

---

STEP 2 — Code

bypass permissions 모드가 아닌 경우 사용자 승인 후 진행하세요. bypass permissions 모드인 경우 승인 없이 즉시 진행하세요.

1. kotlin-expert sub-agent에게 작업을 위임하세요.
2. sub-agent가 완료되면 작업 요약을 대화에 출력하세요.
3. bypass permissions 모드가 아닌 경우 사용자에게 확인을 요청하세요. bypass permissions 모드인 경우 확인 없이 바로 STEP 3로 진행하세요:

💻 코딩이 완료되었습니다.
수정이 필요하면 알려주세요. 리뷰를 진행할까요? (y/수정 요청)

---

STEP 3 — Review

bypass permissions 모드가 아닌 경우 사용자 승인 후 진행하세요. bypass permissions 모드인 경우 승인 없이 즉시 진행하세요.

1. code-reviewer sub-agent에게 리뷰를 위임하세요.
2. 리뷰 결과를 대화에 출력하세요.
3. Critical 항목이 있으면:
   • 수정이 필요한 항목을 목록으로 보여주세요.
   • kotlin-expert sub-agent에게 수정을 위임하세요.
   • 수정 완료 후 재리뷰하세요.
4. Critical 항목이 없으면 bypass permissions 모드가 아닌 경우 사용자에게 확인을 요청하세요. bypass permissions 모드인 경우 확인 없이 바로 STEP 4로 진행하세요:

✅ 리뷰가 완료되었습니다.
커밋을 진행할까요? (y/수정 요청)

---

STEP 4 — Commit

bypass permissions 모드가 아닌 경우 사용자 승인 후 진행하세요. bypass permissions 모드인 경우 승인 없이 즉시 진행하세요.

1. git branch --show-current로 브랜치명에서 이슈 번호를 추출하세요.
   • 브랜치명 패턴 예: feature/#130/enhancement, fix/#31/crash-on-rotate
   • # 뒤의 숫자를 이슈 번호로 사용합니다. 찾지 못하면 사용자에게 입력받으세요.
2. git diff HEAD로 변경사항을 분석하여 적절한 type을 선택하세요.
3. 아래 형식으로 커밋 메시지를 작성하세요:

issue #<이슈번호> <type> : <메시지>

type 종류: feat, fix, refactor, chore, test, docs, style, perf

5. bypass permissions 모드가 아닌 경우 커밋 메시지를 대화에 출력하고 사용자 확인을 받으세요. bypass permissions 모드인 경우 확인 없이 바로 커밋하세요:

📝 커밋 메시지:
---
[작성된 메시지]
---
이대로 커밋할까요? (y/수정 요청)

6. 승인되면 (또는 bypass permissions 모드이면) git add와 git commit을 실행하세요.

---

완료

커밋 완료 후 전체 사이클 요약을 출력하세요:

🎉 개발 사이클 완료!

- 📋 계획: docs/PLAN.md
- 📝 결정 기록: docs/decisions/DECISIONS.md (생성된 경우)
- ✅ 커밋: [커밋 해시]