AgentLoop

AgentLoop는 워커마다, 평론가 세션마다 새로운 엔진 프로세스를 시작하므로 이전 채팅 이력이 따라오지 않는다. 이는 긴 채팅을 신뢰할 수 없게 만드는 낡은 가정의 축적, 즉 문맥 부패를 피한다. 지속되는 기억은 프로젝트 자체와 평론가가 쓰는 구체적인 수정이며, 끝없이 커지는 대화를 다시 읽느라 토큰을 태우는 일을 막는다.

완료 정의는 GUIDELINES.md에 둔다. 새로운 평론가가 매 사이클 그 파일을 워커의 출력, 프로젝트 파일과 함께 읽는다. 평론가의 마지막 줄은 엄격한 계약이다. PASS, 수정 메모가 붙은 FAIL, CONTINUE 중 하나로 끝나야 한다. FAIL은 다음 워커에 주입되는 지시가 되므로, 피드백은 손으로 전달해야 하는 코멘트가 아니라 행동으로 바뀐다. 프로젝트 자체 평가에서, 새로운 평론가는 아홉 개 테스트가 모두 통과한 뒤에 혼합 퍼센트 디코딩 결함을 찾아냈다.

진행 상황은 대화가 아니라 PLAN.md와 STATE.md에 산다. 워커는 계획과 상태를 읽고, 증분 하나를 하고, 상태를 갱신하고, 종료한다. 기억이 파일에 있으므로 루프는 범위 안에 머물고 무인 운용이 더 쉽다. 에이전트가 다루는 것과 같은 산출물을 읽고 각 단계에서 무엇이 바뀌었는지 정확히 볼 수 있다는 뜻이기도 하다.

모든 사이클과 판정, 기록, 비용, 파일 인계가 로컬 대시보드에 나타난다. 프로세스를 찾아 헤매는 대신 거기서 실행을 취소할 수 있고, MCP 브리지를 통해 ChatGPT에 상태를 물을 수 있다. 추측은 없다. 무인 에이전트 실행을 사후에 디버깅하려 한 사람에게는 타임라인이 기록되어 있느냐가 문제를 고치는 것과 짐작하는 것의 차이다.

AgentLoop는 Codex CLI와 Claude Code를 교체 가능한 엔진으로 돌린다. 대시보드에서 루프마다 하나를 고르거나, 브리지를 통해 작업마다 고른다. 이 프로젝트는 계획과 로컬 실행을 분리해 두며, 로드맵은 다음으로 양방향 에이전트 질문과 리서치 루프를 가리킨다.

git 작업 트리 안의 프로젝트에서는 자동 체크포인트가 기본으로 켜져 있어, 사이클이 완료될 때 데몬이 진행 상황을 커밋할 수 있다. 재시도 한도에 걸린 멈춘 작업 같은 갑작스러운 실패도 이미 끝난 작업을 지우지 않는다. 복구는 git 명령 하나 거리이며, 잃어버린 오후가 아니다. 밤새 실행할 때 이 점이 중요하다.

루프는 의도적으로 순차적이다. 독립적으로 대기열에 들어간 작업은 동시성 한도까지 돌 수 있지만, 하나의 루프가 같은 프로젝트를 휘젓는 병렬 무리로 변하지는 않는다. 의도된 것이다. 예산에도 상한이 있다. maxCycles는 1에서 50까지이고 기본값은 3이며, taskRetries는 연속 실패를 제한해 이후 작업이 차단으로 표시되고 건너뛰어진다.