Shell 기반 Hook 시스템 설계로 AI Agent 확장성 및 제어력 확보

Context

AI Agent의 기능 확장 시 하드코딩으로 인한 Configuration Ballast 문제 발생. TS Plugin이나 Middleware 방식의 높은 진입장벽과 오버헤드를 해결하기 위한 유연한 확장 구조 필요.

Technical Solution

• Shell Command 기반 Hook 설계를 통한 언어 독립적 환경 및 사용자 터미널 도구와의 결합성 확보
• Gating(PreToolUse, UserPromptSubmit)과 Observing(PostToolUse, Stop) 두 가지 이벤트 카테고리로 구분한 권한 제어
• Gating 이벤트에 5초의 Tight Timeout을 적용하여 시스템 전진 흐름의 병목 최소화
• Observing 이벤트에 30초의 넉넉한 Timeout을 할당하여 비동기 처리 효율성 증대
• JSON stdin 입력과 Exit Code(0: Pass, 2: Block) 기반의 단순하고 명확한 통신 프로토콜 채택
• 세션 시작/종료 및 토큰 단위 스트리밍 등 고비용 혹은 쉘 수준에서 해결 가능한 이벤트 과감히 제거