Prompt 의존성을 제거한 Executable Contract 기반 AI Agent 인터페이스 설계

Context

기존 AI Agent 도구들이 README나 단순 Prompt 기반의 암묵적 계약(Implicit Contract)에 의존함에 따라 발생하는 동작 불일치 및 인터페이스 파괴 문제 분석. 인간의 컨텍스트 보정 능력과 달리 Agent는 모호한 자연어 명세로 인해 런타임 오류 및 잘못된 코드 변경을 유발하는 한계 직면.

Technical Solution

• CLI를 단순 래퍼가 아닌 Protocol Layer로 재정의하여 Agent가 직접 실행 및 검증 가능한 Explicit Contract 구축
• describe 명령어를 통한 프로토콜 루트(버전, 역량, 비용 모델, 불변성)의 JSON 형태 노출로 Agent의 자가 발견(Self-discovery) 가능 구조 설계
• schema 명령어를 통해 출력 데이터의 JSON Schema를 제공함으로써 인터페이스 변경 사항을 정적으로 추적하고 검증하는 메커니즘 도입
• 텍스트 기반의 'Pretty Output'을 배제하고 기계 판독이 가능한 Structured Output 및 엄격한 Exit Code 체계를 통한 결정론적 상태 관리
• Local-first Rust 기반의 entropyx 구현을 통해 Git 히스토리 분석 결과와 증거(Evidence)를 로컬에서 직접 검증하는 파이프라인 구축