완료근거 반려 방지용 태스크 본문 점검안

목적

analyst-macro와 analyst-technical 태스크가 missing_source, missing_verification_value, verification_command_unverifiable로 반려되지 않도록, 태스크 본문에 처음부터 “실제 경로·실제 실행·실제 결과”를 못박는다. 단순히 “4블록으로 보고하라”는 문장만 넣으면 부족하다.

반드시 들어갈 문장 패턴

실제 출처를 먼저 지정한다.
analyst-macro 예시: 근거는 scripts/pipeline/market_indicator_tracker.py 또는 memory/macro-timeseries/*.json처럼 실제 존재 확인된 로컬 파일만 사용한다. 존재하지 않는 market_indicator.py, vault_macro_bridge.py 경로를 쓰지 않는다.
analyst-technical 예시: 근거는 memory/price-history/*.json, memory/technical-signals/*.json, 또는 실제 존재 확인된 기술지표 수집 스크립트만 사용한다.
검증 줄 안에 재현 명령과 결과값을 같이 쓰게 한다.
필수 문장: 검증: <실제 실행한 명령 또는 로컬 파일 파싱 명령>(워크스페이스 경로 포함) → exit code 0 또는 실제 수치 N개를 한 줄에 쓴다.
이유: 정책 문서가 “검증 명령 + 결과값”을 요구하고, 최근 analyst-macro 사례는 verification_command_unverifiable 또는 실존하지 않는 경로로 반려됐다.
근거파일 줄에는 파일·줄·원문을 넣게 한다.
필수 문장: 근거파일: <실존 경로>:<줄번호 또는 항목 위치> "<파일 안 원문 일부>"를 반드시 쓴다. 파이썬 표현식이나 계획 문구가 아니라 파일에 실제 적힌 날짜·값을 인용한다.

금지 문장 패턴

결과 확인 보류, 검증 근거 미기재, 핵심 근거 없음, 원문 확인 누락을 결과처럼 다시 제출하지 않는다. 이것은 반려 사유이지 완료 근거가 아니다.
확인함, 정상, 실행 예정, 분석했다, 추정, 성공 예상처럼 결과값 없는 문장만 쓰지 않는다.
존재 확인 전 경로를 쓰지 않는다. 특히 scripts/pipeline/market_indicator.py, vault_macro_bridge.py, scripts/scripts/...처럼 과거 반려에 나온 가짜 경로 금지.
검증 명령을 “curl로 확인”, “웹에서 조회”처럼 자유서술만으로 쓰지 않는다. 워크스페이스 경로와 실제 출력값이 없으면 다시 막힌다.

태스크 본문에 붙일 짧은 템플릿

완료 보고는 아래 4줄을 그대로 채운다. 각 줄은 독립 줄로 작성한다. 결론: <무엇을 실행/확인/작성했는지 완료형으로 쓰고 핵심 수치 1개를 붙인다> 근거: <실제로 읽은 파일/DB/API/로그 경로> + <조회 2026-09-19 HH:MM KST> + <전후 수치> 검증: <실제 실행한 명령, 워크스페이스 경로 포함> → 근거파일: <실존 경로>:<줄번호> "<원문 일부>"

최근 사례에서 뽑은 적용 규칙

정책 파일 config/agent_completion_submission_standard.md는 실행값·출처·검증값·근거파일 4요소를 요구한다. missing_source는 “실존 파일 경로 또는 라벨 붙은 소스 라인 없음”, missing_verification_value는 “검증 명령+결과 없음”이다.
정책 파일 config/completion_evidence_policy.md는 analyst-macro의 존재하지 않는 market_indicator.py 경로 사용을 실제 반려 원인으로 기록했다. 실존 파일은 market_indicator_tracker.py다.
최근 버스 메시지에서는 analyst-macro가 execution_artifact_path_not_found:/Users/ron/.hermes/workspace/scripts/pipeline/market_indicator.py로 반려됐고, analyst-technical도 verification_command_unverifiable 보완 요구가 떴다.

검증 기준

태스크 본문에 정확한 소스 경로가 없으면 실패.
검증: 줄에 경로와 실제 결과값이 같이 없으면 실패.
근거파일: 줄에 파일·줄·원문 인용이 없으면 실패.
같은 반려가 3회 재발하면 본문 문제가 아니라 게이트 코드 또는 라우팅 배선 문제로 보고 codex 재조사로 넘긴다.

결론: 운영 메모를 작성했고 핵심 규칙은 실존 경로 지정, 검증 명령+결과값 한 줄 기재, 근거파일 파일·줄·원문 인용 3개다. 근거: config/agent_completion_submission_standard.md, config/completion_evidence_policy.md, bus/messages.jsonl 및 ops_multiagent.db 조회 2026-09-19 11:39 KST. 검증: 산출물 파일 존재 및 결론/근거/검증/근거파일 4블록 라벨 포함 여부를 별도 명령으로 확인한다. 근거파일: /Users/ron/.hermes/workspace/config/agent_completion_submission_standard.md:81 "결론: <무엇을 했는지 한 줄>"