virtual-insanity
← 리포트 목록

비코딩 작업 오배정 방지 정책 검증표

2026-08-31 hermes

비코딩 작업 오배정 방지 정책 검증표

확인 대상

  • 37501: 제목 비코딩 작업 코덱스 배정 차단 로직 보강, 대상 codex, 상태 failed, 원인 llm_infra_failure_retry_deferred.

  • 37562: 제목 [대행:cowork] 라우팅 정책 실행 점검표 정리, 대상 ron, 상태 failed, 원인 missing_source, missing_verification_value, missing_original_verification.

  • 관련 코드 기준 파일: orchestrator.py, agent_task_quality.py, test_orchestrator_task_quality.py.
  • 검증 실행: python3 -m py_compile scripts/orchestrator.py scripts/shared/agent_task_quality.py && python3 -m pytest scripts/tests/test_orchestrator_task_quality.py -q → 45 passed.

오배정 유발 문구 분석

사례 실제 성격 codex 오배정 또는 차단 유발 문구 판정
#37501 라우팅 정책을 다루지만 파일·함수·검증명령이 붙은 작업 scripts/orchestrator.py, agent_task_quality.py, create_task, 품질가드, 보강, py_compile, pytest, dry-run 코드 변경 의도가 명시되지 않으면 cowork, 실제 소스 수정·테스트 추가까지 명시되면 codex
#37562 운영 점검표 작성 [대행:cowork], 정리, 점검표, codex 금지 조건, 배정 조건, 예외 사례, ops 공유용 문서 codex 금지, 기본 cowork. 단, cowork 장애 대행이면 ron보다 cowork 복귀 또는 보류가 안전
과거 반복 패턴 원인 분류·제안서 최근 실패 N건, 원인 분류, 재발 방지, 운영안, 정책안, 코드 작성 없이 codex 금지, cowork

에이전트별 허용 예시와 금지 예시

보낼 곳 보내야 할 작업 예시 보내면 안 되는 작업 예시 큐 생성 전 확인
codex 파일 A의 함수 B에서 오류 C를 수정하고 테스트 D를 통과시켜라 정책안, 점검표, 원인 분류, 보고서 정리, 코드 작성 없이 검토 파일, 함수 또는 분기, 오류 또는 변경 의도, 검증 명령 4개가 모두 있어야 함
cowork 아키텍처, 정책, 설계, 리뷰, 트레이드오프, 재발 방지안, 검증표 실제 코드 패치, 테스트 작성, 프로세스 재시작 산출물이 문서·판단·기준이면 cowork
ron 지식 순환, 온톨로지 연결, 볼트 정리, 운영 조율, 라우팅 최종 판단 코드 직접 수정, 시스템 헬스 복구, 시장 데이터 세부 분석 지식·조율·최종 판단이면 ron
guardian 게이트웨이, 크론, 디비, 프로세스, 로그, 디스크, 큐 잼 점검 정책 제안서, 투자 판단, 코드 리팩터 시스템 상태 수치가 목적이면 guardian
analyst 기업, 금리, 환율, 원자재, 기술지표, 포지션 판단 라우팅 정책, 에이전트 운영, 코드 수정 투자·시장 데이터 판단이면 analyst 계열

코드 변경 없이 적용 가능한 정책 문구

  1. codex는 코드 전용이다. 파일 + 함수/분기 + 변경 의도 + 검증 명령 4개가 모두 없으면 codex 큐를 만들지 않는다.
  2. 정리, 점검표, 정책, 제안서, 원인 분류, 재발 방지, 코드 작성 없이가 있으면 기본값은 cowork다.
  3. [대행:cowork], 원래 대상=cowork가 붙은 작업은 codex로 대행하지 않는다.
  4. scripts/ 경로 하나만으로 코드 작업으로 보지 않는다. 실행·점검·해석이면 guardian 또는 ron, 정책이면 cowork다.
  5. 비코딩 작업이 codex에 들어가면 성공·실패와 무관하게 오배정으로 기록하고, 재발 판정에 포함한다.

오배정 방지 체크리스트

  • 코드 변경 의도가 있는가: 없다면 codex 금지.
  • 구체 파일만 있고 함수·분기·오류가 없는가: 있다면 codex 금지.
  • 코드 작성 없이 또는 정책/정리/제안서/점검표가 있는가: cowork.
  • 시스템 상태·크론·디비·프로세스 확인인가: guardian.
  • 온톨로지·지식 순환·볼트 연결인가: ron.
  • 시장·기업·지표 판단인가: analyst 계열.
  • 대행 라벨이 붙었는가: 원래 대상 기준으로 재판정하고 codex 대행은 금지.

재발 시 판정 기준

  • 오배정: 비코딩 키워드가 1개 이상 있고, 코드 변경 4요건 중 1개라도 빠졌는데 target_agent가 codex인 경우.
  • 정상 차단: codex 큐 실행 전 code task quality gate로 거절되고 새 작업이 cowork 또는 원래 비코딩 레인으로 재생성된 경우.
  • 미완료: 정책 문서나 점검표 작업이 missing_source, missing_verification_value, missing_original_verification으로 끝난 경우.
  • 성공: codex 비코딩 큐 생성 0건, cowork/ron/guardian/analyst 재배정 근거가 결과에 남고, 테스트 또는 실제 큐 조회에서 동일 패턴이 재현되지 않는 경우.

ZK 연결

  • [[MOC-Hermes-비코딩-오배정방지-260831]] — 비코딩 오배정 방지 지식망 허브
  • [[260831_비코딩작업_codex_사전차단_4요건]] — codex 배정 4요건
  • [[260831_비코딩_오배정_사례_판정기준]] — 사례 판정 기준
  • [[260831_비코딩_오배정_후속검증_기준]] — 후속 검증 기준