modiqo/cliare

What it solves

CLIARE(CLI Agent Readiness Evaluation)는 명령줄 인터페이스의 실제 런타임 동작이 문서나 도움말 텍스트와 다른 "CLI 드리프트" 문제를 해결합니다. 이 드리프트 때문에 AI 에이전트는 명령과 플래그를 반복적으로 추측하며 토큰과 지연 시간을 낭비합니다. 또한 보안 검토자가 겉보기에 안전한 탐색 명령 중에 발생하는 예기치 않은 파일 쓰기와 같은 문서화되지 않은 부작용을 식별하는 데 도움을 줍니다.

How it works

CLIARE는 CLI 바이너리를 블랙박스로 취급하고 제한된 제어 하에 프로빙합니다. 정적 문서에 의존하지 않고, 다양한 컨텍스트(클린, 인증된, 혹은 fixture 기반)에서 바이너리를 실행해 실제 존재하는 명령, 안전한 플래그, 출력이 머신 파싱 가능(JSON/YAML)한지를 기록합니다. 그런 다음 명령 인덱스와 일련의 보고서(스코어카드, 이슈 원장, 페르소나별 패킷)를 생성해 CLI의 실제 표면을 매핑합니다.

Who it’s for

• CLI Maintainers: 도움말 커버리지, 진단, 출력 계약의 격차를 파악해 도구를 에이전트 친화적으로 만듭니다.
• Security Reviewers: 바이너리를 자율 에이전트에 노출하기 전에 문서화되지 않은 런타임 동작과 지속적인 부작용을 감지합니다.
• Agent Harness Builders: 증거 기반 명령 인덱스를 확보해 에이전트가 시도와 오류를 통해 구문을 다시 발견하지 않고도 올바른 명령으로 라우팅할 수 있게 합니다.

Highlights

• Evidence-Based Mapping: 손으로 작성한 문서가 아니라 런타임 증거를 기반으로 command-index.json을 생성합니다.
• Black-Box Probing: 격리된 환경이나 호스트별 컨텍스트에서 바이너리를 측정해 부작용을 탐지합니다.
• Agent-Ready Artifacts: AGENT_SKILL.md와 페르소나 보고서를 생성해 에이전트 행동을 안내합니다.
• Surface Querying: 하니스가 의도-명령 라우팅 답변을 조회할 수 있는 도구를 제공합니다.
• CI Integration: GitHub Action을 포함해 준비도 감사를 자동화하고 릴리즈 게이트를 생성합니다.