AI 에이전트 개발, 과정은 버리고 결과에 집중!
AI 코딩 에이전트(AI Coding Agent)의 실행 과정을 지켜보는 대신, 산출물 검토로 개발 병목 현상을 해결
Plan, Test Case, Code 세 가지 산출물을 정의하고, Orchestrator-Executor 패턴을 도입하여 병렬 개발 환경 구축
자동화된 테스트(Automated Test)를 통해 코드 품질을 확보하고, 개발자가 결과 검증에 집중하도록 유도
Git Worktree와 격리된 실행 환경(Isolated Execution Environment)을 구축하여 코드 충돌 및 환경 간섭 문제를 해결
ADD의 핵심: 산출물 기반 개발
본문은 AI 에이전트(AI Agent)가 생성한 산출물(Artifact), 즉 Plan, Test Case, Code에 집중하는 개발 방식인 Artifact Driven Development(ADD)를 소개한다. ADD는 에이전트의 실행 과정을 관찰하는 대신, 산출물 검토를 통해 개발 생산성을 향상시킨다.
Plan: 구현 명세(Implementation Specification), 맥락 복구 메커니즘(Context Recovery Mechanism) 역할
Test Case: 자동화된 테스트(Automated Test)를 통해 코드 품질 보장
Code: 에이전트가 생성한 실제 코드
ADD는 개발자가 에이전트의 작업 과정을 일일이 확인하는 병목 현상을 해결하고, 병렬 개발을 가능하게 한다.
Orchestrator-Executor 패턴: 병렬 개발의 핵심
ADD에서 Orchestrator-Executor 패턴은 여러 AI 에이전트의 작업을 조율하고 실행하는 핵심 구조이다. Orchestrator는 Executor에게 스크립트 기반의 정형화된 디스패치를 통해 작업을 지시하며, 이는 사람의 주관적인 판단을 배제하고 일관성을 유지하는 데 기여한다.
스크립트 기반 디스패치: Plan 문서, TC 목록, 코딩 컨벤션(Coding Convention), 현재 상태 정보를 조합하여 일관된 형식으로 전달
고도화 용이성: 스크립트와 템플릿을 통해 개선 지점을 명확하게 파악하고, 지속적인 개선(Continuous Improvement)을 가능하게 함
Orchestrator-Executor 패턴은 AI 에이전트의 병렬 실행을 가능하게 하고, 개발 생산성을 극대화하는 데 기여한다.
자동화된 테스트(Automated Test)의 중요성
ADD에서 자동화된 Test Case(TC)는 코드 품질을 보장하고, 개발자가 결과 검증에 집중할 수 있도록 돕는 핵심 요소이다. 에이전트가 구현을 완료하면 자동으로 TC가 실행되고, 실패 시 스스로 수정하고 재시도하는 과정을 반복한다.
TC의 역할: 구현의 정확성 검증(Verification), 완료 기준 제시
TC의 특징: API 호출, 상태 폴링, DB 확인 등 구체적인 시나리오(Concrete Scenario)로 구성
TC 자동화의 효과: 개발자는 TC 결과만 확인하고 다음 단계로 진행 가능
자동화된 TC는 개발 프로세스의 효율성을 높이고, 코드 품질을 향상시키는 데 기여한다.
격리된 실행 환경 구축: 코드 충돌 방지
ADD에서는 여러 기능을 동시에 개발하기 위해, 각 기능의 코드와 실행 환경이 서로 간섭하지 않도록 격리된 환경을 구축한다. Git Worktree를 사용하여 코드 분리를, 서버 포트, DB, 빌드 캐시를 분리하여 실행 환경 격리를 구현한다.
Git Worktree: 코드 분리(Code Isolation)를 위한 기능, 기능별 독립된 작업 디렉터리 생성
환경 격리: 서버 포트, 테스트 DB, 빌드 출력 경로 분리
효과: 기능별 독립적인 테스트(Independent Testing) 가능, 코드 충돌 방지
격리된 실행 환경은 병렬 개발의 안정성을 높이고, 개발 효율성을 향상시키는 데 기여한다.
ADD 도입의 시사점: 개발 생산성의 본질
본문은 ADD 도입을 통해 개발 생산성의 본질이 AI 에이전트를 똑똑하게 만드는 데 있는 것이 아니라, 개발자가 검토해야 할 단위를 명확한 산출물로 고정하는 데 있음을 강조한다. 개발자는 과정 대신 산출물에 집중함으로써, 병렬 개발의 효율성을 극대화할 수 있다.
핵심: 과정 관찰(Process Observation) 최소화, 산출물 검토에 집중
결과: 개발 생산성 향상, 병렬 개발 효율 증대
ADD는 AI 에이전트 기반 개발 방식의 성공적인 사례를 제시하며, 개발 생산성 향상을 위한 새로운 접근 방식을 제시한다.
