검토 결과 적용하기
사용자가 각 검토 결과를 결정하고 승인한 것만 적용하도록 도와주세요.
핵심 규칙: 명시적인 결정 없이 변경을 추론, 가정 또는 적용하지 마세요. 검토 결과가 모호하면 옵션을 제시하기 전에 명확히 요청하세요. 각 검토 결과는 개별적으로 결정되며, 절대 그룹화하지 마세요.
아티팩트 및 상태
- 각 작업 항목은
docs/specs/<YYYYMMDD>-<type>-<name>/에 있습니다. spec.md와plan.md는 frontmatter에status: draft | approved | obsolete를 포함합니다. 오직 사람만이approved를 설정할 수 있습니다.approved였던 아티팩트를 변경하는 경우, 다시draft로 설정하고 그 사실을 알리세요.
1단계: 검토 결과 제시
- 작업 항목과 검토 문서(
review-spec.md또는review-plan.md)를 식별하세요. 명확하지 않으면 질문하세요. - 모든 검토 결과를 번호를 매겨 나열하되, 차단성(blocking) 결과를 먼저 나열하세요. 각 결과에 대해 다음을 보여주세요:
- 검토 결과 [N]: 검토 내용.
- 제안된 수정 사항(있는 경우).
- 옵션:
- A) 수정 사항을 그대로 적용.
- B) 수정된 수정 사항 적용(사용자가 설명).
- C) 이유와 함께 폐기.
- D) 연기.
진행하기 전에 사용자가 모든 결과에 답변할 때까지 기다리세요.
2단계: 확인
결정 요약
────────────────
[N] <제목> → 적용 / 수정 적용 / 폐기 / 연기
"이 결정들을 적용하기 전에 확인하시겠습니까?"라고 물어보세요. 확인 없이 진행하지 마세요.
3단계: 적용
- 확인된 변경사항(A 및 B)만 적용하고, 검토된 아티팩트에만 적용하세요. 다른 것은 건드리지 마세요.
- 검토 파일에서 각 검토 결과 아래에 결정 사항을 기록하세요:
- 폐기된 경우: 이유.
- 연기된 경우: 아직 보류 중인 사항.
- 사용자에게 현재 상황을 알리세요:
- 열려 있는 차단성 검토 결과가 없으면, 아티팩트는 사용자가
approved로 표시하거나 다른review-spec패스를 받을 준비가 된 상태입니다. - 연기된 차단성 검토 결과가 남아 있거나 위험을 수반하는 폐기된 결과가 있으면 이를 지적하세요.
- 열려 있는 차단성 검토 결과가 없으면, 아티팩트는 사용자가
4단계: 다른 영향을 받는 사양
2단계의 결정이 진행 중인 다른 사양에 영향을 미치는지 확인하세요:
docs/specs/*/spec.md에서status: draft인 사양을 찾으세요.- 각 사양에 대해 결정이 충돌을 일으키거나, 의존성을 변경하거나, 가정을 무효화하는지 추론하세요.
- 영향을 받을 수 있는 각 사양에 대해:
- 어떤 사양, 어떤 섹션, 무엇을 변경해야 하는지 보여주세요.
- "이 결정이 영향을 미치나요? 변경을 제안할까요?"라고 물어보세요. 네 또는 아니오라는 답변을 기다리세요.
- 답변이 '네'인 경우, 최소한의 변경(정확한 섹션과 줄)만 초안을 작성하고, diff를 보여준 후 승인 후에만 적용하세요.
해당 사양에서 다른 부분을 개선, 확장 또는 재구성하지 마세요. 어떤 단계에서든 무엇을 해야 할지 불분명하면 멈추고 질문하세요.