2.0 KiB
2.0 KiB
00_PTOP_HARNESS_SUMMARY.md 골격
오케스트레이터 Phase 5가 쓰는 통합 보고서의 필수 섹션이다.
_workspace/00_PTOP_HARNESS_SUMMARY.md 한 파일로 만든다.
필수 섹션
| 섹션 | 내용 |
|---|---|
| Executive Summary | 3~5줄 |
| 영역별 발견 | 아키텍처(01) / 구현(02·03) / 빌드(04·05·06) — 각 3건 이상, 모두 파일:라인 근거 포함 |
| 상충 사항 | 에이전트 간 이견과 양쪽 근거 |
| 권장사항 | P0/P1/P2 · 항목 · 근거 · 예상 공수 |
| 산출물 stale | 파일별 "이번 실행 갱신(YYYY-MM-DD)" / "이전 결과 재사용(YYYY-MM-DD)" + 연쇄 무효화 상태 |
| 미검증·불명확 | 확인하지 못한 항목과 사유 |
| 부록 | 산출 파일 목록 |
섹션을 늘리거나 줄이면
SKILL.md§성공 기준의 대응 항목도 같은 편집에서 고친다 (docs/harness-ptop.md§소비처 확인 의무).
표기 규약
수치·상태를 추정으로 적지 않는다. 빌드 시간·성능 수치는 실제 측정했을 때만 기재하고,
측정하지 않았으면 미측정이라고 쓴다. 그럴듯한 숫자가 보고서에 남으면 이후 판단을 오염시킨다.
검증 전 서술에는 [추론]을 붙인다 (rules.md #15·#16). 미측정(측정했으나 값 없음)과 축이
다르니 대체하지 말고 병기한다. 확인 후에는 [추론]을 떼고 파일:라인 근거로 바꾼다.
중단 시에도 먼저 쓴다
미검증·불명확 절이 모든 누락의 종착지다. 에이전트 전원 실패로 중단하는 경우에도
이 파일을 그 1개 절만으로 먼저 쓴 뒤 보고한다 — 중단하면 흔적이 채팅에만 남아
폴더를 여는 사람이 상황을 알 수 없다.
작성 후 산출 경로와 P0 항목을 요약 보고한다. _workspace/는 감사 추적용으로 보존한다.
.md200줄 상한(rules.md#4)은 이 보고서에도 적용된다. 넘으면 영역별로 분할하고 요약 본문에서 상대경로로 링크한다.