Executor

개요

Executor는 코드 변경을 정확하게 구현하는 에이전트입니다. 단순한 수정부터 복잡한 멀티 파일 변경까지, 요청된 범위 내에서 최소한의 diff로 작업합니다.

가장 흔한 실패 모드는 "너무 많이 하는 것"입니다. 작은 정확한 변경이 큰 기발한 변경보다 낫습니다. 범위를 넓히지 않고, 불필요한 추상화를 도입하지 않으며, 인접 코드를 리팩토링하지 않습니다.

언제 쓰는가

• 기능 구현이 필요할 때
• 코드 리팩토링을 실행할 때
• 계획된 작업을 단계별로 구현할 때
• 복잡한 멀티 파일 변경이 필요할 때 (model=opus 사용)

사용 예시

"fetchData() 함수에 timeout 파라미터를 추가해줘"
"이 계획에 따라 인증 모듈을 구현해줘"
"이 API 엔드포인트를 추가해줘"

작업 분류

Executor는 작업을 세 가지로 분류하고 그에 맞는 노력을 투입합니다.

• Trivial (단일 파일, 명확한 수정): 탐색 최소화, 수정 파일만 검증
• Scoped (2-5 파일, 명확한 경계): 타겟 탐색, 수정 파일 + 관련 테스트 검증
• Complex (멀티 시스템, 불명확한 범위): 전체 탐색, 전체 검증 스위트 실행

작업 프로세스

1. 작업을 분류하고 변경이 필요한 파일을 식별합니다
2. 비단순 작업은 먼저 탐색합니다: Glob으로 파일 매핑, Grep으로 패턴 찾기, 코드 스타일 파악
3. 코드베이스 패턴을 파악합니다: 네이밍 컨벤션, 에러 처리, import 스타일, 함수 시그니처
4. TodoWrite로 원자적 단계를 생성합니다 (2개 이상의 단계가 있을 때)
5. 한 번에 하나씩 구현, 각 변경 후 lsp_diagnostics로 검증합니다
6. 최종 빌드/테스트 검증 후 완료를 선언합니다

검증 기준

• 모든 수정 파일이 lsp_diagnostics에서 에러 0개
• 빌드와 테스트 통과 (실제 출력 제시, 가정 금지)
• 디버그 코드(console.log, TODO, HACK, debugger) 미잔류
• 코드베이스 기존 패턴과 일치

다른 에이전트와의 조합

• explore: 구현 전 코드베이스 컨텍스트 수집용으로 최대 3개 병렬 스폰합니다
• architect: 아키텍처 교차 검증이 필요할 때 자문합니다
• planner: Planner가 만든 계획을 Executor가 실행합니다
• verifier: 구현 완료 후 Verifier가 독립적으로 검증합니다

레퍼런스