Sitrep – 전투 상황 보고서

Sitrep (전투 상황 보고서)

상황 보고서는 회의실에 없었던 사람을 위한 것입니다. 그 사람을 위해 작성하세요.

Sitrep은 활동 일기가 아닙니다. 현재 상태를 압축적이고 실행 가능하게 보여주는 그림입니다. 세 가지 질문: 무엇이 완료되었는가, 무엇이 차단되었는가, 다음에 무엇이 있을 것인가. 이 세 가지 질문 중 하나라도 답하지 않는 내용은 sitrep에 들어가서는 안 됩니다.

언제 사용하는가

• 일일 스탠드업: 작업 로그, 커밋, 티켓 상태로부터 요약
• 스프린트 종료 시 이해관계자용 요약
• 장애 발생 중 또는 후 장애 상황 보고
• 컨텍스트 전환이나 다른 에이전트/사람에게 작업을 넘길 때 핸드오프 요약
• 이해관계자가 '우리 지금 어디에 있나요?'라고 물었을 때, 솔직한 답변이 '복잡합니다'일 때

절차

1. 현재 작업 상태 수집 — 사용 가능한 소스로부터 읽기:

   • 열려 있거나 최근에 종료된 이슈/티켓
   • 최근 커밋 (스탠드업의 경우 지난 24-48시간, 스프린트 요약의 경우 지난 스프린트)
   • 프로젝트 상태 및 로드맵 문서 (예: docs/operating-model/PROJECT-OPERATING-PROFILE.md, docs/ROADMAP.md 또는 프로젝트 구조에 따라 동등한 문서)
   • 차단 플래그, 위험 등록부 항목, 에스컬레이션 노트

2. 항목을 세 가지 버킷으로 분류:

   • 완료(Done) — 완료되어 검증 가능하게 종료됨 (테스트 통과, 티켓 종료, 배포 완료)
   • 차단됨(Blocked) — 특정 해결되지 않은 의존성 없이는 진행할 수 없는 작업 (차단자를 정확히 명명)
   • 다음(Next) — 다음에 작업할 가장 우선순위가 높은 항목 (우선순위 순서로 정렬)

3. Sitrep 작성 — 구조:

   ## Sitrep — <날짜> [<범위: 스프린트 / 장애 / 핸드오프>]
   
   **완료**
   - <항목> — <전달된 내용과 증거를 한 문장으로>
   
   **차단됨**
   - <항목> — <특정 의존성 / 담당자 / ETA(알고 있다면)에 의해 차단됨>
   
   **다음**
   - <항목> — <우선순위 순서, 가장 중요한 것 먼저>
   
   **위험/플래그** (선택 사항 — 중요한 경우만)
   - <위험> — <해결되지 않을 경우 영향> — <담당자>
   

4. 압축 테스트 적용 — 각 줄에 대해: 제거해도 독자가 행동해야 할 내용에 변화가 없다면 제거하세요.

5. 차단자를 정확히 명명 — "백엔드 차단됨"은 차단 항목이 아닙니다. "/v2/orders용 API 계약에 차단됨 — @담당자 대기 중, ETA 불명"은 차단 항목입니다.

6. 진행 상황을 편집하지 마세요 — "좋은 진전을 이루었습니다"는 잡음입니다. "X를 전달하여 Y를 차단 해제했습니다"는 신호입니다.

산출물

• 위 형식의 sitrep
• 선택 사항: 더 적은 정보가 필요한 이해관계자를 위한 한 문단 실행 요약

가드레일

• 활동 보고 금지. "인증 모듈 작업함"은 sitrep 항목이 아닙니다. "인증 모듈: JWT 검증 완료, 토큰 갱신이 부하 중 실패 — 조사 중"이 맞습니다.
• 차단됨은 차단됨입니다. 무언가 느리게 진행되고 있지만 실제로 차단된 것은 아니라면, "다음"에 메모와 함께 넣고 "차단됨"에 넣지 마세요.
• 완료는 완료입니다. "95% 완료"는 완료가 아닙니다. 검증 가능하게 완료되지 않았다면 "다음"입니다.
• 길이가 품질이 아닙니다. 세 가지 질문에 답하는 다섯 줄의 sitrep이 그렇지 않은 스무 줄의 sitrep보다 낫습니다.