BF Execute (Entry Point)

Overview

BF 워크플로우의 실행 진입점이자 사람-시스템 경계 허브이다. bf-lead-orchestrate를 모드별로 스폰하여 에픽 단위 루프를 돌며, 각 에픽 완료 후 사람에게 결과를 제시한다. 시스템 내부 에이전트는 사람과 직접 소통하지 않으며, bf-execute가 유일한 소통 경계이다.

When to Use

• 사용자가 /bf-execute를 입력했을 때
• /bf-spec으로 Tech Spec이 승인된 후 다음 단계로 진행할 때

Prerequisites

• 승인된 Tech Spec: docs/tech-specs/{TICKET}-tech-spec.md
• Tech Spec 리뷰 통과 (사람 개입 ①-b 최종 승인 완료)

Error Handling

• Tech Spec 미존재: "Tech Spec 파일이 없습니다. /bf-spec으로 먼저 Tech Spec을 작성하고 리뷰를 받으세요." 안내
• Tech Spec 리뷰 미존재 (docs/reviews/{TICKET}-tech-spec-review.md 없음): "Tech Spec 리뷰가 수행되지 않았습니다. /bf-spec에서 리뷰를 포함한 전체 흐름을 실행하세요." 안내
• orchestrate 스폰 실패: "에이전트 생성에 실패했습니다. 잠시 후 다시 시도하거나, Claude Code를 재시작하세요." 안내

Instructions

1. 사전 확인

• docs/tech-specs/{TICKET}-tech-spec.md 존재 확인
• 사용자에게 Jira 티켓 번호를 확인한다 (미제공 시 요청).

2. Plan 단계 — orchestrate (plan 모드) 스폰

• Task tool 사용, model: sonnet (plan 모드는 단순 라우터 역할이므로 Sonnet으로 충분)
• 전달: mode: "plan", tech-spec 경로, conventions.md 경로 (있으면)
• 수신 대기: "done" + sprint-status.yaml 경로 + stories/ 경로
• 수신 후: sprint-status.yaml을 읽어 에픽/스토리 구조를 사람에게 제시한다.

3. 에픽 루프

sprint-status.yaml의 에픽을 순서대로 순회한다. 각 에픽에 대해:

3a. orchestrate (epic 모드) 스폰

• Task tool 사용, model: opus
• 전달: mode: "epic", epic_id, tech-spec 경로, conventions.md 경로
  • 수정 재실행인 경우: modification_path 추가 전달
• 수신 대기: "done" + sprint-status.yaml 경로 + review.md 경로

3b. 에픽 결과 제시

orchestrate 완료 후 sprint-status.yaml과 review.md를 읽어 사람에게 제시한다:

## Epic {EPIC-ID} 완료

### Story 결과
| 스토리 | 상태 | 난이도 | 재시도 횟수 | Stuck |
|--------|------|--------|------------|-------|
| story-1 | done | S | 0 | - |
| story-2 | done | M | 2 | - |
| story-3 | skipped (stuck) | L | 5 | stuck.md 참조 |

### E2E: {passed | skipped | escalated | max-regression-cycles}
### Integration Review: Blockers {N}건, Recommended {N}건
### 상세: docs/reviews/{EPIC-ID}-review.md

> ⚠️ (모든 Story가 skipped인 경우에만 표시)
> 이 에픽의 모든 Story가 skipped(stuck) 상태입니다. 진행 시 해당 기능이 구현되지 않은 상태로 넘어갑니다.

진행하시겠습니까?
1. 다음 에픽으로 진행
2. 수정 후 재실행 (수정 내용 입력)
3. 워크플로우 중단

3c. 사람 판단 처리

사람의 선택에 따라:

1. 다음 에픽으로 진행:

• 해당 에픽의 사람 수용 상태를 sprint-status.yaml에 반영한다 (yq -i 사용):
  • status: skipped인 Story의 review를 "approved"로 설정 (사람이 skip을 수용)
  • review: pending인 status: done Story의 review를 "approved"로 설정 (사람이 Blocker를 수용)

  # skipped Story review 정리
  yq -i '.<TICKET>.<EPIC>.<SKIPPED-STORY>.review = "approved"' docs/sprint-status.yaml
  # Blocker 수용 — done Story의 pending review를 approved로 전환
  yq -i '.<TICKET>.<EPIC>.<DONE-STORY>.review = "approved"' docs/sprint-status.yaml
  

• 다음 에픽의 3a로 이동한다.

2. 수정 후 재실행:

• 사람이 수정 내용을 텍스트로 입력한다.

• bf-execute가 수정 내용을 분석하여 대상 Story를 추론하고, 사람에게 확인한다:

  • "수정 대상 Story: story-1, story-3으로 판단됩니다. 맞습니까?"
  • 사람이 수정하면 그에 따른다.

• docs/reviews/{EPIC-ID}-modification.md에 기록한다:

  # {EPIC-ID} Modification
  
  ## 수정 지시
  {사람이 입력한 수정 내용 원문}
  
  ## 대상 Story
  - {확인된 수정 대상 Story ID 목록}
  

• git commit하지 않는다 — docs/ 산출물은 Phase 4 Archive에서 일괄 커밋한다.

• 같은 에픽에 대해 orchestrate를 epic 모드로 다시 스폰한다 (modification_path 전달).

• 3b로 돌아가 결과를 다시 제시한다.

3. 워크플로우 중단:

• 현재 상태를 안내하고 종료한다.
• /bf-resume으로 재개 가능함을 안내한다.

4. 전체 완료

모든 에픽 완료 후:

워크플로우가 완료되었습니다.

다음 단계:
1. /bf-archive-sprint — 스프린트 아카이빙
2. /bf-metrics — 메트릭 분석 (선택)
3. /bf-update-conventions — 컨벤션 업데이트

Output Format

• 사용자에게 에픽별 결과 제시 + 판단 요청
• 완료 시 다음 단계 안내
• 모든 산출물은 orchestrate 이하 Lead들이 생성 (메인 세션은 modification.md만 직접 생성)