Dev Cycle Orchestrator은(는) 무엇을 하나요?
전체 개발 수명주기를 오케스트레이션합니다: 브레인스토밍 → 계획 → 검토 → 이슈 → 구현 → 코드 리뷰 → PR.
명확화: 사용자가 PRD만 원한다면 /write-a-prd로 라우팅하세요. 계획만 원한다면 /prd-to-plan으로 라우팅하세요. 이 스킬은 전체 종단간 수명주기를 위한 것입니다.
7단계 파이프라인
모든 단계는 필수입니다. 어떤 단계도 건너뛸 수 없습니다.
| # | 단계 | 위임 대상 | 게이트 조건 |
|---|---|---|---|
| 1 | 브레인스토밍 | write-a-prd | 이슈 URL 기록 |
| 2 | 계획 | prd-to-plan | docs/plans/에 계획 파일 존재 |
| 3 | CEO 검토 | plan-ceo-review (HOLD SCOPE 권장) | 검토 완료, 사용자 승인 |
| 4 | 이슈 | 오케스트레이터 (계획 슬라이스 → GitHub 이슈) | 모든 이슈 URL 기록 |
| 5 | 구현 | 오케스트레이터 (tdd per issue, subagent-development) | 모든 이슈 해결, 테스트 통과 |
| 6 | 코드 리뷰 | daa-code-review | 깨끗한 리뷰 |
| 7 | PR | commit + github-cli | PR URL 기록 |
재진입 로직
매 호출 시:
인수 없음 (/dev-cycle)
docs/dev-cycle/에서status: in_progress인*.state.md파일 스캔- 하나 발견 → 질문: "{feature} (
{branch})를 재개할까요? 현재 **{phase}**에 있습니다." - 여러 개 발견 → 브랜치 이름과 함께 목록 표시, 재개할 항목 질문
- 없음 → 질문: "어떤 기능을 작업 중이신가요?" → 1단계 시작
인수 포함 (/dev-cycle {slug})
docs/dev-cycle/{slug}.state.md찾기- 발견 →
current_phase에서 재개 - 없음 → 상태 파일 생성, 1단계 시작
슬러그 충돌
새 상태 파일을 생성할 때 docs/dev-cycle/에서 기존 슬러그를 확인합니다. 슬러그가 이미 존재하면(중단 또는 완료) -2, -3 등을 접미사로 붙입니다.
재개 시 컨텍스트 로딩
계속 진행하기 전에 모든 참조 아티팩트를 로드합니다:
- 브레인스토밍:
gh issue view로 PRD 이슈 확인 - 계획: 디스크에서 계획 파일 읽기
- CEO 검토: 계획 파일 읽기 (검토 수정 포함)
- 이슈: 각 구현 이슈에 대해
gh issue view실행 - 구현: 기능 브랜치에서 git 상태 확인, 종료된 이슈 검토
요약 제시: "**{feature}**을(를) **{phase}**에서 재개합니다. 중단된 지점은 다음과 같습니다: ..."
단계 실행
1단계: 브레인스토밍
write-a-prd 호출. 스킬의 내부 흐름(인터뷰 → PRD → GitHub 이슈)을 신뢰합니다. 상태 파일에 이슈 URL을 기록합니다.
2단계: 계획
PRD 이슈 URL을 prd-to-plan에 전달합니다. 계획 파일 경로(docs/plans/{feature}.md)를 기록합니다.
3단계: CEO 검토
계획 파일 경로를 plan-ceo-review에 전달합니다. HOLD SCOPE 모드를 권장하지만 스킬 자체의 모드 선택(Step 0F)이 실행되도록 둡니다. 검토가 완료되고 사용자가 승인하면 기록합니다.
4단계: 이슈
오케스트레이터 소유. 계획의 수직 슬라이스를 읽습니다. 각 슬라이스에 대해 gh issue create를 사용하여 GitHub 이슈를 생성합니다. 생성할 때:
- PRD 이슈 참조
- 계획의 수락 기준 포함
- 의존성 순서로 생성
생성 직후 각 이슈 URL을 이슈 테이블에 기록합니다. 부분 완료 복구에 대해서는 references/phase-transitions.md를 참조하세요.
5단계: 구현
오케스트레이터 소유. feat/{feature-slug} 기능 브랜치 생성 (브랜치 처리에 대해서는 references/phase-transitions.md 참조).
subagent-development 방법론에 따라 GitHub 이슈당 하나의 하위 에이전트를 디스패치합니다:
- 각 하위 에이전트는
tdd스킬을 호출 - 각 하위 에이전트 디스패치 사이에 코드 리뷰 실행
- 각 하위 에이전트 완료 후 상태 파일 업데이트 (배치 처리 안 함)
하위 에이전트별 이벤트 로그:
"Subagent started for issue #N: {title}""Subagent completed for issue #N: {pass/fail}""Code review after issue #N: {clean/blocking issues found}"
6단계: 코드 리뷰
기능 브랜치의 모든 변경 파일에 대해 daa-code-review를 호출합니다. 차단 이슈가 발견되면 → 수정, 재실행. 깨끗해질 때까지 반복합니다.
계획 재작업이 필요한 아키텍처 이슈 발생 시 → 2단계로 역방향 전환.
7단계: PR
먼저 기본 브랜치와의 충돌 여부 확인. commit을 호출하여 관례적인 커밋 수행, 그런 다음 github-cli를 호출하여 PR 열기. PR URL 기록, status: completed로 설정. 그런 다음 아카이빙 단계 실행 (아래 아카이브 참조).
상태 파일
각 기능은 docs/dev-cycle/{feature-slug}.state.md에서 추적됩니다. 전체 형식, 필드 정의 및 전환 규칙은 references/state-file-schema.md를 참조하세요.
실패 및 복구
다음에 대한 내용은 references/phase-transitions.md를 참조하세요:
- 단계 재시도 로직 (차단됨 → 다음 호출 시 재시도)
- 역방향 전환 (구현/코드리뷰 → 계획)
- 기능 중단. 아카이브된 파일은
docs/archive/로 이동됩니다.
브랜치 관리
- 1~4단계: 현재 브랜치에서 실행 (문서 전용)
- 5단계:
feat/{feature-slug}브랜치 생성 - 7단계: 기본 브랜치로 PR (
gh repo view --json defaultBranchRef로 감지) - 5단계 이상에서 재개: 아직 기능 브랜치에 있지 않으면 체크아웃
아카이브
기능이 종료 상태(completed 또는 abandoned)에 도달하면 해당 아티팩트를 아카이브합니다:
- 아카이브 디렉토리 생성:
mkdir -p docs/archive/dev-cycle docs/archive/plans - 상태 파일 이동:
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - 계획 파일 이동: 아티팩트 테이블에서 계획 경로를 읽은 후
git mv {plan_path} docs/archive/plans/ - 이동 커밋:
chore(dev-cycle): archive {slug}
아카이브는 자동으로 실행됩니다:
- 7단계 종료 시 (PR URL이 기록되고 상태가
completed로 설정된 후) - 기능 중단 시 (상태가
abandoned로 설정된 후)