피드로 돌아가기
Dev.toAI/ML
원문 읽기
Deterministic Workflow SDK를 통한 Coding Agent 제어 체계 구축
Atomic's Workflow SDK: Deterministically Extending Coding Agents
AI 요약
Context
Coding Agent가 개별 세션 내 작업은 능숙하나 장기적이고 복잡한 작업 수행 시 팀의 가드레일을 준수하지 못하는 한계 존재. 기존의 일반 Agent Framework는 Tool Loop와 Context Manager를 중복 구현해야 하는 오버헤드가 크며 Raw Model 기반 하네스는 구조적 제약 조건 반영이 어려움.
Technical Solution
- Coding Agent의 기존 Harness(Tool-use, Context Management)를 유지하며 외부 파이프라인을 래핑하는 TypeScript SDK 구조 설계
ctx.stage단위를 독립적인 세션(tmux pane)으로 격리하여 상태 오염 방지 및 결정론적 실행 환경 보장- Graph DSL 대신 TypeScript의
await와Promise.all을 활용하여 직렬 및 병렬 토폴로지를 정의하는 프로그래밍 방식 채택 - Stage 간 데이터 전달을 명시적인 Transcript Read 방식으로 제한하여 데이터 흐름의 투명성 확보
.compile()메서드를 통해 실행 그래프를 동결함으로써 LLM 출력 외의 모든 실행 경로를 고정- Devcontainer 기반의 샌드박스 환경을 제공하여 권한 체크 비활성화에 따른 보안 리스크 제거 및 일관된 환경 배포
실천 포인트
1. 복잡한 LLM 태스크를 원자적 단계(Atomic Stages)로 분리하고 각 단계의 입출력을 명시적으로 정의했는가
2. Agent의 자율성과 시스템의 제약 조건(Guardrails) 사이의 균형을 위해 실행 그래프를 고정(Freeze)했는가
3. 무분별한 권한 부여 대신 격리된 샌드박스 환경(Devcontainer 등)에서 자동화 루프를 실행하고 있는가
4. 병렬 실행이 필요한 지점에 `Promise.all`과 같은 표준 언어 기능을 활용해 복잡도를 낮췄는가