시작하기
mini CLI 설치부터 첫 단계 실행까지, 몇 개의 명령으로.
시작하기 전에
Node.js 20 이상과 작동하는 Claude Code 설정이 필요합니다. mini는 Claude Code 위에 올라갑니다. 프로젝트 상태를 보관하고 알맞은 프롬프트를 출력하며, 실제 작업은 세션 안에서 Claude가 합니다.
설치
npm에서 CLI를 전역으로 설치하세요. 명령 이름은 mini입니다:
npm install -g mini-orchestrator@latest전역 설치를 하면 /mini:* 슬래시 명령이 Claude Code에 자동으로 연결됩니다. 업데이트하려면 같은 명령을 다시 실행하세요. 로컬이나 CI 설치에서는 mini install-commands를 한 번 수동으로 실행하세요.
첫 프로젝트
프로젝트 폴더를 만들고 mini가 한 단계씩 진행하도록 두세요. 폴더 안에서 다음을 실행합니다:
mkdir my-project && cd my-project
mini init # 질문 4개 → .mini/project.md와 .mini/state.json 생성
mini next # Claude가 첫 단계를 제안
mini do # 그 단계에서 Claude Code 세션 시작
mini done # "작동하나요?" → 상태를 전진시킴
- mini init 질문 4개에 답하면 mini가 프로젝트 상태를 .mini/에 기록합니다.
- mini next Claude가 작고 검증 가능한 단계를 제안합니다.
- mini discuss 선택. 까다로운 단계를 계획 전에 논의합니다.
- mini do Claude Code 세션이 단계를 구현합니다.
- mini done 작동을 확인하면 상태가 전진합니다.
Claude Code 안에서: 슬래시 명령
각 스텝에는 Claude Code 세션 안에서 실행하는 네이티브 /mini:* 슬래시 형태도 있습니다 — mini가 프롬프트를 출력하고, Claude가 작업한 뒤 상태를 다시 저장합니다. 선택 스텝(discuss, verify)은 점선입니다. 명령을 클릭하면 문서가 열립니다:
- /mini:init 질문 4개에 답하면 mini가 프로젝트 상태를 .mini/에 기록합니다.
- /mini:next Claude가 작고 검증 가능한 단계를 제안합니다.
- /mini:discuss 선택. 까다로운 단계를 계획 전에 논의합니다.
- /mini:plan 단계를 구체적이고 확인 가능한 스텝으로 나눕니다.
- /mini:do Claude Code 세션이 단계를 구현합니다.
- /mini:verify 선택. 사람이 하는 심층 UI/UX 리뷰.
- /mini:done 작동을 확인하면 상태가 전진합니다.
두 형태는 같은 일을 합니다 — 지금 어디 있는지에 따라 터미널 명령이나 슬래시 형태를 고르세요. 각 명령에는 두 형태를 모두 다루는 전용 페이지가 매뉴얼에 있습니다.
auto 단축
손대지 않고 하고 싶나요? mini auto는 next → plan → do → done을 연달아 이어 붙이고, 마지막에 "작동하나요?"만 묻습니다. 슬래시 형태 — /mini:auto — 도 있어 Claude Code 세션 안에서 루프를 실행할 수 있습니다:
- mini auto 터미널에서 루프 전체를 실행합니다.
- /mini:auto Claude Code 세션 안에서 루프를 실행합니다.