Archive Sprint

Overview

스프린트가 완료되면 관련 문서를 아카이빙하고, changelog를 업데이트하고, git commit을 수행한다.

When to Use

• 사용자가 /bf-archive-sprint를 입력했을 때
• 스프린트 내 모든 에픽의 E2E가 통과한 후

Prerequisites

• sprint-status.yaml 존재 및 모든 에픽의 e2e가 terminal state (passed | escalated | max-regression-cycles | skipped), 모든 Story review: approved (skipped Story 포함 — bf-execute/bf-resume가 사람 "진행" 선택 시 자동 설정)
• docs/stories/, docs/tech-specs/ 디렉토리 존재
• CLAUDE.md 파일 존재 (changelog 기록용)

Error Handling

• sprint-status.yaml 미존재: "sprint-status.yaml이 없습니다. /bf-execute로 워크플로우를 먼저 실행하세요." 안내
• 미완료 에픽 존재 (e2e가 pending): "미완료 에픽이 있습니다: {에픽 목록}. /bf-execute 또는 /bf-resume으로 먼저 완료하세요." 안내
• Story review가 approved가 아닌 경우: "{Story} 리뷰가 미승인입니다. /bf-execute에서 에픽 결과를 확인하고 '진행'을 선택하세요." 안내

Instructions

1. sprint-status.yaml을 확인한다:

   • 모든 에픽의 e2e가 terminal state인지 검증 (passed | escalated | max-regression-cycles | skipped). pending이면 실행 중단
   • 모든 Story의 review가 approved인지 검증
   • 미완료 에픽이 있으면 실행 중단 및 안내

2. 문서를 아카이브 디렉토리로 이동한다:

   • docs/stories/ → docs/archive/{TICKET}/stories/
   • docs/tech-specs/ → docs/archive/{TICKET}/tech-specs/
   • docs/reviews/ → docs/archive/{TICKET}/reviews/ (존재하는 경우)
   • docs/sprint-status.yaml → docs/archive/{TICKET}/sprint-status.yaml
   • docs/conventions.md → docs/archive/{TICKET}/conventions.md (복사, 이동 아님 — 시점 스냅샷 보존용)

3. CLAUDE.md의 ## Changelog 섹션에 append-only로 기록한다 (섹션이 없으면 파일 끝에 생성):

   • 아래 포맷을 따른다:

     ## Changelog
     
     ### {TICKET} ({YYYY-MM-DD})
     - **Epic 1** ({epic-name}): Story N개 완료 ({난이도 분포 요약})
     - **Epic 2** ({epic-name}): Story N개 완료
     - Archive: `docs/archive/{TICKET}/`

   • 기존 Changelog 항목 아래에 새 스프린트를 append한다 (기존 항목 수정 금지)

4. git commit을 수행한다:

   • 메시지: [{TICKET}] 스프린트 아카이빙
   • 포함 대상: docs/archive/{TICKET}/ + docs/conventions.md + CLAUDE.md changelog 변경
   • 이 커밋이 docs/ 산출물의 최초 git 커밋이다 — Phase 1-3에서는 docs/ 파일을 git에 커밋하지 않으며, 아카이브 시점에 일괄 커밋한다.

5. 완료 후 다음 순서로 후속 스킬 실행을 안내한다:

   • 먼저 /bf-metrics (선택 사항): 스프린트 메트릭 분석 → 모델 배당/난이도 태깅 최적화 제안
   • 그 후 /bf-update-conventions: 리뷰 패턴 분석 → conventions.md 업데이트
   • 순서가 중요함: bf-metrics 분석 결과가 bf-update-conventions의 개선 방향에 참고될 수 있음

Output Format

• docs/archive/{TICKET}/ — 아카이브 디렉토리
• CLAUDE.md changelog 업데이트
• git commit