Claude Code의 토큰 효율성을 높이는 K9-Claude-Framework

섹션별 상세

Claude Code 사용 시 단일 project-state.md 파일이 비대해지면 세션 시작마다 20k 토큰 이상을 소모하는 문제가 발생한다. 작성자는 이를 해결하기 위해 프로젝트 상태를 4개의 파일로 분리하는 전략을 제안했다.

분리된 파일은 대시보드 역할을 하는 project_state.md, 작업 목록인 project_backlog.md, 결정 사항 기록인 project_decisions.md, 아키텍처 참조용 project_arch.md로 구성된다. 각 파일은 정보의 변경 빈도에 따라 구분되어 필요한 시점에만 로드된다.

작성자는 /init-project, /wrap-up, /check-init 등 3개의 커스텀 슬래시 커맨드를 구현했다. 이 커맨드들은 쉘 스크립트로 작성되어 별도의 SDK나 의존성 없이 작동하며, 파일 크기 제한과 Git 기반의 변경 사항 검증을 강제한다.

언급된 도구

Claude Code추천

CLI 기반 AI 코딩 에이전트

언급된 리소스

GitHubK9-Claude-Framework GitHub