菜单
어떤 질문이나 문제든 해결 접근법을 어떻게 가져갈 것인지 계획합니다. 사용자와 대화(또는 -a 자율 모드)로 모호성을 제거하고, 결정사항·범위·제약을 정제한 뒤 실행 가능한 plan.md를 작성합니다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
프로젝트 목표 + 설계 문서(objective.md)를 JTBD 기반 Q&A로 생성하고, 실행 전 검토 가능한 플래닝 세션을 초기화합니다.
프로젝트 목표를 제공하면 JTBD+프로젝트 DoD 기반 자율 실행을 수행합니다. Step 1은 agile-plan 서브스킬로 objective.md를 준비하고 Sprint 0 → Sprint N(프로젝트 건강 우선) 루프 → 스티어링 체크포인트를 반복합니다.
스펙을 승인하고 실행을 시작합니다. 사용자가 '승인', '진행해', 'OK 진행'을 말하거나 /mst:approve를 호출할 때 사용. Gran Maestro 워크플로우 내에서만 의미 있으며, 일반적인 확인 응답에는 사용하지 않음.
Claude provider 전용 native-first delegation entrypoint. 사용자가 '클로드로 실행', '클로드 서브에이전트'를 말하거나 /mst:claude를 호출할 때 사용한다. 같은 Claude host에서는 Task/Agent를 우선하고 route=external일 때만 managed wrapper를 사용한다.
Codex provider 작업을 native-first로 위임합니다. 사용자가 '코덱스 실행', '코덱스로', '코드 작업'을 말하거나 /mst:codex를 호출할 때 사용. 같은 Codex host에서는 collaboration agent를 우선하고, 중앙 route가 external일 때만 Codex CLI adapter를 사용합니다.
설정된 AI 에이전트들이 병렬로 버그를 조사하고 종합 리포트를 생성합니다. 사용자가 '디버그', '버그 찾아줘', '문제 분석'을 말하거나 /mst:debug를 호출할 때 사용. 1회성 의견 수집은 /mst:ideation을, 합의 토론은 /mst:discussion을 사용.
| name | plan |
| description | 어떤 질문이나 문제든 해결 접근법을 어떻게 가져갈 것인지 계획합니다. 사용자와 대화(또는 -a 자율 모드)로 모호성을 제거하고, 결정사항·범위·제약을 정제한 뒤 실행 가능한 plan.md를 작성합니다. |
| user-invocable | true |
| argument-hint | {플래닝 주제 또는 해결하고 싶은 질문/문제} |
목적: 어떤 질문이나 문제를 다루든, 그 해결책을 어떻게 접근할 것인지에 대한 계획을 수립합니다.
사용자와 Q&A 대화를 통해 모호성을 제거하고, 합의된 결정사항을 templates/plan.md 형식의 plan.md로 저장합니다.
핵심 우회 금지 규칙은 아래 Gate/체크리스트 섹션을 따른다.
이 스킬 실행 중 Write/Edit 도구를 사용할 수 있는 경로는 아래만 해당합니다:
{PROJECT_ROOT}/.gran-maestro/plans/PLN-*/plan.md{PROJECT_ROOT}/.gran-maestro/plans/PLN-*/plan.json{PROJECT_ROOT}/.gran-maestro/plans/PLN-*/auto-decisions.md{PROJECT_ROOT}/.gran-maestro/plans/PLN-*/ambiguity-log.md{PROJECT_ROOT}/.gran-maestro/plans/PLN-*/clarification-questions.md{PROJECT_ROOT}/.gran-maestro/captures/CAP-*/capture.json (status/consumed_at/linked_plan 업데이트용)그 외 모든 경로에 대한 Write/Edit 사용은 절대 금지입니다.
Skill(skill: "mst:stitch", args: "...")를 통해 실행한다./mst:plan 호출 시 주제 성격과 무관하게 Step 0.1~4 전체 프로토콜을 실행 대상으로 잠근다.PLN-* 산출물 및 CAP-* 상태 갱신 경로인지 확인한다.AUTO_MODE=false이면 최소 1회 Q&A 또는 AskUserQuestion 기반 분기 근거를 확보한다.plan.md와 plan.json이 생성되고 저장 경로/ID(PLN-NNN)가 확정되어야 종료할 수 있다.저장하고 /mst:request 실행 경로는 plan.md 디스크 저장 확인 후 1회만 호출한다.다음 단계 실행 명령: 블록으로 끝난다.
저장만 하기: /mst:request --plan PLN-NNN 및 /mst:request --plan PLN-NNN -amst:request까지 실행 완료: 생성된 REQ가 있으면 /mst:approve REQ-NNN, REQ를 특정하지 못하면 /mst:list/mst:plan "{계획 주제}"plan.md 저장 전에 mst:request 호출 또는 직접 구현(코드 수정)으로 전환한다.mcp__stitch__*를 직접 호출해 스킬 경유 규칙을 우회한다.codex exec + master 커밋으로 전환한다. 격리 실행이 필요하면 반드시 mst:codex --dispatch 또는 mst:claude --dispatch 경로를 사용한다.AskUserQuestion 실행 로그 또는 auto-decisions.md의 대응 결정 항목을 남긴다.plan.md 저장 경로와 실행 분기(저장만/요청 실행)를 명시한다.Bash(mst.py reference add ...) 호출 로그가 존재한다.mst:codex --dispatch 또는 mst:claude --dispatch 사용 로그가 auto-decisions.md 또는 retrospective.md에 남아있어야 한다.경로 규칙 (MANDATORY): 이 스킬의 모든
.gran-maestro/경로는 절대경로로 사용합니다. 스킬 실행 시작 시PROJECT_ROOT를 취득하고, 이후 모든 경로에{PROJECT_ROOT}/접두사를 붙입니다.PROJECT_ROOT=$(pwd)
{PLUGIN_ROOT}는 이 스킬의 "Base directory"에서skills/{스킬명}/을 제거한 절대경로입니다. 상대경로(.claude/...)는 절대 사용하지 않습니다.
이 프로토콜은 이 스킬 아래의 모든 provider 실행 예시보다 우선한다. provider 작업을 시작하기 전에 parent host가 route와 lifecycle evidence를 소유하고, child는 실제 할당 작업만 수행한다.
python3 {PLUGIN_ROOT}/scripts/mst.py host context --json을 실행하고 JSON의 host를 읽는다. 이 호출 실패, 잘못된 JSON, 알 수 없는 host는 임의 추정하지 말고 blocked로 종료한다.
이어서 반드시 아래 중앙 planner를 호출한다. {scope}는 현재 작업의 실제 scope(implementation, review, exploration, ideation, discussion, debug, analysis)이고, {provider}는 선택된 codex | claude | agy다.
python3 {PLUGIN_ROOT}/scripts/mst.py delegation route \
--host "{host}" \
--provider "{provider}" \
--scope "{scope}" \
--capability-status "{available|unknown|unavailable}"
route 결과 외의 근거로 transport를 바꾸지 않는다.
route=native_candidate: 같은 host/provider의 native bridge만 사용한다. handshake_required=true이면 실제 host tool 가용성을 확인한 뒤 진행한다.route=external: 이 경우에만 아래에 남아 있는 managed wrapper, dispatch build, provider CLI adapter 예시를 사용할 수 있다.route=blocked, CLI non-zero, lifecycle 응답의 status=blocked, 또는 현재 attempt의 phase=reconciling: 즉시 fail closed 한다. 같은 task/worktree에 새 agent나 external process를 시작하지 않는다.native_candidate 실행과 evidenceNative spawn 전 parent가 delegation start를 호출하고 반환된 attempt_id를 이후 모든 CAS 호출에 사용한다. start는 lifecycle 준비만 하며, 신규 응답이나 exact replay 모두 그 자체로 spawn 권한을 주지 않는다(spawn_allowed=false).
python3 {PLUGIN_ROOT}/scripts/mst.py delegation start \
--task-id "{task_id}" \
--idempotency-key "{task_id}:start:{stable_key}" \
--host "{host}" \
--provider "{provider}" \
--capability-status available \
--route-reason "{route.reason_code}" \
--worktree-dir "{worktree_path}" \
--model "{model}" \
--scope "{scope}" \
--prompt-file "{prompt_file}" \
--output-path "{output_path}"
analysis|review|exploration|ideation|discussion|debug가 실제 read-only 작업이고 별도 linked worktree를 쓰지 않는 경우에만 --read-only를 추가한다. 구현·수정 작업에는 이 예외를 사용하지 않는다.
그 다음 parent invocation별 고유한 {claimant_id}로 single-use spawn claim을 요청한다. 오직 이 호출에서 spawn_allowed=true와 non-empty private claim_token_file을 함께 받은 단 한 caller만 native host tool을 한 번 호출할 수 있다. raw bearer token은 CLI JSON, argv, process listing, tool transcript, child prompt에 노출하지 않는다.
python3 {PLUGIN_ROOT}/scripts/mst.py delegation claim-spawn \
--task-id "{task_id}" \
--attempt-id "{attempt_id}" \
--claimant-id "{claimant_id}" \
--idempotency-key "{task_id}:claim:{claimant_id}"
spawn_allowed=false, claim_status=claim_replay|already_claimed|reconciling|provider_task_in_flight|terminal, 빈 claim_token_file, 또는 claim 응답 유실/불명확 상태에서는 host tool을 호출하지 않는다. claim_replay|already_claimed는 winner의 claim lease가 살아 있는 동안 wait만 하며 recover/cancel로 ownership을 빼앗지 않는다. lease 만료 뒤에만 delegation recover로 reconcile하고, 그 외에는 next_action에 따라 기존 provider task에 attach/wait한다. claim exact replay는 bearer token/파일을 다시 발급하지 않는다. 따라서 claim 결과를 잃은 caller도 외부 fallback이나 중복 native spawn을 시도하지 않는다.
host=codex, provider=codex: Codex collaboration native tools를 사용한다. collaboration.spawn_agent로 spawn하고, host가 제공하는 attach/follow-up 수단으로 같은 task에 연결하며, collaboration.wait_agent로 대기한 뒤 전달된 completion result를 수집한다. 병렬 fan-out은 독립 task마다 native agent를 하나씩 spawn한다.host=claude, provider=claude: Claude의 Task(...) 또는 Agent(...) native tool로 spawn한다. background task는 host의 TaskOutput/resume 결과로 대기·수집한다.codex exec, claude CLI, mst.py run --provider {same_provider}, 같은 provider의 managed wrapper, 또는 nested /mst:claude//mst:codex를 호출하지 않는다.Native tool 응답마다 claim winner parent가 다음 순서로 evidence를 기록한다. {claim_token_file}은 winner 응답의 mode 0400 private one-shot handle이며 acknowledge 성공 시 삭제된다. 내용을 읽거나 복사하거나 child/user/log에 전달하지 않는다. 각 명령의 JSON 응답에서 status/phase를 확인하고 blocked/reconciling이면 더 진행하지 않는다.
delegation acknowledge --task-id "{task_id}" --attempt-id "{attempt_id}" --claim-token-file "{claim_token_file}" --spawn-status created_with_task_id --provider-task-id "{provider_task_id}" --idempotency-key "{task_id}:ack:{stable_key}"delegation attach --task-id "{task_id}" --attempt-id "{attempt_id}" --attach-status attached --idempotency-key "{task_id}:attach:{stable_key}"delegation heartbeat --task-id "{task_id}" --attempt-id "{attempt_id}" --provider-state running --idempotency-key "{task_id}:heartbeat:{sequence}"{output_path}의 sibling temp file에 먼저 쓰고 atomic replace한 뒤, fresh hash/size를 확인한다. child에게 이 파일 쓰기를 맡기거나 기존 파일을 재사용하지 않는다.delegation complete --task-id "{task_id}" --attempt-id "{attempt_id}" --completion-signal "{succeeded|failed|timeout|unknown}" --output-path "{output_path}" --idempotency-key "{task_id}:complete:{stable_key}"Native spawn이 task 생성 전에 명확히 실패한 경우에만 claim winner가 같은 --claim-token-file "{claim_token_file}"로 spawn-status=definitive_not_created를 acknowledge한 뒤 delegation fallback --expected-attempt-id "{attempt_id}" ...를 요청할 수 있다. 그 후 capability를 unavailable로 route planner에 다시 전달해 route=external을 받은 경우에만 external lane을 실행한다. claim 결과 유실, accepted, task ID 발급, attach 실패/timeout, child 실패, unknown/indeterminate 결과 뒤에는 external fallback을 금지하고 reconcile 상태를 유지한다.
route=external 판정만으로 provider command를 직접 만들지 않는다. Fresh headless/cross-provider external lane은 command 생성 전에 중앙 planner 결과를 state에 고정한다.
python3 {PLUGIN_ROOT}/scripts/mst.py dispatch authorize-external \
--provider "{provider}" \
--task-id "{task_id}" \
--prompt-file "{prompt_file}" \
--worktree-dir "{worktree_path}" \
--running-log-path "{running_log}" \
--trace-path "{trace_path}" \
--output-path "{output_path}" \
--model "{model}" \
--scope "{scope}" \
--idempotency-key "{task_id}:external-authorize:{stable_key}" \
{read_only_flag}
이 명령은 실제 host를 다시 확인하고 중앙 route가 여전히 external일 때만 current external attempt와 model/running/trace/output binding을 저장한다. 구현·수정 lane은 registered linked worktree를 사용하고 {read_only_flag}를 비운다. 실제 read-only scope만 --read-only를 사용한다. 반환된 attempt_id와 동일한 artifact binding을 external wrapper에 전달한다.
python3 {PLUGIN_ROOT}/scripts/mst.py dispatch build \
--provider "{provider}" \
--task-id "{task_id}" \
--prompt-file "{prompt_file}" \
--worktree-dir "{worktree_path}" \
--log-file "{running_log}" \
--model "{model}" \
--expected-attempt-id "{external_attempt_id}"
Native definitive non-creation fallback이면 새 authorization을 만들지 않고 delegation fallback이 반환한 external attempt_id를 --expected-attempt-id로 사용한다. Builder는 current attempt의 task/provider/resolved worktree/prompt hash/route를 재검증하므로 native, reconciling, stale attempt, 또는 mismatch 상태에서는 command를 만들지 않는다. Codex/Claude 보호 wrapper는 provider command나 split claim/finalize shell을 포함하지 않고 dispatch run-external 단일 감독자만 호출한다. 감독자는 먼저 side effect가 없는 anonymous exec gate를 띄워 PID/PGID/start identity를 CAS로 attach하고, 같은 task lock 안에서 취소보다 먼저 exec 권한이 확정된 경우에만 실제 provider를 release한다. claim에서 캡처한 정확한 prompt bytes를 stdin으로 전달하고, provider process group을 회수한 뒤 fresh single-link inode로 claim해 계속 보유한 non-following output descriptor로 결과를 게시한다. prompt/snapshot/running/trace/output alias와 MST state·lock·history reserved path alias는 provider spawn 전에 차단한다. claim-external/heartbeat-external/finalize-external을 별도로 호출하거나 prompt snapshot/output pathname을 shell에서 다시 열지 않는다. Prompt 본문·snapshot path·claim secret·descriptor number는 argv/state/history에 확장하지 않는다.
모든 native child prompt에는 다음 제약을 그대로 포함한다.
DELEGATION BOUNDARY (MANDATORY)
- Complete the assigned task yourself; do not delegate or spawn another provider agent.
- Do not invoke codex/claude provider CLIs, /mst:codex, /mst:claude, or a same-provider managed wrapper.
- Do not call `mst.py delegation` lifecycle commands and do not edit `.gran-maestro/run`, session, or history state; the parent owns routing and evidence.
- Work only in the assigned worktree/scope and return the result/evidence to the parent.
아래 skill별 dispatch 예시는 이 protocol의 route로 gate한다. Provider CLI/managed wrapper 예시는 오직 route=external일 때만 사용한다. Task/Agent/Codex collaboration 예시는 host와 provider가 일치하는 route=native_candidate일 때만 사용하고 child boundary와 native lifecycle evidence를 함께 적용한다.
사용자 입력이 필요한 지점에서는 host별 질문 도구를 직접 판단하지 말고 question prepare를 먼저 호출한다. 이 규칙은 기존 AskUserQuestion 직접 호출 지시보다 우선한다.
templates/question-payload.schema.json을 따른다.python3 {PLUGIN_ROOT}/scripts/mst.py question prepare \
--skill {CURRENT_SKILL} \
--step "{CURRENT_STEP}" \
--resume-skill {CURRENT_SKILL} \
--resume-args "{RESUME_ARGS}" \
--payload-file {QUESTION_PAYLOAD_JSON} \
--json
mode=claude_tool: 반환된 payload로 AskUserQuestion을 호출한다.mode=pending_artifact: 반환된 user_message를 사용자에게 보여주고 종료한다. 이 상태는 정상적인 사용자 입력 대기이며 임의 중단이 아니다.mode=auto_decision: AUTO_MODE=true 경로로 질문 없이 계속하거나 blocker를 기록한다.AskUserQuestion을 직접 호출하지 않는다. pending question은 .gran-maestro/questions/Q-*.json에 저장되고 /mst:resume --answer Q-...로 재개한다.question prepare가 기록한 awaiting_user_input 상태와 payload hash가 일치할 때만 허용된다.~/.claude/user-profile.json (User Input Boundary 컨텍스트, 비차단)~/.claude/user-profile.json을 Read한다.
user_profile_context = null로 처리하고 기존 동작을 유지한다 (graceful fallback).role (string)experience_level (string)domain_knowledge (string[])communication_style (string)user_profile_context = null로 처리한다 (워크플로우 차단 금지).communication_style을 최우선 반영한다.experience_level/domain_knowledge에 맞춰 용어 수준과 설명 깊이를 조절한다.외부 의존성(라이브러리/API/프레임워크/버전/프로토콜) 판단은 아래 공통 프로토콜을 따른다.
Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get reference.auto_search)로 reference.auto_search를 확인한다. true일 때만 자동 WebSearch를 허용한다. 설정 미존재 시 기본값은 cache_ttl_days=2, cutoff_threshold_months=0.5, max_searches_per_step=5, llm_auto_trigger=true, auto_fact_check=true.reference.llm_auto_trigger == true이면 PM이 최신 정보가 필요하다고 판단할 때도 WebSearch를 트리거한다. false이면 키워드 매칭 기반 동작만 유지한다..gran-maestro/references/ 캐시를 reference search --keyword "{keyword}" --json으로 확인, (b) searched_at + cache_ttl_days 기준 fresh/stale 판정, (c) 현재 시각 대비 cutoff_threshold_months 초과 시 expired 판정.stale/expired일 때만 검색한다. reference.auto_search == true일 때만 실행하고 Step당 max_searches_per_step을 넘지 않는다. reference.auto_fact_check == true이면 핵심 claim을 1회성 교차 WebSearch로 경량 검증한다.Bash로 mst.py reference add를 호출한다. 표/텍스트 결론 요약만으로는 저장 완료가 아니며 content.md는 raw 발췌(원문 근거) 중심으로 남긴다.
python3 {PLUGIN_ROOT}/scripts/mst.py reference add --topic "{topic}" --url "{url}" --summary "{summary}" --content "{raw 발췌 본문}"summary는 한 줄 인덱스 유지).> 인용: "{원문 핵심 문장}" (출처: {URL}, 날짜: {YYYY-MM-DD})| 열 | 값 | 형태의 raw markdown table과 출처 URL을 보존한다.content.md Read 필수): summary만으로 부족하거나 표/코드/원문 뉘앙스가 결론에 영향을 주면 반드시 content.md를 Read한다.[REFERENCE_CONTEXT]를 주입한다. 형식: current_date, model_cutoff, references: REF-001 (fresh|stale|expired) {topic} | {url}. 참조가 없으면 references: none으로 명시한다.library/framework/api/sdk/protocol/version/dependency 및 한국어 동의어를 감지. 감지 키워드가 없고 reference.llm_auto_trigger == false이면 검색 생략.mst.py reference search --keyword "{keyword}" --json으로 조회. (b) cache_ttl_days 이내: fresh, 초과: stale. (c) cutoff_threshold_months 초과 시 expired 승격.stale/expired 항목만 검색 대상. auto_search == true일 때만 실행, max_searches_per_step 초과 금지.mst.py reference add 최소 N회 (1:1 대응). summary는 한 줄 인덱스, content.md는 원문 근거.[REFERENCE_CONTEXT]를 주입. model_cutoff는 현재 모델 cutoff 문자열(미확인 시 unknown).--from-debug DBG-NNN 직접 진입: debug/DBG-NNN/debug-report.md Read (미존재 시 경고 후 Step 1) → debug_context 활성화(linked_debug_id, root_cause, fix_suggestions, affected_files) → Step 1로 진행
키워드 기반 감지 (--from-debug 없는 경우): 버그/에러/오류/안됨/고쳐/crash/타임아웃 등 감지 시:
Skill(skill: "mst:debug", args: "{이슈}") 즉시 실행 (--focus 있으면 전달)debug-report.md 완료 대기 후 Read → debug_context 보관 (DBG ID/근본 원인/수정 제안 P0~P2/영향 파일)debug_context 활성 상태 유지⚠️ CONTINUATION GUARD: 서브스킬 반환 후 즉시 다음 Step 진행 (hook이 자동 강제).
미감지 시: Step 1로 진행.
--from-picks 감지 (--from-debug 처리 후 실행):
--from-picks [CAP-001] [CAP-003] "요청 텍스트" 형태 파싱:
--from-picks 뒤의 [CAP-NNN] 패턴을 모두 추출 → capture_ids 배열 보관capture_ids에 대해 {PROJECT_ROOT}/.gran-maestro/captures/CAP-NNN/capture.json Read. 미존재 시 경고 후 건너뜀, 이미 consumed 상태이면 경고 표시 후 재사용 허용.capture_context 배열에 보관 (ID, url, selector, memo, screenshot 등)--from-debug와 동시 입력 시: --from-debug 우선 처리(debug_context) → capture_context는 보조 컨텍스트로 유지--from-picks 미사용 시: capture_context는 빈 배열 (하위 호환)Step 0.5 처리 완료 후, 사용자 입력 텍스트 전체에서 /\[?CAP-\d{3,}\]?/gi 패턴 매칭:
capture_context에 보관된 ID는 중복 Read 하지 않음{PROJECT_ROOT}/.gran-maestro/captures/CAP-NNN/capture.json Read. 미존재 시 경고 후 건너뜀, consumed 상태이면 경고 후 재사용 허용.capture_context에 합집합 처리 (ID 기준 중복 제거)capture_context는 Step 0.5 상태 유지어느 Step이든 사용자 응답에서 다음 패턴 감지 시 즉시 AUTO_MODE=true로 전환:
[자율 모드 전환] 이제부터 -a 모드로 진행합니다. 출력AskUserQuestion 대기 중이었다면: 대기를 종료하고 현재 단계부터 AUTO_MODE=true 적용하여 재개AUTO_DECISION_TOTAL, AUTO_PM_COUNT 등 카운터가 미초기화 상태이면 0으로 즉시 초기화-a 또는 --auto 존재 여부 검사. 하나라도 있으면 AUTO_MODE=true, 없으면 AUTO_MODE=false.AUTO_MODE=false인 경우 state guarded fallback 시도: read_workflow_state_auto_mode("mst:plan") 호출. 반환값이 bool이면 채택, None이면 Step 3(config fallback)으로 진행.Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get auto_mode.plan auto_mode.confidence_threshold --json) 결과를 plan_auto_mode_config로 보관한다. 키가 없으면 Read(templates/defaults/config.json) fallback.plan_auto_mode_config의 auto_mode.plan == true면 AUTO_MODE=true. auto_mode.confidence_threshold를 읽어 CONFIDENCE_THRESHOLD에 저장하고, 미설정 시 기본값 0.7을 사용한다. CLI 플래그가 config보다 우선.목적:
/mst:plan호출 자체가 계획 의도 신호이지만, args 본문이 항상 계획 주제인 것은 아니다. 메타/질문/모호한 args를 계획 주제로 오해하지 않도록 PM이 자율 판별한다. Step 0.5(디버그)·0.75(CAP) 이후에 실행한다.
PM이 args 본문을 읽고 아래 둘 중 하나로 자율 분류한다.
debug_context 또는 capture_context가 활성이면 이미 주제가 성립한 것으로 보고 topic으로 간주한다. 판별 기준은 규정하지 않고 PM 자율 판단에 맡긴다.
topic 판정: args 본문을 plan 주제로 삼아 Step 1로 진행한다.
meta 판정:
[계획 후보] 1) {후보1 주제} 2) {후보2 주제} 3) {후보3 주제}AUTO_MODE=false: AskUserQuestion으로 후보 중 선택받거나 UI 자동 Other로 직접 주제 입력받아 Step 1로 진입한다. 명시 선택지에는 "A. 후보 주제", "B. 계획 없이 종료"처럼 의미 있는 label을 사용한다.AUTO_MODE=true: PM이 최유력 후보 1건을 자율 선택하여 Step 1로 진입한다. 선택 근거를 Step 1에서 초기화되는 auto-decisions.md에 함께 기록한다. 후보 도출 불가 시 종료한다.workflow.high_pass_guard를 읽어 HIGH_PASS_GUARD에 저장 (미설정 시 기본값: enabled=true, confidence_supporting_only=true, require_external_execution_evidence=true, require_independent_judgement=true, block_self_report_only_pass=true, plan_bypass_requires_explicit_rationale=true).
우선순위: args > state(guarded) > config > default(false).
AUTO_MODE=true이면 아래 초기값을 메모리에 보관:
AUTO_DECISION_TOTAL=0, AUTO_PM_COUNT=0, AUTO_DISCUSSION_COUNT=0, AUTO_EXPLORE_DISCUSSION_COUNT=0[자율 모드 활성화] confidence threshold: {CONFIDENCE_THRESHOLD} 출력State execution contract: state write commands inherit MST_SESSION_ID from the current session or receive equivalent structured context; do not inject process-scoped identity into canonical writes.
Parent session inheritance contract: child invocation, subprocess, and hook execution inherit parent MST_SESSION_ID; children must not issue arbitrary mst_session_id. Hook payload mst_session_id is allowed only when it matches the inherited parent MST_SESSION_ID.
{PROJECT_ROOT}/.gran-maestro/plans/ 디렉토리 확인, 없으면 생성
PLN 번호 채번: 스크립트 우선 python3 {PLUGIN_ROOT}/scripts/mst.py counter next --type pln → PLN-NNN ID 사용. Fallback: plans/PLN-*/plan.json 스캔 → 최대 번호 +1 (최초: 001)
{PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/ 디렉토리 생성
{PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/plan.json 먼저 작성:
⏱️ 타임스탬프 취득 (MANDATORY):
TS=$(python3 {PLUGIN_ROOT}/scripts/mst.py timestamp now)위 명령 실패 시 폴백:python3 -c "from datetime import datetime, timezone; print(datetime.now(timezone.utc).isoformat())"출력값을created_at필드에 기입한다. 날짜만 기입 금지.
{
"id": "PLN-NNN",
"title": "플랜 주제",
"status": "active",
"created_at": "{TS — mst.py timestamp now 출력값}",
"linked_requests": []
}
4.5. AUTO_MODE=true이면 워크플로우 state를 즉시 기록한다 (non-blocking). 이 호출은 방금 작성한 plan.json에 canonical session metadata를 병합한다:
python3 {PLUGIN_ROOT}/scripts/mst.py state set-workflow \
--active true --skill mst:plan --req "" --next-skill mst:request \
--next-source PLN-NNN --source-skill mst:plan --auto true \
--root-mst-id PLN-NNN \
|| echo "[mst:plan] warning: failed to update workflow state" >&2
AUTO_MODE=true이면 {PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/auto-decisions.md를 즉시 초기화:
# 자율 결정 로그 — PLN-NNN
> 자율 모드(-a)로 실행됨. 아래 항목들이 PM에 의해 자율 결정되었습니다.
| 항목 | 결정값 | Confidence | 판단 방식 | 강제 여부 |
|------|--------|-----------|-----------|-----------|
강제 여부 값은 강제(L1) 또는 자율만 사용한다.
PM이 요청을 아래 기준으로 4개 도메인 중 하나로 분류한다.
| 도메인 | 신호 | plan 전략 |
|---|---|---|
| Simple | 기존 패턴 직접 적용 가능, 범위 명확, 유사 구현 전례 다수 | 모호성 루프 간소화 가능 (plan 자체 스킵 금지) |
| Complicated | 전문가 분석 필요, 접근법 2~3가지 후보, 트레이드오프 있음 | Step 2.5(ideation/discussion) 적극 권장 |
| Complex | 정답 불명확, 실험 필요, 탐색적 성격, 범위 유동적 | REQ 분리(Step 3.5) 강력 권장, 단계적 탐색 제안 |
| Chaotic | 버그/장애/긴급 상황, 즉각 대응 필요 | /mst:debug 먼저 실행 후 plan 재개 안내 |
AUTO_MODE 공통: PM이 자율 분류하고 결과+전략을 한 줄 통지로 출력한 뒤 다음 Step 진행. AskUserQuestion으로 도메인 선택 묻지 않음. 사용자 이의 시 자연어 응답으로 재분류.
통지 포맷: [Cynefin: {도메인}] {적용 전략 요약}
Cynefin 자동 분류 보조 규칙: 트레이드오프 신호(대안 비교/장단점 균형/우선순위 충돌) · 외부 의존성 신호 · 비결정적 표현 신호 중 1개라도 감지되면 Complicated 이상으로 자동 플래그. Simple로 분류했더라도 자동 플래그 존재 시 Step 2.5의 discussion 실행 권장하고 근거를 auto-decisions.md에 기록.
plan.json 저장: "cynefin_domain": "simple" | "complicated" | "complex" | "chaotic" 필드 추가.
AUTO_MODE=true 추가 동작: auto-decisions.md에 분류 근거 기록.
{PROJECT_ROOT}/.gran-maestro/plans/PLN-*/plan.json 목록 조회 → 각 title과 현재 요청 주제 비교 (LLM 의미 유사도) → 유사도 상위 3개 후보 식별 (없으면 silent skip)plan.json에서 linked_intent 확인 → 존재하면 python3 {PLUGIN_ROOT}/scripts/mst.py intent get {INTENT_ID} --json으로 intent 본문 Read하여 referenced_intent로 보관. 없거나 실패 시 graceful skip (워크플로우 차단 금지).{PROJECT_ROOT}/.gran-maestro/plan-context.md를 반드시 Read한다. 파일이 없으면 아래 초기 템플릿으로 생성 후 즉시 Read한다 (비차단):
# Plan Q&A 선호 패턴
_마지막 갱신: 없음 (초기 상태)_ / _세션 수: 0_ / _schema_version: 1_
> 아직 선호 패턴이 기록되지 않았습니다.
## 선호 패턴 (Preference Table)
| id | domain | type | statement | weight | freq | last_seen | tags |
|----|--------|------|-----------|--------|------|-----------|------|
## Prompt Hints
(패턴 축적 후 자동 생성됩니다)
## 선호 패턴 (Preference Table)에서 현재 주제와 관련된 패턴 최대 3개를 preference_hints로 추출한다.AskUserQuestion에서 과거 선호를 description에 명시적으로 인용한다 (권장 형식: 이전에 "{statement}"를 선호하셨습니다. 이번에도 동일하게 적용할까요?). freq 숫자 직접 인용 금지.disputed_preferences에 수집하고 Step 4 저장 시 백그라운드 요약 입력으로 전달한다.Reference Lookup Protocol을 실행한다.reference.auto_search != true이면 자동 WebSearch는 금지하고, 기존 REF 캐시 조회 결과만 컨텍스트로 사용한다.[REFERENCE_CONTEXT] 블록을 Step 2.5/Step 3의 모든 판단 프롬프트(ideation/discussion/explore 포함)에 주입한다.debug_context 활성 시: 근본 원인+수정 제안을 초기 컨텍스트로 선반영 → [디버그 조사 결과 요약] 블록 표시(근본 원인/수정 제안 P0~/영향 파일) → 구현 범위·우선순위·분리 실행 여부를 핵심 미결 항목으로 정리
capture_context 활성 시: 캡처 데이터를 초기 컨텍스트로 선반영 → [캡처 참조 요약] 블록 표시:
[캡처 참조 요약]
| ID | URL | Selector | Memo |
|----|-----|----------|------|
| CAP-001 | https://... | .btn-primary | 색상 변경 필요 |
> 스크린샷: `.gran-maestro/captures/CAP-001/screenshot.webp`
debug_context와 capture_context 모두 활성이면 둘 다 표시 (debug가 상위, capture가 보조).
실행 분기:
AUTO_MODE=false:
AskUserQuestion으로 대화를 시작한다. (Fast-track 금지)
AskUserQuestion 없이 Step 4로 직행하는 것은 어떤 경우에도 허용하지 않는다.AUTO_MODE=true: Step 2~3에서 AskUserQuestion 호출 금지. 우선순위가 가장 높은 미결 항목 1건을 먼저 처리한 뒤 Step 3 반복으로 이어간다. ideation/discussion 호출은 생략 대상이 아니라 결정 품질 확보 절차로 필요 시 즉시 수행한다.프레이밍 원칙:
confidence는 현재 근거의 충분도를 표현하는 작업 신호다. confidence는 보조 신호이며 high-pass 단독 근거로 사용하지 않는다.discussion/ideation 호출은 결정 품질과 반례 점검을 높이는 표준 절차다. 높은 confidence 자체를 discussion 생략의 정당화로 사용하지 않는다.AUTO_MODE=true일 때 각 미결 항목 처리 순서:
workflow.high_pass_guard Hard Gate를 confidence 분기보다 먼저 평가:
self_report_only_block, external_evidence_missing, independent_judgement_required, risk_signal_review_required.risk_signal_review_required로 기록하고 confidence 단독 high-pass를 금지한다.| {항목명} | {결정값} | {confidence:.2f} | hard-gate ({reason_token}) | 강제(L1) |confidence >= CONFIDENCE_THRESHOLD AND Hard Gate 통과: PM 자율 결정. 대안 비교·영향 범위·이해관계자 정렬이 중요한 항목은 confidence가 높아도 discussion/ideation 호출로 결정 품질 보강 가능.
| {항목명} | {결정값} | {confidence:.2f} | PM 자율 판단 | 자율 |, 호출 시 | ... | 고신뢰+discussion 보강 | 자율 |AUTO_DECISION_TOTAL++, AUTO_PM_COUNT++, 호출 시 AUTO_DECISION_TOTAL++, AUTO_DISCUSSION_COUNT++CONFIDENCE_THRESHOLD > confidence >= 0.4: Skill(skill: "mst:discussion", args: "{미결 항목} --from-plan --auto") → consensus.md 핵심 3~5개 추출 후 반영. auto-decisions.md: | ... | discussion 결과 | 자율 |. 카운터: AUTO_DECISION_TOTAL++, AUTO_DISCUSSION_COUNT++confidence < 0.4: WebSearch 선행 후 confidence 재산정. 재산정 >= 0.4이면 discussion 실행, < 0.4이면 PM이 가장 안전한 선택으로 자율 결정. auto-decisions.md: | ... | web-search→discussion 결과 | 자율 |. 카운터: AUTO_DECISION_TOTAL++, AUTO_EXPLORE_DISCUSSION_COUNT++공통: Step 2 분석 후 자동 ideation/discussion 판단 필요 시 Step 2.5 실행 (confidence 수준과 무관하게 품질 보강이 필요하면 우선 적용 가능)
⚠️ AUTO_MODE=false일 때 모든 항목이 클리어될 때까지 이 루프를 반복한다.
PM은 아래 체크리스트 항목 각각에 대해, 직전 대화 컨텍스트에서 답을 추론 가능한지 먼저 판단합니다. 추론 가능하면 AskUserQuestion을 생략하고 plan.md 초안에 (PM 추론) 표기로 기입합니다. 추론 불가한 항목만 기존 루프로 질문합니다.
추론 가능 판정 기준: 직전 대화 또는 툴호출 결과에 해당 값이 직접 명시되어 있거나, 문맥상 명백히 함의된 경우만 추론 가능로 본다. 애매하거나 복수 해석 가능하면 불가 처리. 배치 옵션: 추론 불가 필드가 2개 이상 시 AskUserQuestion의 questions[] 배열로 1회에 묶을 수 있다.
AUTO_MODE=true 분기는 기존 [AUTO_MODE 판단 패턴] 그대로 동작하며, 이 규칙은 AUTO_MODE=false에서만 적용된다.
5W1H: (1) WHO: 사용자/수혜자 특정 (2) WHAT: 변경·추가·제거 대상 정의 (3) WHY: 비즈니스 근거/목적 명시 (4) WHEN: 완료 시점 또는 트리거 조건 (5) WHERE: 영향 받는 화면/시스템/모듈 특정 (6) HOW MUCH: 성공을 수치·관찰로 측정 가능한지 (7) HOW: 접근 방향 대략 정의 (기술 상세 아님 — 전략 방향)
NFR: (8) 성능 목표: 응답 시간, 처리량, 부하 명시 필요 여부 (9) 보안 요구사항: 인증·인가·데이터 보호 (10) 접근성/호환성: 특정 기기/OS/브라우저 요구 (11) 오류 처리: 실패 시 동작(롤백/알림/재시도) 정의 필요 여부
직관적 추가 항목 (PM이 현재 요청을 읽고 자연스럽게 의문이 드는 것): PM이 자율 판단으로 0~3개 추가 작성. 너무 기술적이거나 구현 수준의 질문은 제외.
ROUND = 1
WHILE (미클리어 항목 존재):
1. PM이 체크리스트 전체를 점검하여 미클리어 항목 목록 추출
2. 미클리어 항목이 없으면 루프 종료 → Step 2.3으로 진행
3. 미클리어 항목을 그룹화하여 AskUserQuestion 1회로 최대 4개 항목을 질문
4. 사용자 답변을 각 항목에 반영
5. ambiguity-log.md에 Round N 기록 (미클리어 항목 / 사용자 답변 / 해소 여부)
6. ROUND++
AUTO_MODE=true: AskUserQuestion 없이 PM이 각 항목을 자율 판단으로 해소. 각 항목 해소 결과를 auto-decisions.md에 즉시 기록. 외부 정보 필요 시 WebSearch 실행.
적용 범위: Step 2.1 모호성 루프, Step 3.8.5 적대적 검토, Step 3.9 D3에서 발견된 사용자 의도·범위·우선순위·허용치 관련 모호성.
severity=critical|major이거나 finding의 requires_user_answer=true인 항목은 PM이 (PM 추론) 또는 자동 보완으로 닫을 수 없다.질문, PM 추천 답변, 추천 근거, 틀렸을 때 영향을 작성하고 {PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/clarification-questions.md에 append한다.| ID | 확인할 모호성 | PM 추천 답변 | 추천 근거 | 틀렸을 때 영향 |
|----|---------------|--------------|-----------|----------------|
| CQ-1 | ... | ... | ... | ... |
AUTO_MODE=false: 배치당 AskUserQuestion 1회만 실행한다. 선택지는 최대 4개로 고정한다.
A. 추천안 모두 수락: 표의 모든 PM 추천 답변을 사용자 승인 결정으로 반영B. 일부만 수정: 사용자가 CQ-1=...; CQ-3=...처럼 수정할 수 있게 안내하고, 수정된 항목만 재반영C. 더 검토: 현재 배치 전체를 mst:discussion 또는 mst:ideation으로 보강한 뒤 같은 배치를 재질문D. 범위 제외/보류: 해당 항목을 No-go Scope 또는 리스크 레지스터에 기록AUTO_MODE=true: critical/major 사용자 의존 모호성이 남아 있으면 자율로 진행하지 않는다. auto-decisions.md와 clarification-questions.md에 blocker를 기록하고 /mst:request 자동 호출을 중단한다.A. 추천안 모두 수락을 선택한 경우에도 기록에는 (PM 추천 — 사용자 일괄 승인)으로 남긴다. PM 단독 결정으로 기록하지 않는다.ambiguity-log.md 형식:
# 모호성 해소 로그 — PLN-NNN
## Round 1 — {타임스탬프}
### 미클리어 항목
| 번호 | 항목 | 질문 내용 |
|------|------|-----------|
### 사용자 답변
- WHO: "..."
### 해소 결과
| 번호 | 항목 | 해소 여부 |
|------|------|-----------|
⚠️ AUTO_MODE=false일 때 추론 불가 항목이 1개 이상 남으면 AskUserQuestion을 반드시 실행한다. 모든 항목이 추론 가능으로 판정되어
(PM 추론)표기로 기입되면 AskUserQuestion을 생략할 수 있다. 추론 판정 근거 없이 임의로 생략하는 것은 금지한다.
추론 가능 시 생략 (MANDATORY): PM은 Out-of-scope·기술적 제약·비즈니스 제약·MoSCoW 각 항목에 대해, 직전 대화 컨텍스트에서 값을 추론 가능한지 먼저 판정한다. 추론 가능한 항목은
AskUserQuestion을 생략하고 plan.md의 해당 섹션에(PM 추론)표기로 기입한다. 판정 기준은 Step 2.1의 "추론 가능 시 질문 생략" 블록과 동일.
아래 4가지를 하나의 AskUserQuestion으로 통합 질문한다 (질문 제목: "이 plan의 제약사항을 확인합니다."):
각 항목에 "해당 없음" 선택지 포함. 답변은 plan.md ## 제약사항 및 ## 우선순위 (MoSCoW) 섹션에 반영.
AUTO_MODE=true: PM이 요청 맥락에서 제약사항과 MoSCoW를 자율 추론하고 auto-decisions.md에 기록한다.
Shared preload: Step 2.4와 Step 2.45는 시작 전에
Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get plan_qa_presets --json)를 1회 실행해plan_qa_presets_config로 보관하고,plan_qa_presets.test_strategy/plan_qa_presets.loop_exit를 모두 여기서 읽는다. preload 실패 시에만templates/defaults/config.jsonfallback을 사용한다.
⚠️ AUTO_MODE 가드 (CRITICAL — 최우선 평가):
AUTO_MODE=true이면 AUTO_MODE=false 블록 전체를 건너뛰고 즉시 AUTO_MODE=true 블록을 실행한다.
AUTO_MODE=true (최우선 분기): PM이 요청 맥락에서 테스트 방법론 적용 여부와 목표 커버리지를 자율 판단. plan_qa_presets.test_strategy 값이 "ask" 이외이면 해당 preset을 기본값으로 채택. 판단 근거와 결정을 auto-decisions.md에 기록. plan.md ## 테스트 전략 섹션에 반영. AskUserQuestion 호출 절대 금지.
AUTO_MODE=false: plan_qa_presets_config의 plan_qa_presets.test_strategy 값을 먼저 확인한다 (없으면 templates/defaults/config.json fallback).
"ask" 이외의 preset이면 AskUserQuestion 생략하고 자동 적용: "apply-80" → 적용/80%, "apply-90" → 적용/90%, "apply-no-coverage" → 적용/미설정, "skip" → 적용 안 함"ask"이면 AskUserQuestion 1회 수행. 핵심 선택지 4개: "A. 적용 80%", "B. 적용 90%", "C. 적용 미설정", "D. 적용 안 함". ⚠️ 이 질문은 보조 선택지 규칙 적용 제외.⚠️ AUTO_MODE 가드 (CRITICAL — 최우선 평가):
AUTO_MODE=true이면 AUTO_MODE=false 블록 전체를 건너뛰고 즉시 AUTO_MODE=true 블록을 실행한다. AskUserQuestion 호출 절대 금지.
AUTO_MODE=true (최우선 분기): PM이 기본 프리셋 "기존 검증 통과(기본값)"을 자율 선택. plan_qa_presets.loop_exit가 "ask" 이외면 해당 preset 채택. 판단 근거와 결정을 auto-decisions.md에 기록. plan.md ## Loop 종료 조건 섹션에 반영.
AUTO_MODE=false: plan_qa_presets_config의 plan_qa_presets.loop_exit 값을 확인한다 (없으면 fallback).
"ask" 이외이면 자동 적용: "default_pass" → 기존 종료 조건(AC 통과 + max_iterations), "convergence" → 연속 무변경 수렴, "fixed_n" → 고정 N회 반복"ask"이면 AskUserQuestion 수행. 핵심 선택지 3개: "A. 기존 검증 통과", "B. 무변경 수렴", "C. 고정 횟수 반복". ⚠️ 이 질문은 보조 선택지 규칙 적용 제외."C. 고정 횟수 반복" 선택 시 후속 AskUserQuestion으로 N값(자연수) 수집."B. 무변경 수렴" 또는 "C. 고정 횟수 반복" 또는 UI 자동 Other 입력 시 복수 조건 AND 조합 여부 확인. "A. 조건 추가" 선택 시 동일 선택지 반복, "B. 이대로 진행" 시 종료.⚠️ AUTO_MODE=false일 때 추론 불가 항목이 1개 이상 남으면 반드시 AskUserQuestion으로 확인한다. 추론 가능으로 판정되면
(PM 추론)표기로 기입하고 AskUserQuestion을 생략할 수 있다 (Step 2.1 규칙과 동일).
질문: "이 plan이 의존하거나 연관된 다른 작업이 있나요?"
수집된 의존성은 plan.md ## 의존성 섹션에 기록. AUTO_MODE=true: PM이 자율 판단 후 auto-decisions.md에 기록.
⚠️ 기술 스택·아키텍처·코드 수준 접근법 결정은 plan 단계에서 수행하지 않습니다. 코드베이스 탐색이 필요한 기술적 결정은 /mst:request 단계에서 수행됩니다. plan에서 다루는 결정은 비즈니스 방향·사용자 경험·범위·우선순위 수준에 한정합니다.
아래 조건 해당 시 첫 질문 전에 PM이 먼저 실행:
트리거 시: "[이유]로 [ideation/discussion] 먼저 실행" 통지 → Skill(skill: "mst:ideation/discussion", args: "{주제}") → 핵심 3~5개 요약 → 후속 결정 문맥으로 선반영 (AUTO_MODE=false면 질문, AUTO_MODE=true면 자율 판단 패턴)
⚠️ CONTINUATION GUARD: 서브스킬 반환 후 즉시 다음 Step 진행 (hook이 자동 강제).
동일 세션/주제/타입 완료 이력 있으면 새 세션 생성 없이 기존 결과 재사용.
[전역 규칙] AskUserQuestion 선택지 구성 (API 제약: 최대 4개 옵션)
AUTO_MODE=false에서 콘텐츠 결정 관련 모든AskUserQuestion호출 시:
- 핵심 선택지: 최대 3개 (실제 답변 옵션)
- 보조 선택지: 반드시 1개 — ideation · discussion · explore 중 현재 맥락에 가장 적합한 것을 택 1
- Other: UI가 자동 추가하므로 사용자 자유 입력용
Other,기타,직접 입력,자유 입력,사용자 지정,Customexplicit option을 수동으로 넣지 않는다.- Step 4 저장 액션 AskUserQuestion은 보조 선택지 규칙 제외.
[전역 규칙] 선택지 표기 형식 (MANDATORY)
- content-decision explicit option label은 bare
A,B,C,D,1,2,3,4가 아니라A. {의미 요약}D. {의미 요약}또는1. {의미 요약}4. {의미 요약}형식으로 쓴다.- 사용자가 왼쪽 label만 보고도 선택지 의미를 구분할 수 있어야 한다. 예:
A. 최소 변경,B. 전면 정렬,1. 우선순위 유지.- 금지 예시:
A,B,1,α,β,γ,i,ii,iii,I,II,III, 이모지·기호만으로 된 prefix.- 후보/분기/안건을 본문에 나열할 때도 visible structural prefix는
A.,B.,C.,D.,1.,2.,3.,4.만 사용한다.
[전역 규칙] 선택지 장단점·추천 필수 — 모든 다중 선택지 AskUserQuestion 공통 선택지가 2개 이상인 모든
AskUserQuestion에서 각 선택지에 장점·단점·추천하는 상황을description또는preview필드에 반드시 포함한다.
- 내용 없이 라벨만 있는 빈 선택지는 절대 금지한다.
- 적용 제외: 순수한 예/아니오 확인 질문, 계속/종료 확인, 정보 수집형 자유 텍스트 질문.
- 구체적인 표현 형식은 아래 "선택지 장단점 표현: 3가지 유형"을 따른다.
AUTO_MODE=false: 사용자 답변 반영해 PM이 추가 질문 필요성 자율 판단, 핵심 결정 사항이 명확해질 때까지 반복AUTO_MODE=true: 사용자 질문 없이 PM이 미결 항목을 순차 처리하고, 각 항목마다 [AUTO_MODE 판단 패턴]을 적용해 결정/로그 기록을 완료할 때까지 반복AUTO_MODE=false에서만 모든 질문은 AskUserQuestion으로 동시 1개만; 총 옵션 최대 4개 (API 하드 제한: 핵심 3개 + 보조 1개, Other는 자동 추가)AUTO_MODE=false, 반드시 1개 포함 — 생략 불가):
PM이 현재 질문 맥락에 가장 적합한 것을 3가지 중 1개만 선택:
"다각도 의견 모으기 (ideation)" — 접근법이 2개 이상이고 트레이드오프가 불명확할 때"팀 토론으로 합의 찾기 (discussion)" — 복잡한 비즈니스 결정으로 합의가 필요할 때"코드베이스 탐색 + 웹검색 (explore)" — 관련 파일·현재 구현·패턴 파악 및 외부 사례 검색이 필요할 때AUTO_MODE=false)고정 선택지 선택 또는 사용자가 텍스트로 직접 ideation/discussion/explore 요청 시 현재 주제로 해당 스킬 실행:
⚠️ 직접 요청 감지: "discussion 해줘", "ideation 돌려줘", "explore 해줘", "코드 찾아줘", "웹 검색해줘" 등 텍스트로 직접 요청한 경우에도 동일하게 이 흐름을 따른다. 스킬 실행 후 반드시 Step 3으로 복귀해야 한다.
AUTO_MODE=true에서는[AUTO_MODE 판단 패턴]을 사용한다.
⚠️ CONTINUATION GUARD: 서브스킬 반환 후 즉시 다음 Step 진행 (hook이 자동 강제).
Skill(skill: "mst:ideation/discussion", args: "{주제} --focus {관련 분야}") → 동일 이력 있으면 재사용 → synthesis.md/consensus.md Read → 핵심 3~5개를 [AI 팀 의견 요약]으로 표시 → 즉시 같은 턴에서 Step 3으로 복귀하여 원 질문 동일 포맷으로 AskUserQuestion 재실행WebSearch(query: "{주제 관련 업계 표준/유사 사례/대안}") (필요 시 복수) → 결과 핵심을 [외부 리서치 결과]로 요약 → 즉시 같은 턴에서 Step 3으로 복귀하여 AskUserQuestion 재실행Skill(skill: "mst:explore", args: "{주제} --focus {관련 파일/기능}") + WebSearch("{주제} 사례 구현 패턴") → explore-report.md Read → [코드베이스 탐색 결과] 및 [웹 검색 결과] 각각 요약 → 즉시 같은 턴에서 Step 3으로 복귀하여 AskUserQuestion 재실행UI 레이아웃/컴포넌트 구조/화면 흐름/정보 밀도 비교가 필요한 단일 선택(multiSelect: false) 시 각 옵션에 텍스트 와이어프레임을 첨부한다.
description: 짧은 텍스트 설명. preview가 표시되지 않아도 의미를 잃지 않도록 핵심 차이를 담는다.preview: 우측 미리보기 패널에 표시되는 ASCII 도식. 화면명이나 컴포넌트명을 포함해 구조 차이를 바로 볼 수 있게 한다.┌─────────────┐ ← 박스로 영역 구분
│ 컴포넌트 │
└─────────────┘
[버튼A] [버튼B] ← 인라인 요소
───────────────── ← 구분선
⚠️
multiSelect: true질문에서는 preview 패널이 비활성화되므로 시각 비교가 필요한 결정은 단일 선택 질문 여러 개로 분리한다. 분리할 수 없는 multiSelect는description에[장점],[단점],[적합]을 모두 포함한다.
선택지가 2개 이상인 모든 AskUserQuestion에서 아래 3가지 유형 중 하나를 반드시 적용한다. 적용 제외: 순수한 예/아니오 확인, 계속/종료 확인, 정보 수집형 자유 텍스트 질문.
유형 1: non-visual single-select content-decision
multiSelect: false이고 UI 구조 비교가 아닌 결정 질문은 각 option label과 preview를 아래처럼 구성한다.
label: "A. 타입 안전성 우선"
description: "초기 설정 비용은 있지만 장기 유지보수 안정성을 높이는 선택"
preview: |
## 장점
- 타입 추론과 IDE 지원이 강해 후속 구현 실수를 줄입니다.
- 변경 영향이 컴파일 단계에서 빨리 드러납니다.
## 단점
- 초기 설정과 타입 정의 시간이 더 필요합니다.
- 간단한 문서 변경에는 과한 절차가 될 수 있습니다.
## PM 추천 의견
여러 스킬과 에이전트 지침이 함께 바뀌는 경우처럼 회귀 위험이 있는 변경에 추천합니다.
유형 2: visual-comparison single-select
UI/레이아웃/컴포넌트 배치/정보 배치/화면 흐름을 비교하는 질문은 각 option preview에 텍스트 와이어프레임을 포함한다.
label: "B. 좌측 탐색 유지"
description: "정보 구조가 안정적이지만 모바일 전환 시 공간이 줄어드는 배치"
preview: |
## 화면 구조
┌────────────── 대시보드 ──────────────┐
│ Nav │ Header │
│ │ ┌──── 카드 ────┐ ┌──── 카드 ─┐ │
│ │ └──────────────┘ └───────────┘ │
└──────────────────────────────────────┘
## 장점
- 주요 메뉴가 항상 보여 탐색 비용이 낮습니다.
## 단점
- 좁은 화면에서는 콘텐츠 폭이 줄어듭니다.
## PM 추천 의견
관리자 화면처럼 반복 탐색이 많은 경우에 추천합니다.
유형 3: multiSelect content-decision
multiSelect: true에서는 preview가 표시되지 않으므로 각 option.description에 [장점], [단점], [적합] 태그와 충분한 설명을 넣는다.
label: "C. 회귀 테스트 포함"
description: "[장점] 기존 흐름 파손을 빠르게 확인합니다. [단점] 실행 시간이 늘어납니다. [적합] 사용자 영향이 큰 공통 규칙 변경에 적합합니다."
이모티콘 사용 금지 — 반드시 [장점], [단점], [적합] 대괄호 텍스트 태그를 사용한다.
Q&A 반복 종료 판단 직후, DoR-Discovery(Step 3.4) 진입 전에 INVEST 6개 기준을 PM이 내부 점검한다. 미충족 기준만 사용자에게 질문하고, 충족 기준은 Q&A 없이 자동 통과한다.
| 기준 | 전체명 | PM 내부 판단 질문 |
|---|---|---|
| I | Independent | 다른 플랜/REQ 완료 없이 독립적으로 실행 가능한가? |
| N | Negotiable | 세부 구현 방식이 협상·조정 가능한 상태인가? |
| V | Valuable | 사용자 또는 비즈니스에 명확한 가치가 있는가? |
| E | Estimable | 작업 크기(복잡도/범위)를 대략적으로 추정할 수 있는가? |
| S | Small | 단일 REQ에서 완결 가능한 범위인가? |
| T | Testable | 완료 여부를 검증할 수 있는 기준(AC)이 정의 가능한가? |
AUTO_MODE=false 처리: 충족 기준은 Q&A 없이 통과. 미충족 기준: AskUserQuestion으로 질문 헤더 [INVEST 검증 — {기준약어}: {기준 전체명}] 사용. S 미충족: 분리 동의 시 Step 3.5 연계; 유지 시 예외 통과 후 근거 기록. T 미충족: Step 4에서 AC 초안 섹션 작성 유도. I/N/V/E 미충족: 답변을 plan 결정사항에 반영.
AUTO_MODE=true 처리: 모든 기준을 [AUTO_MODE 판단 패턴]으로 처리. 각 기준 판단 결과를 auto-decisions.md에 즉시 기록: | INVEST-{기준약어} | {충족/미충족 — 조치 내용} | {confidence:.2f} | PM 자율 판단 | 자율 |. S 미충족: 범위 축소 또는 분리 방향 결정 후 Step 3.5 연계. T 미충족: PM이 AC 초안 직접 작성.
전체 충족 시: 별도 Q&A 없이 Step 3.4 (DoR-Discovery Gate)로 진행
Q&A 종료 판단 직후, plan 초안 진행 전 5개 항목을 PM이 내부 점검한다. 모든 항목 충족 시 Step 3.5로 진행, 하나라도 미충족 시 분기한다.
체크리스트: (1) 문제 정의: 무엇이 없거나 잘못되었는지 명확한가? (2) 대상 사용자/시스템: 수혜자/영향 범위가 특정되었는가? (3) 성공 지표 초안: 완료됐음을 측정할 수 있는 결과가 정의되었는가? (4) 제외 범위 초안: 이번에 다루지 않을 항목이 식별되었는가? (5) 핵심 리스크 Top3: 구현 실패 또는 범위 이탈의 주요 위험이 파악되었는가?
미충족 처리:
AUTO_MODE=false:
WHILE (미충족 항목 존재):
1. 미충족 항목 목록 출력
2. AskUserQuestion으로 각 항목 보완 정보 질문 (항목당 1회)
3. 답변 반영 후 체크리스트 재점검
4. 모든 항목 충족될 때까지 반복
AUTO_MODE=true: PM이 미충족 항목을 자율 결정하고 auto-decisions.md에 기록 후 진행아래 중 하나라도 해당 시 분리 실행 제안 후 사용자 동의 요청:
분리 확정 시: plan.md ## 분리 실행 섹션에 각 책임 단위 기록.
규모가 클수록 REQ를 더 적극적으로 분리해야 합니다. 규모가 크다는 이유로 mst:request를 건너뛰고 직접 구현하는 것은 절대 금지합니다.
태스크 분해는 plan 범위 밖: REQ 내부의 태스크 분해는 mst:request 단계에서 코드베이스 탐색 결과를 바탕으로 결정합니다.
ℹ️ 이 단계는 코드베이스 탐색이 아닌 전략적 의사결정 지원에 초점을 맞춥니다. 기술 구현 수준의 검토는 /mst:request 단계의 Spec Pre-review Pass에서 수행됩니다.
Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get plan_review) → plan_review 섹션 취득 (없으면 templates/defaults/config.json fallback). enabled 값을 메모리에 보관.
3.8.1 시작 직후 {PROJECT_ROOT}/.gran-maestro/plan-context.md를 다시 Read하여 최신 선호 패턴을 전략 검토 입력으로 병합. weight=HIGH 패턴은 전략 선택의 우선 제약으로 반영. [DISPUTED] 태그 패턴은 기본 추천안에서 제외.
Q&A 대화 내용을 바탕으로 PM이 플랜 초안 텍스트를 작성한다 (디스크 미저장, 메모리 내). 이 초안은 Step 4에서 최종 제시될 내용의 초기 버전이다.
PM이 plan 초안을 바탕으로 아래 세 관점에서 직접 분석을 수행한다:
관점 A — 의도 검증 (Intent Validation): 사용자가 요청한 것(what)과 실제로 필요한 것(why)의 갭 분석. "X를 원한다고 했지만, 진짜 문제는 Y일 수 있다" 패턴 탐지. JTBD 근본 과업 확인: "사용자/시스템이 이 plan을 통해 완수하려는 근본 과업(Job)은 무엇인가?"를 명시적으로 확인. 근본 과업이 plan 범위에서 해결되지 않으면 MAJOR 이슈로 분류.
관점 B — 외부 리서치 (Industry Research): 필요하다고 판단되는 항목에 한해 WebSearch 실행 (전체 실행 강제 아님): 업계 표준·권장 패턴, 대안 솔루션, 흔한 함정.
관점 C — 범위 위험 감지 (Scope Risk Detection): 범위 크립(scope creep) 징후 탐지. "이 범위로 가면 나중에 Y 문제가 생길 수 있다" 전략적 경고. plan 외부로 번지는 영향 범위 예측.
PM이 분석 결과를 이슈로 분류:
CRITICAL: 방향이 근본적으로 잘못됨 (의도 오해, 심각한 범위/전략 문제)MAJOR: 중요한 대안·리스크가 고려되지 않음MINOR: 참고할 만한 외부 사례·패턴NO_ISSUES: 전략적 문제 없음오실레이션 탐지 (재정제 전 PM 판단 — AUTO_MODE=false): 이번 이슈 목록이 직전 라운드와 실질적으로 동일한가? 동일하면 에이전트 재dispatch 없이 반복 이슈를 하나로 합성하여 사용자에게 에스컬레이션. → "같은 이슈가 반복되고 있습니다. 방향을 결정해 주세요." (CRITICAL 수준). 이 판단은 PM의 질적 판단으로만 수행한다 (별도 에이전트 호출 금지).
AUTO_MODE=false: CRITICAL/MAJOR 이슈 존재 시: AskUserQuestion으로 이슈 제시 + 각 이슈를 해소하는 구체적 옵션 + "반영 없이 진행" + 보조 선택지 필수 1개 포함. 사용자 답변 반영하여 PM 초안 재정제. MINOR 이슈만: PM이 자체 판단으로 plan 초안에 참고 메모로 반영 → Step 4. NO_ISSUES: 바로 Step 4.
AUTO_MODE=true: 모든 이슈를 [AUTO_MODE 판단 패턴]으로 처리. 각 결정은 즉시 auto-decisions.md에 기록하고 PM 초안에 반영.
리스크 레지스터 자동 생성: 이슈 분류 완료 후 리스크 레지스터 표로 변환. 매핑: CRITICAL → 가능성/영향 모두 "상", MAJOR → "중", MINOR → "하". NO_ISSUES: "식별된 리스크 없음" 한 줄만 기재.
## 리스크 레지스터
| 리스크 | 가능성 | 영향 | 완화 방안 |
|--------|--------|------|-----------|
| {이슈 설명} | 상/중/하 | 상/중/하 | {PM 제안 완화 방안} |
Step 3.9 진입 시 초안은 전략적 검토가 반영된 정제 버전이다.
목적: D3 Reverse Simulation Gate 진입 전, plan 초안의 완전성을 적대적으로 점검해 엣지케이스, 누락 흐름, persona/NFR gap, 통합 경계 gap을 AC/리스크/제약 보강 후보로 승격한다. 이 단계는 D3의 "명료도" 검증이 아니라 "완전성" 검증이다.
Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get agile.adversarial_review)로 설정을 읽는다.
agile.adversarial_review.enabled != true이면 graceful skip 후 Step 3.9로 진행한다.edge, flow, integration이며 persona, nfr은 설정이 true인 경우에만 실행한다.max_rounds 기본값은 3, current_round 초기값은 1이다.각 perspective마다 아래 CLI를 실행한다.
python3 {PLUGIN_ROOT}/scripts/mst.py plan review --plan-path {path} --perspective {name} --json
CLI 반환값은 context_files, output_schema, perspective만 사용한다. plan 원문, Q&A 대화 맥락, DoD/JTBD 원문을 에이전트 프롬프트에 직접 포함하지 않는다.
에이전트는 반드시 독립 컨텍스트로 호출한다. Perspective별 shared route를 실행해 same-host Codex는 collaboration, same-host Claude는 Task/Agent, external route만 managed provider skill/CLI를 사용한다. Native child에는 DELEGATION BOUNDARY를 포함한다.
프롬프트 예시는 아래 두 줄만 허용한다.
역할: {perspective} 관점의 적대적 검토자.
Read로 context_files 경로를 로드하고 output_schema에 맞게 findings JSON을 반환하시오.
findings는 round별 append 방식으로 {PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/adversarial-review-findings.md에 기록한다. 각 append 블록에는 round, perspective, severity, finding, suggested_dod, requires_user_answer, question, recommended_answer, 반영 여부를 포함한다.
수렴 조건은 findings 배열이 비어있음 OR current_round >= max_rounds이다.
current_round < max_rounds이면 반영 대상 finding을 plan 초안의 AC, 제약, 리스크 레지스터, 제외 범위 중 적절한 위치에 보강한 뒤 current_round += 1로 재실행한다.current_round >= max_rounds이면 남은 finding을 파일에 기록하고 Step 3.9로 진행한다.AUTO_MODE=true:
parallel_in_auto_mode=true이면 enabled perspective를 병렬 실행하고, false이면 순차 실행한다.severity=critical|major 또는 requires_user_answer=true finding은 Critical/Major Clarification Batch Rule로 보낸다. PM이 자동 반영하지 않는다.{PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/auto-decisions.md에 근거와 반영 내용을 기록한다.AUTO_MODE=false:
edge + flow 2종을 순차 실행한다.severity=critical|major 또는 requires_user_answer=true finding은 Critical/Major Clarification Batch Rule로 묶어 사용자 confirm 후 plan 초안에 반영한다.목적: request 단계 진입 전, plan AC(인수 기준 초안)의 해석 분기점과 모호성을 역방향으로 점검해 의도 전달 손실을 차단한다.
Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get d3 pac_trace)로 d3, pac_trace 섹션 읽기 (없으면 templates/defaults/config.json fallback). 기본값:
d3.enabled=true, d3.light_mode=true, d3.ambiguity_threshold=0.2, d3.sprint_plan_threshold=0.15, d3.max_escalation_retries=3, pac_trace.enabled=trued3.agents: codex={count:2,tier:"premium"}, agy={count:0,tier:"premium"}, claude={count:0,tier:"economy"}d3.cynefin_skip=["simple","chaotic"]d3.enabled != true면 이 단계 전체 skip → Step 4. 현재 Cynefin 도메인이 d3.cynefin_skip에 포함되면 D3 skip → Step 4. complicated 또는 complex이면 D3 실행을 필수로 적용.
plan 초안의 ## 인수 기준 초안 불릿 목록을 정규화(순서/중복 제거)하여 D3 입력 리스트를 만든다. D3 실행 중에는 PAC-1..N 임시 앵커를 메모리에서 부여하고 D3 프롬프트 앞단에 고정 주입한다. Step 4 저장 시 동일 순서를 기준으로 plan.ids.json에 영구 PAC를 생성해 드리프트를 방지한다.
D3 실행 에이전트는 config의 d3.agents를 기준으로 결정 (debug.agents, explore.agents와 동일 패턴):
Bash(python3 {PLUGIN_ROOT}/scripts/mst.py config get d3.agents) 우선, 없으면 templates/defaults/config.json fallback, 둘 다 없으면 기본값 적용count > 0 항목만 dispatch 대상, 각 count만큼 독립 실행 엔트리 생성d3.agents.{provider}.tier → 모델명: config.models.providers.{provider}[tier || default_tier]으로 resolveD3는 반드시 독립 컨텍스트로 호출한다. 각 provider에 shared route를 적용해 native candidate는 host agent, external은 managed provider entrypoint를 사용한다. 입력 제한: AC 텍스트 + 용어집 + 제약 + DELEGATION BOUNDARY만 전달하며 plan 대화 맥락은 전달하지 않는다.
기본 실행은 d3.light_mode=true 기준 (저비용 모드). complicated/complex 도메인에서는 AC 형식/완결성 micro-screen 1회 선행.
AC별 출력 필수 항목:
interpretation_branches: 구현자가 다르게 해석할 수 있는 분기점ambiguity_type: AMBIGUOUS_SUBJECT | AMBIGUOUS_CONDITION | AMBIGUOUS_OUTCOME | MISSING_EDGE_CASEis_ambiguous: true | falseseverity: critical | major | minorrequires_user_answer: true | falsequestion: 사용자 의도 확인이 필요할 때 물어볼 질문recommended_answer: PM 추천 답변recommendation_rationale: 추천 근거confidence: 0.0~1.0is_ambiguous=true로 판정된 AC만 full D3로 escalation. 동일 AC가 3회 연속 confidence < 0.4이면 아키텍트 리뷰 큐로 escalation path 전환.
ambiguous_count = is_ambiguous=true인 AC 개수ambiguity_ratio = ambiguous_count / total_acagile_context_active=true이면 d3.sprint_plan_threshold 사용 (기본 0.15), 그 외는 d3.ambiguity_threshold (기본 0.2)ambiguity_ratio > threshold이면 request 진입 차단:
{PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/d3-findings.md 생성임계치 초과 판정 시 사용자 에스컬레이션 대신 자동 재지시 루프를 수행한다. 단, severity=critical|major 또는 requires_user_answer=true인 사용자 의존 모호성은 자동 재지시 대상이 아니라 Critical/Major Clarification Batch Rule 대상으로 처리한다. agile_context_active=true일 때만 강제 적용되며, 일반 plan에서도 동일 로직을 재사용할 수 있다.
d3-findings.md 기록 후 재지시 메시지 생성: "모호 AC 목록과 보완 제안을 반영해 plan 초안을 수정한 뒤 Step 3.9를 재실행하세요."d3_redirect_retries를 증가시키고 3.9.2를 재실행.d3_redirect_retries > d3.max_escalation_retries (기본 3)가 되면 루프 종료:
"[D3 재지시 소진] {max} 회 재시도 후에도 임계치 초과. 현재 plan으로 진행합니다."agile_context_active=true일 때만: python3 {PLUGIN_ROOT}/scripts/mst.py agile known-issues add {AGI_ID} --title "D3 sprint-plan 재지시 소진" --detail "PLN-{NNN} — {max} 회 재시도 후 모호도 임계치 초과. 수동 검토 필요." --severity mediumd3_redirect_exhausted=true 플래그를 plan.json에 기록
(PM 추론)수정 경로: 초안에(PM 추론)표기로 기입된 항목에 대해 사용자가 "수정 필요"로 지시하면, PM은 같은 턴에서 해당 항목만 반영해 초안을 재제시하고 수정되지 않은 다른 항목에 대해서는 재질문하지 않는다.
plan 주제, 요청 텍스트, 결정사항 섹션을 대상으로 아래 두 가지 방식 중 하나라도 해당하면 UI로 판단한다:
1. 키워드 매칭: 화면, UI, 페이지, 대시보드, 컴포넌트, 레이아웃, 프론트엔드, 디자인, 화면 설계, 목업, 시안
2. 의미 판단 (LLM): 키워드 없어도 새 화면/UI 흐름 생성이 필요하거나 기존 화면/UI가 크게 수정된다고 판단되는 경우 (예: "로그인 흐름 구성", "어드민 메뉴 신설", "결제 단계 추가", "온보딩 프로세스 설계", "기존 대시보드 레이아웃 재구성")
AUTO_MODE=false:
review 단계에서 브라우저 UI 테스트도 같이 진행할까요?## 브라우저 테스트 섹션 추가 (enabled: true) → 즉시 Step 4.1으로 진행 / "B. 이번에는 생략" → enabled: falseAUTO_MODE=true: AskUserQuestion 없이 PM이 브라우저 UI 테스트 진행(enabled: true)을 기본값으로 자율 결정하고 auto-decisions.md에 기록. 즉시 Step 4.1의 AUTO_MODE=true 분기를 실행. PM이 mst:stitch를 자동 호출해 시안을 초안에 반영.[고정층], [활성층], [변화층] 3개 태그가 모두 존재하는지 검사. 모두 있으면 agile_context_active=true, 없으면 false.agile_context_active=true일 때: [고정층] 목적 파일: 라인에서 objective.md 경로 추출 → objective.md Read → JTBD 요약, 프로젝트 DoD 전체 항목, 성공 지표를 objective_context로 보관. 없거나 파싱 실패 시 [미확인]으로 표기 (워크플로우 차단 금지).agile_context_active=false이면 objective_context 처리 전체를 skip한다 (하위 호환).
enabled: false(생략) 또는 UI 미감지 시 이 단계 전체를 skip한다 (하위 호환).
PM 추론 절차 (AUTO_MODE 공통): plan 대화 맥락(인수 기준 초안, 결정사항, 범위 섹션)에서 신규 기능 (new) 및 기존 기능 회귀 (regression) 테스트 흐름을 추론한다. 각 흐름은 1줄 설명으로 작성.
AUTO_MODE=false: PM이 추론한 테스트 흐름을 아래 형식으로 텍스트 출력 후 AskUserQuestion으로 확인:
[예상 테스트 흐름]
신규 기능:
1. {흐름 설명}
기존 기능 회귀:
1. {흐름 설명}
AskUserQuestion 선택지: "A. 위 흐름으로 확정" / "B. 흐름 수정 필요" (수정 후 반복) / "C. 코드베이스 탐색". 추가 흐름은 UI 자동 Other 입력으로 받고, 입력 시 목록에 추가한 뒤 "더 추가할 흐름이 있나요?" 후속 질문을 반복한다.
AUTO_MODE=true: PM이 자율 추론한 테스트 흐름을 AskUserQuestion 없이 바로 확정. auto-decisions.md에 기록: | 테스트 흐름 수집 | {N}개 흐름 (신규 {X}개 + 회귀 {Y}개) | {confidence:.2f} | PM 자율 판단 | 자율 |
test_flows 반영: 확정된 테스트 흐름을 ## 브라우저 테스트 섹션에 포함:
## 브라우저 테스트
- enabled: true
- execution_phase: review-pass-a
- tools: playwright | claude-in-chrome | auto
- test_flows:
- [new] {신규 기능 흐름}
- [regression] {기존 기능 회귀 흐름}
대화 내용 반영한 plan 초안 텍스트 제시 (파일은 아직 작성하지 않음)
## 인수 기준 초안 섹션을 반드시 포함한다 (MANDATORY): "이 plan이 완료됐다는 것은:" 프리픽스로 시작하는 불릿 리스트. 내용은 구현 방법이 아닌 관찰 가능한 결과/동작 중심으로 기술. 각 PAC 항목에 [TIER-A] 또는 [TIER-B] 위험도 태그를 반드시 포함 (미부여 시 기본값 TIER-B). 영향 예상 항목은 [IMPACT] 태그를 포함한 독립 불릿으로 추가 (기본 등급 [SHOULD], PM 재량으로 [MUST] 가능). [IMPACT] 항목이 0개인 plan은 graceful skip.
- [SHOULD] [IMPACT] [TIER-A] 기존 설정 화면의 입력 폼이 정상 렌더링되고 저장 기능이 동작한다## 범위 예산 (Appetite) / ## 제외 범위 (No-go Scope) 섹션을 반드시 포함한다 (빈 값 placeholder 허용)## 제약사항 (Step 2.3) / ## 우선순위 (MoSCoW) (Step 2.3) / ## 의존성 (Step 2.6) / ## 리스크 레지스터 (Step 3.8.3) 섹션 포함## Intent (JTBD) 섹션 (권장 — 생략 시 intent 파일 미생성): When I / I want to / So I can## Objective 컨텍스트 섹션 (agile_context_active=true일 때만):
## Objective 컨텍스트
- objective.md: {objective_context_path}
- objective.ids.json: {objective_anchor_manifest_path | N/A}
- JTBD 요약: {objective_jtbd_summary}
- 프로젝트 DoD: (항목 목록)
- 성공 지표: (지표 목록)
## Objective Trace 섹션 (agile_context_active=true + objective anchor manifest 존재 시 MANDATORY):
anchor_total, anchor_mapped, anchor_missing_ids를 기록한다. anchor_missing_ids가 비어있지 않으면 plan 완료로 판정하지 않는다.## 브라우저 테스트 섹션 추가 (Step 4.1에서 수집된 흐름 목록 포함)debug_context 또는 capture_context 활성, 또는 UI 감지됨 + {PROJECT_ROOT}/.gran-maestro/designs/DESIGN.md 존재 시 ## 연관 컨텍스트 섹션 포함 — 파일 경로만 기록, 내용 복사 금지:
## 연관 컨텍스트
> 상세 내용은 아래 파일을 직접 참조하세요. 내용을 이 파일에 복사하지 않습니다.
| 유형 | ID | 파일 경로 |
|------|----|-----------|
| 디버그 조사 | DBG-NNN | `.gran-maestro/debug/DBG-NNN/debug-report.md` |
| 캡처 | CAP-NNN | `.gran-maestro/captures/CAP-NNN/capture.json` |
| 디자인 시스템 | DESIGN.md | .gran-maestro/designs/DESIGN.md |
저장 전 Confidence Score Matrix 자가평가 수행
| 축 | 질문 | 점수 |
|---|---|---|
| Clarity | 요구사항·제약에 모호성/중의적 표현이 없는가? | 0.0~1.0 |
| Feasibility | 범위 내에서 기술적으로 실현 가능한가? | 0.0~1.0 |
| Decoupling | REQ 단위가 결합도 낮게 분리되었는가? | 0.0~1.0 |
| Completeness | 후속 Agent가 코드 작성하기에 정보가 충분한가? | 0.0~1.0 |
점수는 4축 요약 표 형태로 출력. 0.5 미만 항목에는 "수정 후 진행" 권고를 표시. AUTO_MODE=true에서는 0.5 미만 축을 자율 보완하고 근거를 auto-decisions.md에 기록한 뒤 진행.
⚠️ CONTINUATION GUARD: 서브스킬 반환 후 즉시 다음 Step 진행 (hook이 자동 강제).
저장 액션 결정:
AUTO_MODE=false: AskUserQuestion으로 선택지 제시
{PLN-NNN}으로 저장됨. 다음 명령으로 구현 사양(spec.md)을 작성할 수 있습니다.\n - 일반: /mst:request --plan {PLN-NNN}\n - 자율 모드: /mst:request --plan {PLN-NNN} -a (절대 /mst:approve를 안내하지 않음)
→ 즉시 이어서 AskUserQuestion: "지금 /mst:request 실행할까요?" (선택지: "A. 바로 실행" / "B. 자율 모드 실행" / "C. 여기서 종료")AUTO_MODE=true: AskUserQuestion 없이 "저장하고 /mst:request 실행" 경로를 기본값으로 즉시 진행 (규모·복잡도와 무관하게 이 경로만 허용)저장 선택 시 plans/PLN-NNN/plan.md 작성; debug_context 활성 시 plan.json에 "linked_debug" 추가
agile_context_active=true일 때만 plan.json에 "linked_objective" 필드를 추가한다.objective_context_path에서 /agile/(AGI-\d+)/objective/objective.md 패턴으로 AGI ID 추출. 성공 시 "linked_objective": "AGI-NNN", 실패 시 "linked_objective": null.agile_context_active=false이면 기록하지 않는다 (하위 호환).AUTO_MODE=true이고 저장 액션이 "저장하고 /mst:request 실행" 또는 "저장하고 /mst:request -a 실행" 경로인 경우, plan.json에 아래 next_action 필드를 반드시 기록한다:
{
"next_action": {
"expected_skill": "mst:request",
"source_skill": "mst:plan",
"source_id": "PLN-NNN",
"auto_mode": true,
"project_root": "{PROJECT_ROOT}",
"created_at": "{TS}"
}
}
{PROJECT_ROOT}/.gran-maestro/tmp/mst-next-action-${PPID}.json를 Bash로 즉시 생성한다 (plan.json 기록 직후):
mkdir -p "{PROJECT_ROOT}/.gran-maestro/tmp"
cat > "{PROJECT_ROOT}/.gran-maestro/tmp/mst-next-action-${PPID}.json" <<EOF
{"expected_skill":"mst:request","source_skill":"mst:plan","source_id":"PLN-NNN","auto_mode":true,"project_root":"{PROJECT_ROOT}","created_at":"{TS}"}
EOF
AUTO_MODE=false 또는 "저장만 하기" 경로에서는 next_action 필드를 기록하지 않고 .gran-maestro/tmp/ 마커도 생성하지 않는다..gran-maestro/tmp/ 마커와 plan.json.next_action 클리어는 mst:request push hook이 authoritative 하게 처리한다 (순차 best-effort).## 인수 기준 초안의 불릿 목록을 순서대로 정규화한다.PAC-N ID를 자동 부여한다 (PAC-1, PAC-2, ...).[SHOULD] 태그 있으면 grade="SHOULD", 그 외는 grade="MUST".[IMPACT] 태그 → tags에 "IMPACT" 추가. [TIER-A] → "TIER-A", [TIER-B] → "TIER-B". 둘 다 없으면 기본값 "TIER-B". 기존 태그와 Tier 태그는 독립적으로 공존.{PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/plan.ids.json 파일을 반드시 생성/갱신한다:
[
{ "id": "PAC-1", "text": "...", "grade": "MUST", "tags": ["TIER-B"] },
{ "id": "PAC-2", "text": "...", "grade": "SHOULD", "tags": ["IMPACT", "TIER-A"] }
]
tags 필드가 없어도 오류로 처리하지 않고 tags=[]로 간주.pac_trace.enabled != true여도 파일 생성은 유지한다 (하위 단계 호환 목적).plan.md 저장 직후, ## Intent (JTBD) 섹션이 존재하고 비어있지 않으면:
When I → --situation, I want to → --feature, So I can → --goal 및 --motivation (동일 값)
context_manifest_files가 비어있지 않으면 각 파일 경로를 --file "{파일경로}" 형태로 전달, 비어있으면 --file 인자 없이 실행:
python3 {PLUGIN_ROOT}/scripts/mst.py intent add \
--plan PLN-NNN --feature "..." --situation "..." --motivation "..." --goal "..."
반환된 INTENT_ID를 plan.json의 "linked_intent": "INTENT-NNN" 필드에 기록.
## Intent (JTBD) 섹션이 없거나 비어있으면 skip (비차단). 명령 실패 시 warn만 출력, 워크플로우 차단 금지.
capture_context 활성 시 plan.md 저장 시점에 일괄 처리 (atomic):
{PROJECT_ROOT}/.gran-maestro/captures/CAP-NNN/capture.json을 Edit: status → "consumed", consumed_at → 현재 시각, linked_plan → "PLN-NNN".plan.json에 "linked_captures": ["CAP-001", "CAP-003"] 추가.plan.md 저장 직후 아래를 수행한다:
{PROJECT_ROOT}/.gran-maestro/qa-raw/PLN-NNN.jsonl, {PROJECT_ROOT}/.gran-maestro/plan-context.md. 없으면 warn 후 skip.run_in_background: true) plan-context.md를 갱신한다.id/domain/type/statement/weight/freq/last_seen/tags)weight=HIGH 부여disputed_preferences에는 [DISPUTED] 태그 부여[DISPUTED] → NORMAL + freq=1 + 90일 미갱신 → 유사 statement 병합. weight=HIGH 항목은 압축 대상 제외)"저장하고 /mst:request 실행" / "저장하고 /mst:request -a 실행" 경로: ⚠️ plan.md 디스크 기록 확인 후에만 단 1회 호출 (미저장 상태 호출 절대 금지)
AUTO_MODE=true: Skill(skill: "mst:request", args: "--plan PLN-NNN -a {주제}")AUTO_MODE=false, 일반 실행: Skill(skill: "mst:request", args: "--plan PLN-NNN {주제}")AUTO_MODE=false, 자율 모드 선택 시: Skill(skill: "mst:request", args: "--plan PLN-NNN -a {주제}")## 분리 실행 섹션이 있으면 mst:request가 다중 REQ 자동 생성다음 단계 실행 명령:
/mst:approve REQ-NNN
다음 단계 실행 명령:\n /mst:list를 출력한다.Stitch 연계 (AUTO_MODE=false에서 선택했거나, AUTO_MODE=true에서 UI 감지된 경우):
Skill(skill: "mst:stitch", args: "--pln PLN-NNN --multi {plan 주제}") 호출 (⚠️ mcp__stitch__* 도구 직접 호출 절대 금지)## 디자인 시안 섹션으로 추가: DES-NNN ID + 프로젝트 URL, 각 화면: 화면명 + Stitch URL + html_file 경로. html_file이 null이면 해당 행 생략.AUTO_MODE=false면 Step 4 재표시 (저장/수정 선택 가능), AUTO_MODE=true면 저장 경로로 계속 진행.AUTO_MODE=true이고 plan.md 저장 완료 후 아래 요약을 반드시 출력:
[자율 실행 완료]
PLN-NNN 플랜이 자율 모드로 완성되었습니다.
- 총 자율 결정: {AUTO_DECISION_TOTAL}건
- PM 자율 판단: {AUTO_PM_COUNT}건
- discussion 사용: {AUTO_DISCUSSION_COUNT}건
- web-search→discussion 사용: {AUTO_EXPLORE_DISCUSSION_COUNT}건
자세한 결정 내역: .gran-maestro/plans/PLN-NNN/auto-decisions.md
다음 단계 실행 명령:
/mst:approve REQ-NNN
생성된 REQ ID를 특정하지 못한 경우 마지막 명령은 /mst:list로 대체한다. 위 블록 뒤에 추가 설명을 붙이지 않는다.
templates/plan.md를 기본 템플릿으로 사용하여 plan.md를 작성합니다.