angel291592/Intent-Router

해결하는 문제

AI 에이전트에서 흔히 발생하는 "추측"과 "끝없는 질문"을 제거합니다. 에이전트가 사용자의 의도를 추측하거나 수십 가지 질문을 하는 대신, 이 도구는 컴파일러가 코드를 처리하는 방식으로 의도를 처리합니다. 기존 데이터(코드, 문서, 티켓)를 탐색하여 모호함을 해결하고, 인간의 판단이 진정으로 필요한 질문만 딱 한 번 수행하며, 요청이 너무 모호하면 실행을 거부합니다.

작동 방식

요청을 세 단계로 처리합니다:

1. 파싱 (Parse): 요청을 초안 IntentSpec(구조화된 계획)으로 변환하고 누락된 정보를 식별합니다.
2. 해결 (Resolve): 누락된 모든 정보를 분류합니다. 답변이 리포지토리, 문서 또는 로그에 있으면 자동으로 탐색합니다. 인간의 결정(트레이드오프나 되돌릴 수 없는 작업 등)이 필요한 경우에만 정확히 한 번 질문합니다.
3. 타입 체크 및 출력 (Typecheck & Emit): 요청이 불충분하면 중단합니다. 진행할 경우, 기계가 읽을 수 있는 IntentSpec 파일을 저장하여 향후 세션을 위한 계약 역할을 수행하며, 에이전트가 결정 사항을 "잊지" 않도록 보장합니다.

대상 사용자

기존 프로젝트 제약 조건을 존중하고, 불필요한 사용자 개입을 피하며, 세션 간에 결정 사항에 대한 지속 가능하고 검증 가능한 기록을 유지하는 더 신뢰할 수 있는 AI 에이전트를 구축하려는 개발자 및 팀.

주요 특징

• 자동 탐색 (Automated Probing): 리포지토리, git 기록, 문서를 자동으로 검색하여 질문에 답변함으로써 사용자를 번거롭게 하지 않습니다.
• 지속 가능한 계약 (Persistent Contracts): 모든 의도를 .intent.yaml 파일로 저장하여, 향후 에이전트나 팀원이 처음부터 시작하는 대신 확립된 결정 사항부터 작업을 시작할 수 있게 합니다.
• 안전 게이트 (Safety Gates): 요청이 모호하거나 되돌릴 수 없는 경계에 닿는 경우 실행을 거부하여 에이전트가 위험한 "추측"을 하지 못하도록 방지합니다.
• 검증 (Verification): 최종 결과물을 원본 IntentSpec과 대조하여 에이전트가 합의된 제약 조건을 실제로 준수했는지 확인합니다.
• 제로 설치 (Zero-Install): 복잡한 인프라 없이 기존 에이전트 워크플로우에 추가할 수 있는 휴대용 스킬로 설계되었습니다.