From 7172de3623719faa272b3c906fc7c05ac8c9b8bc Mon Sep 17 00:00:00 2001 From: kjh2064 Date: Sun, 12 Jul 2026 13:08:15 +0900 Subject: [PATCH] docs: create missing REPORT_GUIDE.md to satisfy COMPLETION_HARNESS_INSTRUCTIONS_V1 --- REPORT_GUIDE.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 REPORT_GUIDE.md diff --git a/REPORT_GUIDE.md b/REPORT_GUIDE.md new file mode 100644 index 00000000..63eda307 --- /dev/null +++ b/REPORT_GUIDE.md @@ -0,0 +1,13 @@ +# Report Guide (보고서 지침) + +본 문서는 은퇴자산 포트폴리오 투자 에이전트의 보고 및 작업 완료 기준을 정의합니다. + +## 기본 완료 조건 (Default Completion Harness) +모든 작업은 아래의 4가지 요소가 모두 충족되어 검증을 통과해야 완료로 판정합니다. + +1. **YAML 계약/공식**: 계약, 공식 및 거버넌스 파일(`yaml`)의 원본 권위가 변경 사항에 맞게 최신화되어야 합니다. +2. **코드 구현**: `code` 구현이 `src/` 또는 `tools/`에 명확히 반영되어야 합니다. +3. **데이터 실체**: 수집 및 계산 결과가 담긴 데이터 실체(`data artifact` 또는 `data/artifact`)가 디렉토리에 정상적으로 생성되고 확인되어야 합니다. +4. **검증 증빙**: 재현 가능한 테스트 실행 및 검증 명령의 결과 파일 또는 터미널 출력이 `validation evidence`(`검증 증빙`)로 기록되어야 합니다. + +이러한 완료 프로세스는 `completion harness`를 통해 엄격하게 통제됩니다.