2.2 KiB
2.2 KiB
에러 핸들링 — orchestrate-ptop-harness
| 상황 | 처리 |
|---|---|
| 에이전트 타입 미등록 | Phase 시작 전 중단 → "세션 재시작 필요" 보고 (Phase 1-2) |
| 재시도 카운트 | 재시도 횟수는 _workspace/_progress.md의 시도 칸에 기록한다(가용하면 TaskUpdate에도 병행). 기록이 없으면 0회로 간주 — 대화 맥락에만 두면 3회째로 새거나 1회에서 조기 포기한다 |
| 실패 판정 기준 | ① 에이전트가 에러로 종료 ② 지정 산출 파일이 생성되지 않음 ③ 산출 파일이 비었거나 헤더만 있음 — 셋 중 하나면 실패로 본다. 지연은 실패가 아니다. 재시도는 같은 Agent 호출을 다시 하는 것이며 SendMessage 독촉이 아니다 |
| 반쯤 쓰인 산출 파일 | 지우지 않고 파일 상단에 (부분 — 미완)을 표기해 보존. 통합 보고서에서 해당 영역을 부분으로 표시 |
| 에이전트 실패 | 1회 재시도. 재실패 시 해당 영역 없이 진행하고 보고서에 누락을 명시 |
| lead 지연 → developer 대기 | run_in_background로 띄운 에이전트는 완료 알림이 올 때까지 기다린다. 알림 없이 미완을 판단하지 않는다(기동 직후 확인하면 당연히 미완이라 폴백으로 오인된다). 알림이 온 뒤에도 산출 파일이 없으면 1회 재확인하고, 그래도 없으면 실패로 처리한다 |
| lead 2회 실패 (지연과 다름) | developer를 소스 직접 참조 모드로 기동(ptop-developer.md 재호출 지침). 부분 01이 남아 있으면 그것을 함께 전달하되 (부분 — 미완)임을 명시한다. 01 누락과 그 영향을 보고서에 적고, 아키텍처 관련 교차 질문은 미검증 처리 |
| 죽은 에이전트에 SendMessage | 보내지 않는다. 해당 교차 질문을 미검증으로 기록 |
| 코드 이해 불가 | 해당 지점을 "불명확 — 확인 필요"로 표기하고 진행. 추측으로 메우지 않는다 |
| 에이전트 간 상충 | 양쪽 견해를 근거와 함께 병기 |
| 근거 없는 주장 발견 | 해당 항목을 보고서에서 제외하거나 "근거 미확보"로 강등 |