에이전트 결과문 근거 형식 표준안
적용 범위
- 대상 계열: ron, codex, guardian, analyst 4계열.
- 모든 완료 결과문은 결론, 근거, 검증, 다음행동 4개 필드를 가진다.
- done 허용은 4필드 중 4개가 채워지고, 근거와 검증에 실제 값이 각각 1개 이상 있을 때만 가능하다.
- placeholder, 계획문, 실행 전 선언문, 파일·명령·숫자 없는 일반 문장은 차단한다.
공통 필드 기준
| 필드 | 필수 내용 | 차단 조건 | codex 구현 키 |
|---|---|---|---|
| 결론 | 작업 번호, 최종 상태, 핵심 판단 1문장 | 작업 결과가 정리됨, 처리됨만 반복 | conclusion |
| 근거 | 원자료, 산출물, 숫자, 기준일 중 2개 이상 | 근거 섹션 미기재, 결론 참고, 없음, idle | evidence |
| 검증 | 실행 명령 또는 확인 방법, 반환값, 성공 기준 | 확인하지 않음, 실행 예정, 검증값 없음 | verification |
| 다음행동 | 추가 조치 없음 또는 재시도·보완 대상 1문장 | 빈 값, 나중에 확인, 알아서 처리 | next_action |
계열별 표준
| 계열 | 결론 | 근거 | 검증 | 다음행동 |
|---|---|---|---|---|
| ron | 전체 지휘 결과, 영향 범위, 완료·보류 상태 | 큐 번호, 대상 에이전트, 처리 건수, 상태 변화 | 버스 큐 조회, 디비 상태, 메시지 발송값 | 재시도, 대기, 위임, 추가 조치 없음 |
| codex | 수정한 기능과 통과·차단 상태 | 수정 파일, 변경 요지, 실패 재현값, 차단 사유 | 컴파일, 관련 테스트, 샘플 통과·차단 결과 | 병합 대기, 재시작 필요, 추가 수정 없음 |
| guardian | 시스템 건강 상태와 위험 등급 | 프로세스 수, 큐 수, 크론 수, 디스크·로그 값 | 헬스체크 명령, 조회 시각, 정상 기준 | 복구, 관찰, 알림, 추가 조치 없음 |
| analyst | 투자 판단과 기준일 | 티커·회사, 지표 숫자, 원문·산출물, 미확인 항목 | 데이터 기준일, 원천 확인, 계산 결과 | 유지, 제외, 재수집, 미확인 유지 |
허용 예시와 차단 예시
| 계열 | 허용 예시 | 차단 예시 |
|---|---|---|
| ron | 결론: #37709 지식 순환 정상 종료. 근거: 실행 1건, 큐 대기 0건, 산출물 갱신 확인. 검증: run-cycle 반환값 ok, 조회시각 16:27. 다음행동: 추가 조치 없음. | 결론: 작업 처리됨. 근거: 근거 섹션 미기재. 검증: 없음. 다음행동: 추가 조치 없음. |
| codex | 결론: #37713 근거 누락 차단 로직 보강. 근거: 대상 파일 1개 수정, 누락 샘플 1개 차단. 검증: 컴파일 성공, 관련 테스트 2개 통과. 다음행동: 서버 재시작 후 실물 큐 1건 확인. | 결론: 수정했습니다. 근거: 파일을 고쳤다고 판단. 검증: 테스트 예정. 다음행동: 나중에 확인. |
| guardian | 결론: 시스템 정상, 장애 0건. 근거: 살아있는 에이전트 9개, 큐 claimed 2건, failed 8건 확인. 검증: 버스 상태 조회 16:27 성공. 다음행동: codex claimed 1건만 관찰. | 결론: 정상. 근거: 대기중. 검증: 확인 안 함. 다음행동: 없음. |
| analyst | 결론: #37701 방산 숫자 공백 해소, 확인값 20/20. 근거: 4개사×5항목, 기준일 2026-07-21~29, 산출물 저장. 검증: 원문별 숫자 대조, 미공개 항목 분리. 다음행동: 연간 수주 가이던스는 미확인 유지. | 결론: 방산 자료 정리. 근거: 결론 참고. 검증: 최신 자료 기준. 다음행동: 추가 조치 없음. |
구현 기준
- required_fields = [conclusion, evidence, verification, next_action].
- field_presence: 4개 라벨이 모두 있어야 한다.
- evidence_presence: evidence에 숫자, 파일명, 기준일, 원천, 산출물, 큐 번호 중 2종 이상 필요하다.
- verification_presence: verification에 명령·조회·계산·원문 대조 중 1종 이상과 성공값이 필요하다.
- hard_block_phrases: 근거 섹션 미기재, 결론 참고, 확인하지 않음, 실행 예정, 없음, idle, 작업 결과가 정리됨.
- allowed_idle: agent status heartbeat는 done 결과문이 아니므로 예외 처리하되, bus_commands 완료 결과에는 적용하지 않는다.
성공 기준
- 4계열 모두 허용 예시 1개와 차단 예시 1개를 가진다.
- codex 구현 후 누락 샘플은 failed 또는 needs_evidence로 남고, 허용 샘플만 done이 된다.
- 최근 실패 유형 missing_original_verification, missing_source, missing_verification_value, missing_basis_section 4종이 같은 표준으로 설명된다.
Knowledge OS 연결
- [[MOC-Hermes-결과문-근거형식-260901]] — 표준안, 구현대상, 검증기준 상위 지식망.
- [[260901_에이전트별_결과문_기준_분류]] — 에이전트별 결과문 기준 분류.
- [[260901_결과문_근거누락_반례_분류]] — 허용 예시와 차단 예시의 반례 분류.
- [[260901_근거게이트_후속구현_검증항목]] — 후속 구현 대상과 검증 기준.
- [[260831_bus_completion_evidence_policy]] — 근거 누락 방지 운영안 원문.