Gran Maestro
한국어 | English
"I am the Maestro — I conduct, I don't code."
AI에게 모호한 요청을 던지면 빠르게 엉뚱한 결과가 나옵니다.
필요한 건 코드를 짜기 전, AI와 함께 계획을 세우는 단계입니다.
Gran Maestro는 그 계획 수립 단계에서 AI를 사고 파트너로 만들고, 검증된 계획을 자동으로 구현까지 이어주는 plan 중심 end-to-end AI 오케스트레이션 플랫폼입니다.
/plugin marketplace add myrtlepn/gran-maestro
Q&A 계획 수립 | 다각도 브레인스토밍 | 팀 토론 | UI 시각화 | 코드 탐색
가장 중요한 것은 계획입니다. 기존 스펙 문서나 PRD는 작성과 구현 사이에 단절을 만듭니다. 문맥이 끊긴 채 구현에 들어가면, 시간과 집중과 신뢰를 함께 잃습니다. Gran Maestro는 계획 → 스펙 작성 → 구현 → 검증 → 머지의 전 과정을 하나의 흐름으로 연결합니다.
/mst:plan은 코드를 짜는 대신 핵심 결정을 질문으로 꺼냅니다. 답변이 돌아올 때마다 다음 질문이 구체화되어, 모호했던 요청이 실행 가능한 플랜으로 정제됩니다. 막히면 AI 팀이 다각도로 의견을 모으고(ideation), 합의에 도달할 때까지 토론합니다(discussion).
> /mst:plan "로그인 화면 개선해줘"
[PM] 두 가지 결정이 필요합니다:
1. 소셜 로그인을 추가할까요, 기존 폼을 개선할까요?
2. 세션 유지는 JWT로 바꿀까요?
> 막히면 ideation으로 AI 팀의 의견을 모을 수 있습니다.
텍스트만으로 합의하면 빈칸이 남습니다 — 화면은 Stitch로 즉석 시각화하고, 완성된 플랜은 다중 AI가 역할별로 검토합니다(Plan Review). 검증된 플랜은 /mst:request로 구현 스펙이 되고, /mst:approve로 Codex와 AGY 개발팀에 전달되어 자동으로 구현됩니다. 구현이 끝나면 /mst:review가 AC 기준으로 검증하고, /mst:accept로 머지까지 완료됩니다. 대시보드에서 진행 상태와 근거를 실시간으로 확인할 수 있습니다. 아래 Quick Start에서 바로 시작하세요.
Quick Start
사전 요구사항: Claude Code(v1.0.33 이상) 또는 Codex CLI plugin runtime, Codex CLI. AGY CLI는 프론트엔드/UI 또는 대용량 컨텍스트 보조 provider로 사용할 때만 필요하며, agy --version이 동작하도록 설치되어 있어야 합니다.
기존 /mst:gemini, gemini, gemini-dev 설정/세션 값은 한 릴리스 동안 deprecated alias로 읽고 AGY 경로로 정규화합니다. 새 설정과 문서는 /mst:agy, agy, agy-dev를 기준으로 작성하세요.
/plugin marketplace add myrtlepn/gran-maestro
/plugin install mst@gran-maestro
Codex CLI에서 같은 git 저장소를 marketplace로 등록할 때:
codex plugin marketplace add myrtlepn/gran-maestro
codex plugin add mst@gran-maestro
설치 후 두 런타임은 같은 MST skill source를 사용합니다. Claude Code는 hooks/agents까지 등록하고, Codex는 hookless skill surface와 queue-driven supervision으로 같은 plan → request → approve → review → accept 흐름을 제공합니다. 기본 설정은 Codex-primary이며, Claude provider는 Claude 계열 preset 또는 claude-dev 배정으로 opt-in합니다.
# 1. plan으로 상세화 → request로 스펙 생성
/mst:plan 로그인 화면 개선 # → PLN-001
/mst:request --plan PLN-001 # → REQ-001
# 2. 또는 바로 request (plan + spec 한번에)
/mst:request 대시보드 오류 수정 # → REQ-002
# 3. 스펙 확인 후 승인
/mst:list
/mst:approve REQ-001 REQ-002
상세 설치 가이드: docs/quick-start.md
Codex plugin migration boundary
Gran Maestro는 Claude Code와 Codex에서 같은 git 저장소를 marketplace source로 사용합니다. Claude Code는 .claude-plugin/plugin.json으로 skills/agents/hooks를 등록하고, Codex는 root marketplace.json과 .agents/plugins/marketplace.json의 ./plugins/mst projection을 통해 repo root의 .codex-plugin/plugin.json, skills, scripts, templates를 그대로 노출합니다. 사용자 환경에 설치·업데이트·삭제가 필요한 경우에는 각 CLI 또는 사용자 소유 plugin manager에서 명시적으로 실행해야 하며, 검증 명령은 실제 ~/.codex/config.toml, ~/.agents, ~/.claude, plugin cache, symlink, .claude/hooks를 수정하지 않습니다.
- 설치: Claude Code는
/plugin marketplace add myrtlepn/gran-maestro 후 /plugin install mst@gran-maestro, Codex는 codex plugin marketplace add myrtlepn/gran-maestro 후 codex plugin add mst@gran-maestro로 같은 git source를 로드합니다.
- 업데이트: 릴리스 전
npm test와 DOD-012 evidence로 docs/release coverage를 확인한 다음 사용자 환경에서 별도 업데이트합니다.
- 삭제: 사용자 소유 Codex plugin 등록과 캐시를 사용자가 직접 제거합니다. Gran Maestro 검증은 삭제 명령을 자동 실행하지 않습니다.
- 검증:
node scripts/claude-plugin-local-install-smoke.mjs, node scripts/codex-plugin-local-install-smoke.mjs, node scripts/generate-dod-012-docs-release-integration.mjs /tmp/dod-012-docs-release-integration-check.json, npm test처럼 repository-local fixture/evidence와 임시 홈만 사용합니다. git source publish 이후에는 node scripts/claude-plugin-local-install-smoke.mjs --source myrtlepn/gran-maestro와 node scripts/codex-plugin-local-install-smoke.mjs --source myrtlepn/gran-maestro로 같은 경로를 검증합니다.
- 단일 source 유지: DOD-013 이후 Codex migration 검증은 Codex-only fork 0개와 generated drift 0건을 요구하며,
.claude-plugin/plugin.json, skills/, agents/, hooks/, templates/defaults/, package/version files를 canonical source로 유지합니다. node scripts/codex-plugin-git-source-readiness.mjs, node scripts/generate-dod-013-single-source-drift-validation.mjs /tmp/dod-013-single-source-drift-validation-check.json, 5-file version sync gate로 .codex-plugin/plugin.json, .agents/plugins/marketplace.json, root marketplace.json, plugins/mst projection을 repository-local로 확인합니다.
What's New
0.54.x 주요 업데이트:
