터미널 기반 AI 코딩 에이전트 구축: 프레임워크, 활용 도구, 컨텍스트 엔지니어링 및 학습된 교훈

Building AI Coding Agents for the Terminal: Scaffolding, Harness, Context Engineering, and Lessons Learned

AI 코딩 지원 분야는 복잡한 IDE 플러그인에서 벗어나 다재다능하고 터미널 환경에 최적화된 에이전트로 근본적인 변화를 겪고 있습니다. 개발자들이 소스 제어를 관리하고, 빌드를 실행하며, 환경을 배포하는 곳에서 직접 작동하는 CLI 기반 에이전트는 장기적인 개발 작업에 대한 전례 없는 수준의 자율성을 제공합니다. 본 논문에서는 이 새로운 패러다임에 특화된 오픈 소스 명령줄 코딩 에이전트인 OPENDEV를 소개합니다. 효과적인 자율적 지원을 위해서는 엄격한 안전 제어와 고효율 컨텍스트 관리가 필요하며, 이는 컨텍스트 과부하 및 추론 성능 저하를 방지하기 위함입니다. OPENDEV는 워크로드에 특화된 모델 라우팅, 계획 및 실행을 분리한 이중 에이전트 아키텍처, 지연된 도구 검색, 그리고 오래된 정보를 점진적으로 축소하는 적응형 컨텍스트 압축을 통해 이러한 과제를 해결합니다. 또한, 프로젝트별 지식을 세션 간에 누적하는 자동 메모리 시스템을 활용하여, 이벤트 기반 시스템 알림을 통해 지시 사항을 잊지 않도록 합니다. 명시적인 추론 단계를 적용하고 컨텍스트 효율성을 우선시함으로써, OPENDEV는 터미널 우선 AI 지원을 위한 안전하고 확장 가능한 기반을 제공하며, 강력한 자율 소프트웨어 엔지니어링을 위한 청사진을 제시합니다.

The landscape of AI coding assistance is undergoing a fundamental shift from complex IDE plugins to versatile, terminal-native agents. Operating directly where developers manage source control, execute builds, and deploy environments, CLI-based agents offer unprecedented autonomy for long-horizon development tasks. In this paper, we present OPENDEV, an open-source, command-line coding agent engineered specifically for this new paradigm. Effective autonomous assistance requires strict safety controls and highly efficient context management to prevent context bloat and reasoning degradation. OPENDEV overcomes these challenges through a compound AI system architecture with workload-specialized model routing, a dual-agent architecture separating planning from execution, lazy tool discovery, and adaptive context compaction that progressively reduces older observations. Furthermore, it employs an automated memory system to accumulate project-specific knowledge across sessions and counteracts instruction fade-out through event-driven system reminders. By enforcing explicit reasoning phases and prioritizing context efficiency, OPENDEV provides a secure, extensible foundation for terminal-first AI assistance, offering a blueprint for robust autonomous software engineering.