Claude Code가 .claude/commit-plan.json에 분리해준 커밋 단위로 변경분을 그룹화해서 보고, 그룹별/순차로 커밋하는 VSCode 익스텐션.
동작
워크스페이스 루트의 .claude/commit-plan.json을 읽어 소스 제어 뷰의 "커밋 플랜" 패널에 커밋별 그룹으로 렌더.
라이브 git status와 대조: 어느 그룹에도 없는 변경은 임시보관소(커밋 안 함), 작업트리에서 사라진 파일은 stale 표시.
그룹 인라인 버튼으로 이 그룹 커밋(인덱스 격리), 타이틀바에서 전체 순서대로 커밋.
그룹별/순차 커밋, 메시지 수정, 그룹 추가/삭제, 파일 드래그 이동, 읽음 체크박스, 파일 변경취소, 커밋 취소(단건/전체), Push / Force Push.
진행 상태(status/committedSha)는 플랜 파일에 되쓰기 → Claude가 그대로 읽음.
Claude 커맨드 설치 (필수 짝)
이 확장은 Claude Code가 플랜을 써줘야 동작해요. 확장 설치 후 명령 한 번이면 됩니다:
Cmd+Shift+P → 커밋 플랜: Claude 커맨드(/commit-plan) 설치 → 현재 워크스페이스 .claude/commands/commit-plan.md 생성.
그러면 Claude Code에서 /commit-plan 으로 변경을 커밋 단위로 분리해 .claude/commit-plan.json 을 작성할 수 있어요. (수동으로 하려면 동봉된 claude/commit-plan.command.md 를 .claude/commands/commit-plan.md 로 복사)
파일 / gitignore
.claude/commit-plan.json 을 대상 레포 .gitignore에 추가하세요.
(스키마: claude/commit-plan.schema.json. CLAUDE.md 규칙 스니펫: claude/CLAUDE.snippet.md)
개발
npm install
npm run build # esbuild 번들 → dist/extension.js
npm test # headless 단위 테스트 (로직 + 실제 git commit 시퀀스)
npm run test:e2e # 헤드리스 VSCode 통합 테스트
F5(또는 Debug: Start Without Debugging)로 Extension Development Host 실행 — test-workspace가 열립니다.
