LAT Runner
.lat/tasks.yaml의 승인된 구현 작업을 실행합니다. 일반적으로 lat-dispatch에 의해 시작됩니다.
실행 경계
- 승인된 구현 작업만 실행합니다. 사양 검토나 계획 검토는 처리하지 않습니다.
- 현재 큐를 처리한 후 정상 종료됩니다. 백그라운드 데몬이나 장기 리스너를 생성하지 않습니다.
처리 흐름
.lat/tasks.yaml을 읽습니다.- 파일이 없거나, 비어 있거나,
[]인 경우 →No pending tasks출력, exit code0으로 종료합니다. - YAML 파싱 실패 →
references/yaml-schema.md의 파싱 오류 처리 절차를 따릅니다. - 작업을 위에서 아래로 처리하며, 각 작업에 대해 다음 체크리스트를 수행합니다:
- [ ] 작업의 goal, context, constraints 읽기
- [ ] plan_file이 있으면 → 계획 파일을 읽고 단계 순서 확인
- [ ] 사용 가능한 도메인 스킬과 일치하는지 판단, 일치 시 로드
- [ ] 계획 단계 순서(또는 goal)에 따라 구현 실행
- [ ] results.yaml 상단에 결과 삽입(동일한 task_id 및 agent_id 사용)
- [ ] tasks.yaml에서 이 작업 제거
보충 규칙:
context.plan_file이 있는 경우 계획을 먼저 읽고, 정의된 단계 순서대로 실행합니다. 각 단계 완료 후 프로젝트가 실행 가능해야 합니다.- 계획 파일이 없는 간단한 작업:
goal에 따라 직접 실행합니다. - 스킬은 작업 범위를 확장해서는 안 됩니다.
constraints와 충돌하는 경우constraints가 우선합니다. - 처리된 작업(완료, 부분 완료, 실패 여부와 관계없이)은
tasks.yaml에서 제거합니다. 처리되지 않은 작업은 유지합니다.
결과 상태
| 상태 | 의미 |
|---|---|
completed | 작업 목표가 완전히 달성됨 |
partial | 부분적으로 달성됨. summary에 완료된 범위와 완료되지 않은 범위를 명시 |
failed | 완료되지 않음. errors에 최소 하나의 {code, message} 객체를 포함 |
후속 작업
- 대규모 작업을 분할해야 하고 남은 작업을 추적할 수 있는 경우에만 추가합니다.
- 동일한
task_id(스펙 파일 이름)를 사용하고,agent_id는 라운드를 증가시킵니다(예:code_executor_2_<task_id>,code_executor_3_<task_id>).created_by는 현재 에이전트의 식별 이름을 입력합니다. - 구현 작업만 추가하며, 검토 유형의 작업은 추가하지 않습니다.
완료 출력
- 작업 없음 →
No pending tasks, exit code0. - 작업 있음 → 각 상태별 개수(processed / completed / partial / failed)와 수정된 파일 목록을 출력합니다.
- 처리 완료 후 zmx 세션을 유지하지 않습니다.
주의 사항
- 계획의 단계를 건너뛰거나 재정렬하지 마십시오.
- 결과 쓰기 규칙, YAML 필드 순서, 빈 상태 처리, 파싱 오류 백업 절차는 모두
references/yaml-schema.md를 참조하십시오.