투명한 설계의 터미널 에이전트 'Heirloom' 공개
에이전트의 결정 과정을 추적할 수 있도록 설계된 오픈소스 아키텍처.
요약
오픈소스 터미널 코딩 에이전트 'Heirloom' 개발자가 기존 에이전트의 불투명한 작동 방식에 의문을 갖고, 코드 전 과정을 완전히 이해할 수 있는 에이전트를 직접 구축했다. 이 프로젝트는 각 계층이 독립적으로 작동하는 7단계 구조(providers → tools → ReAct loop → context → safety → modes → TUI)를 채택해 유지보수와 디버깅 효율을 극대화했다. 소스 코드는 약 21.9k 라인, 테스트 코드는 약 22.4k 라인으로 구성되었으며, 모든 설계 결정 사항을 배포 전 문서화하여 투명성을 확보했다. 특히 외부 텔레메트리 기능을 완전히 배제하고 사용자가 선택한 공급자와만 통신하도록 설계하여 보안과 제어권을 강화했다. 이러한 모듈식 설계를 통해 개발자는 버그 발생 시 문제 경로를 즉각적으로 파악하고 해결할 수 있는 환경을 구축했다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 I built a terminal coding agent I could actually read end-to-end. Here's what "understandable" cost me.
원문 보기 ↗