#API-Design
2개 글
Clidex CLI UX 설계: 좋은 엔진을 좋은 제품으로 바꾸는 마지막 20%
2026-04-07TTY 감지 기반 출력 전환, score 출력 스키마 설계, exit code 의미 분리, 자동 다운로드의 부작용 관리까지 - CLI에서 사용성은 기능 추가가 아니라 설계 규칙과 계약의 문제다.
CLI UX 설계 원칙
CLI 도구의 사용성은 기능 추가가 아니라 출력 계약과 동작 규칙의 설계 문제다. TTY 감지로 사람과 기계의 출력 기본값 충돌을 해결하고, 출력 스키마를 API 계약처럼 안정적으로 유지하고, 명령의 의미에 따라 exit code를 분리하면 인간과 에이전트 모두가 예측 가능하게 사용할 수 있는 도구가 된다.