회고

에픽이 끝나면 bmad-retrospective를 바로 실행하세요. 이 스킬은 에픽이 만든 사양, 스토리 기록, 전체 diff, 커밋, 추적 산출물을 읽습니다. 사람이 작업 과정을 어떻게 기억하는지에 기대지 않고 이 증거로 검토합니다. 결과로 서면 검토, 제안된 실행 항목, 에픽이 인수 기준을 충족했는지에 대한 판정을 받습니다.

수행하는 작업

에픽은 각각 따로 구현하고 검토한 여러 스토리가 쌓여 완성됩니다. 회고는 이를 한꺼번에 살펴보고 개별 스토리만으로는 알 수 없던 내용을 찾아냅니다.

누적 결함 — 조금씩 어긋난 아키텍처, 중복으로 작성된 헬퍼, 여러 차례 몇백 줄씩 늘어나 결국 과도하게 커진 클래스
diff 범위 검토 — 에픽의 diff를 bmad-review에 전달해 코드 관점별로 검토하며 개별 세션에서 양쪽을 함께 보지 못한 스토리 간 경계를 중점적으로 살펴봄
사양 대조 — 구현된 코드가 에픽과 PRD에서 설명한 내용과 달라진 부분
인수 판정 — 에픽 자체의 인수 조건에 따른 결과 평가

모든 발견 사항에는 파일, 줄, 커밋, 로그처럼 근거를 확인할 위치가 붙습니다. 근거를 가리킬 수 없는 주장은 보고서에 포함하지 않습니다.

에픽이 끝난 뒤 실행하는 이유

각 스토리는 따로 검토를 통과했습니다. 여기까지 남은 버그는 작업을 나눠 본 탓에 놓친 문제입니다. 아홉 번의 세션이 같은 파일에 코드를 조금씩 추가하면, 어느 세션도 여러 작업이 합쳐져 커진 클래스를 전체로 보지 못합니다. 에픽이 처음 세운 목표를 전체적으로 달성했는지 판단한 세션도 없습니다. 회고는 이 빈틈을 메웁니다. diff가 아직 최신이고 세션 로그가 지워지기 전인 에픽 종료 시점이 가장 적절합니다.

두 가지 에픽 입력

Retrospective는 전체 흐름에서 만든 스프린트 추적 정보와 개발 경로 선택하기에서 설명한 가벼운 사양 폴더를 모두 입력으로 받을 수 있습니다.

에픽 입력	목록 및 완료 상태	회고 결과
스프린트 추적 에픽	`sprint-status.yaml`에서 선택한 에픽과 스토리 산출물	구현 산출물에 날짜가 붙은 문서를 만들고 스프린트 상태 업데이트
사양 기반 에픽	`SPEC.md`, 순서가 있는 `stories.yaml`, `stories/<id>-*.md` 기록	사양 폴더에 `RETROSPECTIVE.md` 생성. 스프린트 상태 파일은 만들거나 바꾸지 않음

사양 기반 경로에서는 stories.yaml이 에픽의 스토리 목록을 정의하고 각 스토리 기록의 프런트매터가 완료 상태를 나타냅니다. Build와 Build Auto 중 어느 스킬이 기록을 만들었든 같은 규칙을 적용합니다.

얻는 결과

증거 보고서와 판정을 받습니다.

회고 문서 — 증거 목록, 출처와 함께 묶은 발견 사항, 판정, 제안된 실행 항목을 담습니다.
스프린트 모드의 업데이트된 상태 — 회고를 완료 상태로 표시하고 실행 항목을 관련 발견 사항과 연결합니다. 사양 기반 모드는 스프린트 상태를 사용하지 않습니다.
판정 — accepted, accepted-with-open-items, rejected 중 하나입니다. 다음 에픽을 시작할지, 멈추고 먼저 수정할지 알려줍니다. 해당 에픽에 완료되지 않은 스토리가 있으면 자동 판정은 rejected입니다. 대화형 실행에서는 사람이 이를 바꿀 수 있습니다.

결과 활용하기

스킬은 제안만 합니다. 무엇을 실행할지는 사용자가 결정하며 코드나 사양을 자동으로 수정하지 않습니다.

실행 항목은 즉시 수정할 작업이나 새 스토리로 일반 개발 루프에 들어갑니다. 회고는 항목을 작성하지만 실행하지 않습니다.
사양 대조 결과에는 증거가 함께 제공됩니다. 사용자가 프로젝트 계약에 직접 반영해야 하며 해석이 불확실한 내용은 사양에 자동으로 기록하지 않습니다.
판정은 게이트 역할을 합니다. rejected 또는 accepted-with-open-items 판정은 다음 계획 단계로 넘겨야 할 내용을 알려줍니다.

문제가 있는 에픽을 아무 일 없었다는 듯 승인 상태로 종료하지는 않습니다. 인수 조건을 충족하지 못했거나 에픽의 스토리가 하나라도 완료되지 않았다면, 사람이 판정을 바꾸지 않는 한 승인되지 않은 상태로 종료합니다.

실행하기

에픽 번호나 사양 폴더를 지정해 bmad-retrospective를 실행하세요. 아무 입력도 주지 않으면 스프린트 상태에서 완료된 에픽을 찾을 수 있습니다. 기본적으로 보고서와 판정을 작성한 뒤 멈춥니다.

원하는 작업	실행 방법
표준 검토	`/bmad-retrospective`
특정 에픽 검토	`/bmad-retrospective 3`
사양 기반 에픽 검토	`/bmad-retrospective _bmad-output/specs/spec-<slug>/`
팀 토론	”팀과 함께 논의해 줘”라고 요청합니다. 실제 발견 사항을 두고 파티 모드를 진행합니다. 기본값은 꺼짐입니다.
자동화를 위한 무인 실행	`-H <epic>` — 증거만으로 판정하는 비대화형 모드