16 lines
2.2 KiB
Markdown
16 lines
2.2 KiB
Markdown
# 에러 핸들링 — 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 | 보내지 않는다. 해당 교차 질문을 `미검증`으로 기록 |
|
|
| 코드 이해 불가 | 해당 지점을 "불명확 — 확인 필요"로 표기하고 진행. 추측으로 메우지 않는다 |
|
|
| 에이전트 간 상충 | 양쪽 견해를 근거와 함께 병기 |
|
|
| 근거 없는 주장 발견 | 해당 항목을 보고서에서 제외하거나 "근거 미확보"로 강등 |
|