자주 묻는 질문
처음 온 사람들이 가장 많이 묻는 질문에 대한 짧은 답변.
mini-orchestrator란 무엇인가요?
프로젝트를 한 번에 하나의 검증 가능한 단계씩 진행시키는 작은 CLI로, Claude Code 세션 안에서 바로 동작합니다. mini는 프로젝트 상태를 보관하고 알맞은 프롬프트를 출력하며, 실제 작업은 Claude가 합니다. 시작하기 페이지에서 처음부터 끝까지 안내합니다.
어떻게 설치하나요?
npm에서 전역으로 설치하세요: npm install -g mini-orchestrator@latest. Node.js 20 이상과 작동하는 Claude Code 설정이 필요합니다. 전역 설치를 하면 /mini:* 슬래시 명령이 Claude Code에 자동으로 연결됩니다.
Claude 모델은 어떻게 고르나요?
mini model을 실행하면 현재 모델을 볼 수 있고, mini model <name>으로 프로젝트에 설정할 수 있습니다. mini는 선택을 프로젝트 상태에 저장하므로, 바꾸기 전까지 모든 단계가 같은 모델을 사용합니다.
단계 루프란 무엇인가요?
각 단계는 next(제안) → plan(스텝으로 나누기) → do(구현) → done(작동 확인)을 거칩니다. 선택 스텝 두 개가 들어갑니다: 계획 전의 discuss와, 사람이 하는 UI/UX 리뷰인 verify.
auto 모드는 무엇을 하나요?
mini auto는 next → plan → do → done을 연달아 이어 붙여, 각 스텝을 손으로 실행하지 않고도 단계 전체를 끝냅니다. 그래도 사람 확인 지점 — 다음 단계 제안, verify 리뷰, 마지막 "작동하나요?" — 에서는 멈춥니다. --max-phases로 여러 단계를 한 번에 실행하세요.
아직 막혔나요?
각 명령에는 매뉴얼에 전용 페이지가 있으며, 터미널 형태와 /mini:* 슬래시 형태를 모두 담고 있습니다. 소스 코드와 이슈 트래커는 GitHub에 있습니다.