대부분의 AI 프로그래밍 도구는 단 하나의 Agent가 한 가지 일만 수행하도록 만듭니다. Maestro-Flow는

여러 Agent가 브레인스토밍부터 배포 및 출시까지의 전체 프로세스를 협업하여 완료할 수 있도록 합니다. 적응형 결정 엔진(Adaptive Decision Engine)은 실제 결과에 따라 전략을 동적으로 조정하며, 지식 그래프(Knowledge Graph)는 매 실행 시의 경험을 다음 실행을 위해 자동으로 축적합니다.

적응형 오케스트레이션 (Adaptive Orchestration) — Ralph v2 엔진이 프로젝트 상태를 읽어 자연어 의도를 40개 이상의 명령 체인(Command Chains)으로 분류하며, 핵심 노드에서 실제 실행 결과에 따라 계속 진행, 되돌아가기, 또는 수정 루프 삽입 여부를 동적으로 결정합니다. YAML을 작성하거나 파이프라인을 구성할 필요가 없습니다.

크로스 백엔드 스케줄링 (Cross-Backend Scheduling) — 동일한 워크플로우 내에서 Claude, Codex, Gemini, Qwen, OpenCode를 혼용할 수 있으며, 네 가지 오케스트레이션 모드를 필요에 따라 조합할 수 있습니다: Delegate(비동기 위임), Team(역할 협업), Wave(의존성 병렬), Swarm(군집 탐색).

지식 자가 강화 (Knowledge Self-Enhancement) — Agent가 실행 중에 발견한 패턴, 함정, 결정 사항은 Spec 및 Knowhow로 자동 영구 저장됩니다. Hook 시스템은 관련 지식을 후속 Agent의 프롬프트(Prompt)에 주입하여, 프로젝트를 사용할수록 점점 더 똑똑해집니다.

장기 주기 자가 교정 (Long-cycle Self-correction) — Odyssey 시리즈 명령은 수 시간 단위의 자율 루프를 실행하며, 각 체크포인트에서 수락 기준을 충족할 때까지 전략을 적응적으로 조정합니다.

npm install -g maestro-flow
maestro install # 대화형 컴포넌트 설치 선택

Node.js ≥ 18 및 Claude Code CLI가 필요합니다. 멀티 Agent 워크플로우를 위해 Codex CLI, agy CLI를 선택적으로 설치할 수 있습니다.

메인 엔트리(Main Entry). 목표를 말하면 Ralph가 자동으로 개발 단계를 판단하고, 빌드 명령 체인을 구축하며, decision 노드에서 동적으로 조정합니다:

/maestro-ralph-v2 "OAuth2 인증 구현, refresh token 지원"
# Ralph가 자동으로 체인 구축: analyze → plan → execute → verify → review → test
# 실패 발생 시 → 자동으로 debug → fix → retry 루프 삽입
...

/maestro-ralph-v2 status # 현재 세션 진행 상황 확인
/maestro-ralph-v2 continue # decision 일시 중지 지점부터 재개
/maestro-ralph-v2 -y "..." # 확인 절차 없는 완전 자동 모드

의도 입력 → Ralph 분류 (40+ 체인 유형)
│
▼
...

세 가지 품질 모드로 파이프라인의 깊이를 제어합니다:

/maestro "사용자 프로필 페이지 추가" # 의도 라우팅, 체인 자동 선택
/maestro-quick "리다이렉트 버그 수정" # 최단 경로: plan → execute → verify

대규모 디버깅, 심층 리팩토링, UI 최적화 등 지속적인 반복 작업이 필요한 시나리오에 적합합니다:

각 Odyssey 명령은 수락 기준이 달성될 때까지 지속적으로 실행되며, 중간에 전략을 적응적으로 조정하고 발견된 지식은 자동으로 영구 저장됩니다.

기술 스택 (Tech Stack) Commander.js · MCP SDK · better-sqlite3 · web-tree-sitter · React 19 · Zustand · Tailwind CSS 4 · Hono · Vite 6

디렉토리 구조

maestro/
├── src/ # 핵심 CLI (Commander.js + MCP SDK)
│ ├── commands/ # 35+ CLI 명령
...

유사 도구 비교

각자의 강점: Superpowers는 프롬프트 엔지니어링 방법론이 가장 성숙하며, OpenSpec은 요구사항 사양화가 가장 엄격하고, Trellis는 멀티 플랫폼 통합이 가장 뛰어나며, Maestro-Flow는 전체 생명주기 오케스트레이션, 크로스 백엔드 스케줄링 및 지식 자가 강화에 집중합니다.

GET SHIT DONE— 사양(Spec) 기반 개발 및 컨텍스트 엔지니어링 철학
Claude-Code-Workflow— 전신 프로젝트, 멀티 CLI 오케스트레이션 개척
Impeccable— UI 디자인 스킬 (Apache-2.0)