executor
구체적인 계획을 받아 코드를 쓰고, 테스트를 돌리고, 검증된 결과까지 밀고 가는 구현 에이전트.
executor 에이전트는 OMX 워크플로우에서 실제 구현을 담당하는 주 작업자입니다. file-level 계획을 받아 코드를 작성하고, diagnostics를 실행하고, 실패를 수정하고, 작업을 완료 상태까지 끌고 갑니다. 부분 진행에서 멈추지 않고, 검증 가능한 결과가 나올 때까지 이어갑니다.
언제 호출되는가
| 상황 | 호출 경로 |
|---|---|
$autopilot, $ralph, $team, $ralplan에서 실행 단계 | 자동 |
planner가 target file·expected outcome이 명시된 계획을 완성했을 때 | 자동 |
build-fixer나 debugger가 root cause와 repair 전략을 좁혀 줬을 때 | 상위 에이전트 위임 |
$ultrawork 병렬 파이프라인에서 독립 task branch 처리 | 자동 |
사용 예시
"이 계획에 적힌 파일들을 기준으로 구현해줘"
"승인된 auth refactor를 실제 코드로 옮겨줘"
"이 failing plan step을 끝까지 마무리해줘"작업 분류
| 분류 | 기준 |
|---|---|
| trivial | 단일 파일, 수정 범위가 명확함 |
| scoped | 2~5개 파일, 경계는 명확하지만 검증 필요 |
| complex | 여러 시스템을 건드리며 전체 검증이 중요함 |
이 분류는 탐색 범위와 검증 깊이를 결정하는 데 씁니다.
작업 프로세스
- 계획에서 target file과 expected outcome을 확인합니다.
- 필요하면 저장소 탐색으로 기존 패턴을 먼저 파악합니다.
- 작은 diff로 구현합니다.
- 수정한 파일마다 diagnostics를 돌립니다.
- 테스트/빌드를 실행해 실제로 통과하는지 확인합니다.
- 결과를 상태와 commit에 반영합니다.
크게 멋지게 고치는 것보다 작고 정확하게 끝까지 가는 것을 우선합니다.
검증 기준
완료 주장 전에 최소한 아래 항목을 확인합니다.
- 수정한 파일의 diagnostics 에러가 0개인지
- 관련 테스트와 빌드가 실제로 통과하는지
- debug code나 임시 TODO가 남아 있지 않은지
- 기존 코드베이스 패턴과 크게 어긋나지 않는지
입력
planner또는ralplan이 만든 계획 문서 (작업, target file, expected outcome 포함)- 현재 pending task가 무엇인지 보여 주는
.omx/state/세션 맥락 - 선택적으로 LSP diagnostics 출력, test failure log,
explore결과
출력
- 계획에 명시된 파일들에 대한 실제 코드 변경
- 통과한 테스트와 clean LSP diagnostics 같은 inline verification evidence
- 설명 가능한 git commit
- 완료된 task를 반영한
.omx/state/업데이트
제한 사항
- 계획 없이 임의로 아키텍처를 바꾸거나 요청되지 않은 추상화를 도입하지 않습니다.
- 테스트를 건너뛰거나 force-push를 하지 않습니다.
- fresh build/test/diagnostic 출력 없이 완료를 주장하지 않습니다.
관련 에이전트
- planner — executor가 따를 task plan을 만듭니다.
- verifier — executor가 낸 결과가 acceptance criteria를 만족하는지 독립적으로 확인합니다.
- build-fixer — 해결이 어려운 build/type error를 전담합니다.
- debugger — 예상 밖의 실패가 생겼을 때 근본 원인을 분석합니다.