피드로 돌아가기
Dev.toAI/ML
원문 읽기
Minimal State 설계를 통한 Claude Code 토큰 소모 최적화 및 결정론적 상태 관리
Building with mini, Part 0: Why a Minimalist Orchestrator for Claude Code
AI 요약
Context
기존 Orchestration 도구들의 과도한 문서 누적 및 반복적 Context 주입으로 인한 토큰 비용 급증 문제 발생. 세션 반복에 따른 컨텍스트 비대화가 시스템 효율성을 저해하는 병목 지점으로 작용.
Technical Solution
- Minimal State 원칙 기반의 project.md 및 state.json 분리 구조 설계
- 전체 레포지토리 주입 대신 필요한 파일만 직접 읽는 On-demand Reading 방식 채택
- Phase별 상세 정보를 독립적으로 관리하여 호출 시점에만 로드하는 Context Isolation 구현
- 상태 변경 로직을 LLM 프롬프트가 아닌 테스트 완료된 TypeScript 코드로 강제하여 Hallucination 방지
- Next → Plan → Do → Done으로 이어지는 정형화된 Main Loop를 통한 워크플로우 제어
실천 포인트
- LLM에 모든 상태 업데이트를 맡기지 말고 검증된 코드(TypeScript 등)로 상태 전이를 구현했는가 - 컨텍스트 윈도우 최적화를 위해 전체 데이터가 아닌 필요한 부분만 로드하는 On-demand 전략을 적용했는가 - 프로젝트 메타데이터(상태, 설정)와 실제 작업 데이터(상세 내용)를 물리적으로 분리하여 관리하는가