Gran Maestro
"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와 Gemini 개발팀에 전달되어 자동으로 구현됩니다. 구현이 끝나면 /mst:review가 AC 기준으로 검증하고, /mst:accept로 머지까지 완료됩니다. 대시보드에서 진행 상태와 근거를 실시간으로 확인할 수 있습니다. 아래 Quick Start에서 바로 시작하세요.
Quick Start
사전 요구사항: Claude Code(v1.0.33 이상), Codex CLI, Gemini CLI — 멀티 에이전트 구현에 사용됩니다.
/plugin marketplace add myrtlepn/gran-maestro
/plugin install mst@gran-maestro
# 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
What's New
0.54.x 주요 업데이트:
- Intent 시스템: 기능 의도(JTBD)를 저장·추적하여 plan에서 구현·검증까지 의도 일관성을 보장합니다 (
/mst:intent) - 브라우저 UI 테스트: UI 변경 시 plan/request/review에서 브라우저 테스트를 자동 연계하고, 스크린샷을 캡처·검증합니다
- Q&A 컨텍스트 캡처: 사용자 질문/답변을 자동 학습하여 선호 패턴을 축적, 반복 질문을 줄입니다
- Gardening: stale plan/request/intent를 자동 감지하여 리포트합니다 (
/mst:gardening) - Chrome Extension picks: 브라우저에서 UI 요소를 직접 캡처하고,
/mst:picks로 선택하여 plan으로 전환할 수 있습니다
기능 요약
35개 이상의 스킬을 제공합니다.
핵심 실행 체인
| 기능 | 명령 | 용도 |
|---|---|---|
| Q&A 계획 수립 | /mst:plan | 질문으로 요구사항 정제, 검증된 플랜 생성 |
| 구현 스펙 작성 | /mst:request | 플랜을 구현 가능한 스펙(spec.md)으로 변환 |
| 스펙 승인 & 실행 | /mst:approve | 스펙 검증 후 Codex/Gemini 개발팀에 자동 전달 |
| AC 검증 리뷰 | /mst:review | 다중 AI가 수락 조건 기준으로 병렬 검증 |
| 머지 & 정리 | /mst:accept | worktree 머지 + 정리 완료 |
협업 & 분석
| 기능 | 명령 | 용도 |
|---|---|---|
| 다각도 브레인스토밍 | /mst:ideation | AI 팀이 병렬로 의견 수집, PM이 종합 |
| 팀 토론 | /mst:discussion | 합의에 도달할 때까지 반복 토론 |
| 버그 조사 | /mst:debug | 3 AI가 병렬로 버그 조사, 종합 리포트 |
| 기능 의도 관리 | /mst:intent | JTBD 기반 의도 저장·추적·검증 |
도구 & 유틸리티
| 기능 | 명령 | 용도 |
|---|---|---|
| UI 시각화 | /mst:stitch | Stitch로 UI 목업 즉석 생성 |
| 코드 탐색 | /mst:explore | 코드베이스 자율 탐색, 스펙 근거 확보 |
| 캡처 관리 | /mst:picks | Chrome Extension 캡처 선택 → plan 전환 |
| 대시보드 | /mst:dashboard | 대시보드 서버 시작/관리 |
| 정리 리포트 | /mst:gardening | stale plan/request/intent 자동 감지 |
전체 스킬 목록: docs/skills-reference.md
문서
시작하기
- 빠른 시작 가이드 — 사전 요구사항, 설치, Stitch MCP 설정, 인증 방법
- 설정 관리 — config.json 전체 옵션 레퍼런스
- Chrome Extension 설치 — 브라우저 캡처 확장 설치 가이드
- 에이전트 할당 설정 — 도메인별 에이전트 매핑 가이드
심화
- 스킬 레퍼런스 — 35개 스킬 상세 사용법
- 대시보드 — 허브 구조, 뷰, API 엔드포인트
- 베스트 프랙티스 — 효율적인 워크플로우 패턴
- OMX 가이드 — oh-my-codex 설치, AGENTS.md 커스터마이징, 트리거 레퍼런스
- Hook 설정 — Git Hook 설정 가이드
레퍼런스
라이선스
MIT License — 자세한 내용은 LICENSE를 참조하세요.