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 리뷰 통과 (사람 개입 ① 완료)

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. 에픽 결과 제시

<HARD-GATE> 에픽 결과를 사람에게 반드시 제시하고 판단을 받아야 한다. 결과가 깨끗해 보여도(Blocker 0, E2E passed) 자동으로 다음 에픽으로 진행하지 않는다. 이것이 사람 판단 ②이며, BF 워크플로우에서 사람이 개입하는 정확히 2개 지점 중 하나이다. </HARD-GATE>

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를 수용)

bash

# 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

에 기록한다:

markdown

# {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만 직접 생성)

bf-execute

NPX Install

Tags

SKILL.md Content