brief

Agent와 의 이중 실행 모드가 / 병렬 코딩의 결함 격리를 실현하는 아키텍처적 차이

핵심 요약

execFileAsync는 출력을 버퍼링하여 반환하는 단순 Promise 기반 API이며 대용량 데이터와 실시간 처리에 부적합하고 에러 격리에도 한계가 있다. 반면 spawn은 스트림 기반 프로세스 객체를 제공하여 메모리 효율성과 세분화된 에러 처리라는 이중 이점을 제공하며, FanOut/FanIn 병렬 패턴에서 결함 격리와 리소스 거버넌스를 구조적으로 동시에 달성할 수 있어 바이브코딩 멀티에이전트 환경에 훨씬 유리하다.

이 글의 핵심 주장과 근거

핵심 주장

execFileAsync는 Node.js execFile를 Promise 기반 비동기 래퍼로 감싸 각 서브에이전트를 독립 PID의 격리된 자식 프로세스로 실행하며, 프로세스 종료 시 stdout/stderr를 표준화하여 부모 프로세스에 반환한다.

출처: [1] OpenClaw execFileAsync Documentation

핵심 주장

DM isolation에 의해 각 서브에이전트가 독립 네임스페이스에서 격리 실행되고, Sandbox isolation에 의해 각 에이전트가 별도 샌드박스 프로세스에서 동작하므로 서로 다른 서브에이전트가 동일한 파일을 동시에 수정하는 Race Condition이 원천 차단된다.

출처: [1] Spawning sub-agents [2] DM isolation [3] Sandbox isolation

실행 모델의 근본적 차이: 버퍼링 대 스트리밍

execFileAsync는 하위 프로세스의 stdout과 stderr 출력을 완전히 수신할 때까지 대기한 후 단일 문자열로 반환하는 동기적 완료 모델을 따른다. 이는 프로그래머에게 단순한 Promise 기반 API를 제공하지만, 내부적으로는 모든 출력을 메모리에 버퍼링해야 한다는 치명적인 제약이 존재한다. 반대로 spawn은 ChildProcess 인스턴스를 즉시 반환하고 stdout/stderr를 읽을 수 있는 읽기 가능한 스트림을 제공한다. 이 스트림은 데이터가 생성되는 대로 청크 단위로 방출되므로, 기가바이트 단위 로그나 실시간 데이터 파이프라인에서도 메모리 누수 없이 처리 가능하다. 특히 LMStudio 로컬 모델 서버에서 토큰을 스트리밍 수신할 때 spawn의 process.stdout.on('data') 콜백은 execFileAsync의 동기 완료 대기보다 현저히 낮은 지연 시간으로 피드백 루프를 구성할 수 있다.

에러 격리 전략의 아키텍처적 영향

FanOut/FanIn 병렬 패턴에서 각 하위 태스크는 독립적으로 실행되며, 일부 태스크의 실패가 전체 작업 흐름을 중단시키지 않도록 결함 격리가 필수적이다. execFileAsync를 사용할 경우 각 태스크는 개별 Promise로 감싸져 있으므로 try-catch로 개별 에러를 포착할 수는 있지만, 프로세스 자체가 강제 종료되거나 메모리 부족으로 크래시될 경우 해당 태스크의 컨텍스트 전체가 소실된다. spawn은 스트림의 'error' 이벤트를 통해 더 세분화된 에러 신호를 받으며, stdout/stderr 스트림을 별도로 처리함으로써 프로세스 실패 시에도 부분적으로 수집된 데이터를 보존할 수 있다. 또한 ACP 8단계 채널바인딩이 서브에이전트별 독립 네임스페이스를 격리함으로써 두 모드 모두 동일한 결함 격리 프레임워크 위에서 동작한다.

병렬 패턴 구현 시 실전적 고려사항

실제 FanOut/FanIn 구현에서는 Promise.all()을 사용하여 여러 execFileAsync 호출을 병렬 실행하지만, 이는 모든 태스크가 성공할 때만 결과를 반환하고 하나라도 실패하면 전체가 reject되는 단점이 있다. 반면 spawn 기반 구현은 각 ChildProcess의 스트림을 독립적으로 처리한 후 필요시 집계된 결과를 수집하는 유연성을 제공한다. 서브에이전트 풀은 pool 레벨에서 execFileAsync와 spawn에 대해 동시성 스로틀링을 적용하며, ACP 채널바인딩과 결합하여 에이전트 간 리소스 경합과 컨텍스트 분열을 방지한다. 특히 대용량 파일 처리나 긴 실행 시간이 예상되는 작업에서는 spawn의 스트림 모델을 사용하여 진행 상황 모니터링과 부분 결과 축적이 가능해지므로, 사용자 경험 측면에서도 현저히 우월하다. > 이 주제의 전체 맥락 방향성은 **바이브코딩에서 오픈클로까지** 원본 글에 세밀하게 정리되어 있습니다. 더 깊게 탐구하고 싶다면 관련 내부 대표 문서(Pillar/Entity)를 참조하세요.

자주 묻는 질문

execFileAsync와 spawn 중 어떤 것을 선택해야 하는가?

작은 출력과 단순한 명령어 실행에는 execFileAsync가 간단하고 직관적이지만, 대용량 데이터 처리나 실시간 스트리밍이 필요한 경우 spawn을 사용해야 한다. 특히 병렬 패턴에서 결함 격리가 중요한 경우 spawn의 스트림 기반 에러 처리가 유리하다.

Promise.all()과 spawn을 함께 사용할 때 주의할 점은?

Promise.all()은 모든 태스크가 성공해야 전체가 해결되므로, 일부 태스크 실패 시 전체가 중단된다. spawn 기반 구현에서는 각 ChildProcess의 스트림을 독립적으로 처리하고 Promise.race나 커스텀 에러 처리로 부분 실패를 격리하는 전략이 필요하다.

메모리 부족 오류를 피하려면 어떻게 해야 하는가?

execFileAsync는 전체 출력을 메모리에 버퍼링하므로 대용량 출력 시 OOM 위험이 있다. spawn은 청크 단위로 스트림 처리하므로 기가바이트 단위 데이터도 안전하게 다룰 수 있으며, 특히 긴 실행 시간이나 실시간 파이프라인에 필수적이다.

FanOut/FanIn 패턴에서 에러 격리를 어떻게 구현하는가?

각 하위 태스크를 독립적인 Promise로 감싸고 try-catch로 개별 에러를 포착한 후, 실패한 태스크의 결과를 별도 배열에 저장하여 전체 성공 여부와 무관하게 부분 결과를 수집한다. spawn을 사용할 경우 스트림의 error 이벤트를 별도로 처리하여 더 세분화된 격리가 가능하다.