39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# `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/`는 감사 추적용으로 보존한다.
|
|
|
|
> `.md` 200줄 상한(`rules.md` #4)은 이 보고서에도 적용된다. 넘으면 영역별로 분할하고
|
|
> 요약 본문에서 상대경로로 링크한다.
|