Skip to content

PRD.md

Latest commit

 

History

History
120 lines (84 loc) · 5.24 KB

PRD.md

File metadata and controls

120 lines (84 loc) · 5.24 KB

Universal CLI Config & Command Builder Platform — PRD

목적: AI SDK 프로바이더를 기반으로 각 LLM CLI의 고유 옵션을 정확히 매핑하고, 도구별 특화된 세션 로그를 깊이 있게 해석하여 최소한의 인터페이스로 최적의 실행 환경을 제공하는 플랫폼의 PRD입니다.

버전: 2.4.0 | 작성일: 2026-02-19

목차

  1. 제품 개요
  2. 시스템 아키텍처
  3. 데이터 모델
  4. IPC API 명세
  5. 백엔드 서비스
  6. 파서 및 유틸리티
  7. 프론트엔드 페이지 명세
  8. 공유 컴포넌트
  9. 비즈니스 워크플로우
  10. 설정 및 환경
  11. 테스트 전략
  12. 구현 우선순위 로드맵
  13. 부록

1. 제품 개요

1.1 비전

다양한 LLM CLI 도구의 **고유한 옵션 체계(Flags/Options)**를 정확히 식별하고, 각 도구가 생성하는 **세션 데이터의 특성(Thinking, Metadata, Tool-use)**을 깊이 있게 해석하여 보여주는 정밀한 CLI 개발 보조 도구.

1.2 핵심 가치

가치 설명
해석의 깊이 도구별(Claude, Gemini 등) 세션 로그의 고유 구조를 완벽히 이해하고 시각화
옵션의 정확성 각 CLI에서 실제 사용 가능한 최신 옵션을 UI에 매핑하여 실행 오류 최소화
미니멀리즘 복잡한 기능 대신, '옵션 선택 후 실행 및 해석'이라는 핵심 흐름에 집중
유연한 확장 새로운 CLI 도구 및 프로바이더 규격에 즉시 대응 가능한 스펙 중심 설계

1.4 기능 카탈로그 (핵심 기능 중심)

# 카테고리 기능 설명 우선순위
1 세션 해석 도구별 세션 디코더 각 CLI 도구의 세션 로그 형식을 분석하여 구조화된 대화 및 내부 프로세스(Thinking 등) 시각화 P1
2 옵션 관리 동적 옵션 매핑 각 CLI 바이너리의 도움말 및 프로바이더 스펙을 기반으로 UI 옵션 패널 구성 P1
3 MCP 설정 멀티 CLI MCP 확장 로컬 MCP 설정을 각 도구별 환경 설정 파일 규격에 맞춰 자동 확장 및 배포 P1
4 실행 제어 미니멀 Execute 페이지 도구 선택, 필수 옵션 입력, 실시간 스트림 해석에 집중한 통합 실행 환경 P2
5 프로젝트 통합 프로젝트 뷰 도구별 로그 저장 위치를 감시하여 세션 이력을 통합 조회하고 검색 P2

3. 데이터 모델

3.1 CLIToolInterpreter (세션 해석 스펙)

interface CLIToolInterpreter {
  toolId: string;
  logParser: (raw: string) => ParsedSession; // 로그 라인별 해석 로직
  metadataMapper: (data: any) => SessionMeta; // 도구별 특화 메타데이터 매핑
  eventTypes: string[]; // 해당 도구가 발생시키는 이벤트 종류 (예: 'thinking', 'call', 'result')
}

3.2 CLIOptionSchema (옵션 추출 스펙)

interface CLIOptionSchema {
  flag: string;
  type: 'string' | 'boolean' | 'number' | 'choice';
  validation: RegExp | string; // 옵션 값 유효성 검증
  isContextRequired: boolean; // 프로젝트 문맥 필요 여부
}

5. 백엔드 서비스

5.1 SessionInterpreterService (P1)

역할: 단순히 로그를 읽는 것을 넘어, CLIToolInterpreter를 사용하여 각 도구가 세션을 어떻게 구성하고 진행하는지(State-machine)를 추적하고 해석합니다.

5.2 OptionInventoryManager (P1)

역할: 각 CLI 도구가 지원하는 옵션 리스트를 관리합니다. 프로바이더의 사양 변경이나 CLI 버전 업데이트에 따른 옵션 변화를 감지하고 매핑합니다.

5.3 MultiCliExecutionService (P2)

역할: AI SDK와 프로바이더를 통해 조합된 옵션으로 CLI를 실행하고, 발생하는 스트림 데이터를 실시간으로 Interpreter에 전달합니다.

7. 프론트엔드 페이지 명세

7.1 미니멀 Execute 페이지 (/)

  • 도구 선택: 현재 설치된 CLI 도구 리스트 표시.
  • 옵션 패널: 선택된 도구의 CLIOptionSchema에 따라 동적으로 구성된 입력 폼 (필수/선택 구분).
  • 해석된 스트림 뷰: Interpreter가 처리한 데이터를 기반으로, 도구 특색에 맞는 실시간 렌더링 (예: Claude는 Thinking 과정을 별도 접이식 영역으로 표시).

12. 구현 우선순위 로드맵

Phase 1: 세션 해석 및 옵션 매핑 인프라 (P1)

  • 도구별 세션 해석 로직(Interpreter) 및 옵션 스키마(Schema) 정의
  • AI SDK 프로바이더 기반 통합 인터페이스 구축
  • 멀티 CLI 로컬 MCP 설정 확장 도구 고도화

Phase 2: 미니멀 실행 환경 및 통합 대시보드 (P2)

  • 스키마 기반 동적 옵션 UI 및 실행 엔진 구축
  • 도구별 특화 규격에 맞춘 세션 로그 뷰어 고도화
  • 실시간 해석 엔진 연동

문서 끝