makdoong2-team 2.3.2 → 3.0.1

package/scripts/gate-policy-test.sh

@@ -51,44 +51,45 @@ expect(){
 echo ""
 echo "[gate-policy-test] 조건부 auto-approve 게이트 분기"
 echo ""
-echo "── stage3-scope-verify (2→3) ──"
+echo "── stage-analysis-verify (requirements→analysis) ──"
+# scope substage 흡수로 stage-analysis-verify.sh 의 승인·정합성 검사가 이 게이트로 이관됐다.
 rm -f "$REPORT"
 
 # minor (기본): auto_approve true → 승인/pending 무시하고 통과
 mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".verification_pending=true | .policy={category:"minor",auto_approve:{"1_planning.requirements":true}}'
-expect "minor 기본 auto-approve (승인 없이 통과)" pass stage3-scope-verify.sh
+expect "minor 기본 auto-approve (승인 없이 통과)" pass stage-analysis-verify.sh
 
 # major (기본): auto_approve true → 통과 (minor 와 동일 흐름 — category 는 라벨용)
 mk '.stages."1_planning".substages."requirements".done=true | .policy={category:"major",auto_approve:{"1_planning.requirements":true}}'
-expect "major 기본도 요구사항 게이트는 무인 통과" pass stage3-scope-verify.sh
+expect "major 기본도 요구사항 게이트는 무인 통과" pass stage-analysis-verify.sh
 
 # legacy(no policy) + 미승인 → 차단
 mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".approved_by_user=false'
-expect "구형 state 미승인 → 차단" block stage3-scope-verify.sh
+expect "구형 state 미승인 → 차단" block stage-analysis-verify.sh
 
 # legacy(no policy) + 승인 → 통과
 mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".approved_by_user=true | .stages."1_planning".substages."requirements".verification_pending=false'
-expect "구형 state 사용자 승인 → 통과" pass stage3-scope-verify.sh
+expect "구형 state 사용자 승인 → 통과" pass stage-analysis-verify.sh
 
 # auto-approve여도 인터뷰 미완료면 차단 (정합성 게이트는 독립)
 mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".interview_required=true | .stages."1_planning".substages."requirements".interview_completed=false | .policy={category:"minor",auto_approve:{"1_planning.requirements":true}}'
-expect "인터뷰 미완료 → 차단 (auto와 무관)" block stage3-scope-verify.sh
+expect "인터뷰 미완료 → 차단 (auto와 무관)" block stage-analysis-verify.sh
 
 echo ""
 echo "── stage4-dev-verify (3→4) ──"
 # worktree 경로 검증을 위해 실제 git worktree 생성 (메인 repo의 형제)
 WT="$(dirname "$TMP")/$(basename "$TMP")-TEST-1"
 (cd "$ROOT" && git worktree add "$WT" -b test-branch 2>/dev/null || true)
-mk '.stages."1_planning".substages."scope".done=true | .stages."1_planning".substages."scope".verification_pending=true | .stages."2_implementation".substages."analysis".done=true | .policy={category:"minor",auto_approve:{"1_planning.scope":true}} | .worktree="'"$WT"'"'
+mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".verification_pending=true | .stages."2_implementation".substages."analysis".done=true | .policy={category:"minor",auto_approve:{"1_planning.requirements":true}} | .worktree="'"$WT"'"'
 expect "minor auto-approve → 통과" pass stage4-dev-verify.sh
-mk '.stages."1_planning".substages."scope".done=true | .stages."1_planning".substages."scope".approved_by_user=false | .stages."2_implementation".substages."analysis".done=true | .worktree="'"$WT"'"'
+mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".approved_by_user=false | .stages."2_implementation".substages."analysis".done=true | .worktree="'"$WT"'"'
 expect "구형 state 미승인 → 차단" block stage4-dev-verify.sh
-mk '.stages."1_planning".substages."scope".done=true | .stages."1_planning".substages."scope".approved_by_user=true | .stages."2_implementation".substages."analysis".done=true | .worktree="'"$WT"'"'
+mk '.stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."requirements".approved_by_user=true | .stages."2_implementation".substages."analysis".done=true | .worktree="'"$WT"'"'
 expect "구형 state 승인 → 통과" pass stage4-dev-verify.sh
 
 echo ""
 echo "── stage6-commit-verify (5→6) ──"
-TESTS='.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."scope".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."2_implementation".substages."test".integration="skip" | .stages."2_implementation".substages."test".coverage="exempt"'
+TESTS='.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."2_implementation".substages."test".integration="skip" | .stages."2_implementation".substages."test".coverage="exempt"'
 
 # minor (기본): commit auto_approve true → 보고서/승인 없이 통과
 rm -f "$REPORT"
@@ -130,20 +131,20 @@ expect "구형 state → 휴먼 게이트 없이 통과" pass stage6-commit-veri
 
 echo ""
 echo "── stage8-review-verify (7→8) ──"
-BV='.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."scope".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:true,template_match:true,section_content_match:true} | .stages."3_delivery".substages."pr".reviewer_added=true | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true'
+BV='.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:true,template_match:true,section_content_match:true} | .stages."3_delivery".substages."pr".reviewer_added=true | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true'
 mk "$BV | .policy={category:\"minor\",auto_approve:{\"3_delivery.pr\":true}}"
 expect "minor auto-approve → 통과" pass stage8-review-verify.sh
 mk "$BV | .stages.\"3_delivery\".substages.\"pr\".approved_by_user=false"
 expect "구형 state 미승인 → 차단" block stage8-review-verify.sh
 mk "$BV | .stages.\"3_delivery\".substages.\"pr\".approved_by_user=true | .stages.\"3_delivery\".substages.\"pr\".verification_pending=false"
 expect "구형 state 승인 → 통과" pass stage8-review-verify.sh
-mk '.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."scope".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:false,template_match:true,section_content_match:true} | .stages."3_delivery".substages."pr".reviewer_added=true | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true | .policy={category:"minor",auto_approve:{"3_delivery.pr":true}}'
+mk '.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:false,template_match:true,section_content_match:true} | .stages."3_delivery".substages."pr".reviewer_added=true | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true | .policy={category:"minor",auto_approve:{"3_delivery.pr":true}}'
 expect "body_validation false → 차단 (auto와 무관)" block stage8-review-verify.sh
 
-BSS='.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."scope".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:true,template_match:true,section_content_match:true} | .stages."3_delivery".substages."pr".reviewer_self_skipped=true | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true'
+BSS='.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:true,template_match:true,section_content_match:true} | .stages."3_delivery".substages."pr".reviewer_self_skipped=true | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true'
 mk "$BSS | .policy={category:\"minor\",auto_approve:{\"3_delivery.pr\":true}}"
 expect "reviewer_self_skipped=true → reviewer 없어도 통과" pass stage8-review-verify.sh
-mk '.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."1_planning".substages."scope".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:true,template_match:true,section_content_match:true} | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true | .policy={category:"minor",auto_approve:{"3_delivery.pr":true}}'
+mk '.stages."1_planning".substages."jira".done=true | .stages."1_planning".substages."requirements".done=true | .stages."2_implementation".substages."dev".done=true | .stages."2_implementation".substages."test".unit="pass" | .stages."3_delivery".substages."commit".done=true | .stages."3_delivery".substages."pr".draft_url="http://pr/1" | .stages."3_delivery".substages."pr".body_validation={no_orphan_scenarios:true,template_match:true,section_content_match:true} | .stages."3_delivery".substages."review".comments=1 | .stages."3_delivery".substages."review".all_comments_inline=true | .policy={category:"minor",auto_approve:{"3_delivery.pr":true}}'
 expect "reviewer_added·reviewer_self_skipped 모두 없음 → 차단" block stage8-review-verify.sh
 
 echo ""

package/scripts/install-lib.mjs

@@ -134,7 +134,7 @@ const LEGACY_RELATIVE_PLUGIN_REF = "./plugins/makdoong2-team/src/opencode-plugin
 const LEGACY_ABSOLUTE_TS_SUFFIX = "/src/opencode-plugin.ts";
 const LEGACY_SCOPED_NAME = "@local/makdoong2-team";
 const PLUGIN_PACKAGE_NAME = "makdoong2-team";
-const TOOLS = ["verify_stage", "dispatch_stage", "dispatch_verifier", "dispatch_research", "auto_advance_stage", "get_fallback_model"];
+const TOOLS = ["verify_stage", "dispatch_stage", "dispatch_verifier", "auto_advance_stage", "get_fallback_model"];
 const TOOL_SEARCH_PLUGIN_PREFIX = "opencode-tool-search";
 // UTIL_SCRIPTS is no longer deployed (scripts live inside the npm module).
 // Retained for cleanup: older installs copied these into ~/.config/opencode/scripts/

package/scripts/install-lib.mts

@@ -164,7 +164,7 @@ const LEGACY_RELATIVE_PLUGIN_REF = "./plugins/makdoong2-team/src/opencode-plugin
 const LEGACY_ABSOLUTE_TS_SUFFIX = "/src/opencode-plugin.ts";
 const LEGACY_SCOPED_NAME = "@local/makdoong2-team";
 const PLUGIN_PACKAGE_NAME = "makdoong2-team";
-const TOOLS = ["verify_stage", "dispatch_stage", "dispatch_verifier", "dispatch_research", "auto_advance_stage", "get_fallback_model"];
+const TOOLS = ["verify_stage", "dispatch_stage", "dispatch_verifier", "auto_advance_stage", "get_fallback_model"];
 const TOOL_SEARCH_PLUGIN_PREFIX = "opencode-tool-search";
 // UTIL_SCRIPTS is no longer deployed (scripts live inside the npm module).
 // Retained for cleanup: older installs copied these into ~/.config/opencode/scripts/

package/scripts/model-policy.mjs

@@ -69,10 +69,6 @@ export const DEFAULT_POLICIES = Object.freeze({
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
     },
     // Research fan-out worker — one session per source, spawned in parallel.
-    "makdoong2-researcher": {
-        primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
-        fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],
-    },
     "makdoong2-planner": {
         primary: { id: "github-copilot/gpt-5.6-luna", variant: "xhigh", tier: "medium" },
         fallbacks: [{ id: "github-copilot/claude-haiku-4.5", tier: "low" }],

package/scripts/model-policy.mts

@@ -130,10 +130,6 @@ export const DEFAULT_POLICIES: Readonly<Record<string, AgentModelPolicy>> = Obje
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
   },
   // Research fan-out worker — one session per source, spawned in parallel.
-  "makdoong2-researcher": {
-    primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
-    fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],
-  },
   "makdoong2-planner": {
     primary:   { id: "github-copilot/gpt-5.6-luna",          variant: "xhigh",  tier: "medium" },
     fallbacks: [{ id: "github-copilot/claude-haiku-4.5",                         tier: "low" }],

package/scripts/release.sh

@@ -160,7 +160,19 @@ info "다음 버전: $NEXT_VERSION"
 log "이번 릴리스에 포함될 커밋:"
 LAST_TAG="$(git describe --tags --abbrev=0 2>/dev/null || echo '')"
 if [ -n "$LAST_TAG" ]; then
-  git log --oneline "${LAST_TAG}..HEAD" | head -20
+  # `git log … | head -N` 을 쓰지 않는다. set -o pipefail 아래서 head 가 N 줄을
+  # 읽고 먼저 종료하면 git 이 SIGPIPE(141)로 죽고, 그 코드가 파이프라인 전체의
+  # 상태가 되어 errexit 가 **릴리스를 통째로 중단**시킨다. 커밋이 20개를 넘은
+  # 적이 없어 지금까지 잠복해 있었고, 48개 릴리스에서 실제로 발화했다.
+  # "1 파일 = 1 commit" 규약을 지키면 커밋 수는 앞으로도 쉽게 20을 넘는다.
+  # 개수 제한은 git 에게 맡긴다 — 파이프가 없어지면 발화 조건 자체가 사라진다.
+  COMMIT_TOTAL="$(git rev-list --count "${LAST_TAG}..HEAD")"
+  git log --oneline -20 "${LAST_TAG}..HEAD"
+  # `[ … ] && info …` 형태로 쓰지 않는다. 조건이 거짓이면 AND 리스트 전체가 1을
+  # 반환하고 errexit 가 그 자리에서 스크립트를 끝낸다 (CLAUDE.md 게이트 사례와 동형).
+  if [ "$COMMIT_TOTAL" -gt 20 ]; then
+    info "... 외 $((COMMIT_TOTAL - 20))개 (총 ${COMMIT_TOTAL}개)"
+  fi
 else
   git log --oneline -10
 fi

package/scripts/run-tests.mts

@@ -41,6 +41,9 @@ const STEPS = [
   "node test/install-lib.test.ts",
   "node test/skill-mcp-registry.test.ts",
   "node --test test/state-write-guard.test.ts",
+  "node --test test/apply-patch-paths.test.ts",
+  "node --test test/pipeline-shape.test.ts",
+  "node --test test/permission-scope-hardening.test.ts",
   "node --test test/state-access-guard.test.ts",
   "node --test test/git-exclude-registration.test.ts",
   "node --test test/issue-reporter-guard.test.ts",
@@ -73,6 +76,7 @@ const STEPS = [
   "node --test test/verdict-reason-injection.test.ts",
   "node --test test/verdict-hash-normalize.test.ts",
   "node --test test/session-index-fallback.test.ts",
+  "node --test test/sub-session-registry.test.ts",
   "node --test test/plugin-exports-shape.test.ts",
   "node --test test/stale-worktree-recovery.test.ts",
   "node --test test/rollback-commits.test.ts",
@@ -82,7 +86,6 @@ const STEPS = [
   "node --test test/with-fallback-no-bun.test.ts",
   "node --test test/doctor-exit-code.test.ts",
   "node --test test/example-config-portability.test.ts",
-  "node --test test/research-fanout.test.ts",
   "node --test test/stage-completion.test.ts",
   "node --test test/state-sh-write-atomicity.test.ts",
   "node --test test/gate-locale-and-path.test.ts",

package/scripts/state.sh

@@ -185,8 +185,7 @@ case "$cmd" in
       "done": false,
       "substages": {
         "jira":         {"done": false},
-        "requirements": {"done": false, "approved_by_user": false},
-        "scope":        {"done": false, "approved_by_user": false}
+        "requirements": {"done": false, "approved_by_user": false}
       }
     },
     "2_implementation": {
@@ -333,6 +332,29 @@ JSON
       | move("3_delivery.commit";       "3_delivery"; "commit")
       | move("3_delivery.pr";           "3_delivery"; "pr")
       | move("3_delivery.review";       "3_delivery"; "review")
+
+      # scope substage 흡수 (범위 확정 → requirements).
+      # 진행 중이던 워크플로우가 남긴 scope 마커를 버리지 않고 requirements 로
+      # 접는다. done / approved_by_user 는 **AND** 로 접는다 — scope 가 아직
+      # 끝나지 않았는데 requirements 만 보고 통과시키면, 흡수 전이라면 막혔을
+      # 지점을 마이그레이션이 열어주는 셈이 된다. 접은 뒤 scope 키는 지운다.
+      | (if (.stages."1_planning".substages? // {} | has("scope")) then
+             .stages."1_planning".substages.requirements =
+               ((.stages."1_planning".substages.requirements // {})
+                 + {"done": ((.stages."1_planning".substages.requirements.done // false)
+                             and (.stages."1_planning".substages.scope.done // false)),
+                    "approved_by_user":
+                      ((.stages."1_planning".substages.requirements.approved_by_user // false)
+                       and (.stages."1_planning".substages.scope.approved_by_user // false))})
+           | del(.stages."1_planning".substages.scope)
+         else . end)
+      # auto_approve 는 flat 표기를 유지하는 유일한 예외라 여기서 같이 옮긴다.
+      | (if (.policy.auto_approve? // {} | has("1_planning.scope")) then
+             .policy.auto_approve = (.policy.auto_approve
+               | ."1_planning.requirements" =
+                   ((."1_planning.requirements" // false) and ."1_planning.scope")
+               | del(."1_planning.scope"))
+         else . end)
     '
     echo "migrated[$ISSUE] $P" ;;
   *) echo "usage: state.sh {root|issue|init|status|get|set|append|migrate} ..." >&2; exit 64 ;;

package/skills/_lib/load-secret.sh

@@ -42,16 +42,26 @@ EOF
 
   # `jq -e` fails when the file cannot be parsed; capture stderr for diagnostics.
   local token jq_err
-  jq_err=$(mktemp 2>/dev/null || echo "/tmp/load-secret.$$.err")
-  token=$(jq -r --arg k "$var_name" '.secrets[$k] // empty' "$cfg_file" 2>"$jq_err")
+  # 임시 파일은 **설정 파일과 같은 디렉토리**에 만든다. 종전 폴백은 `/tmp` 을
+  # 명령문에 노출시켰는데, opencode 1.18 의 ShellTool 은 bash 명령이 참조하는
+  # 디렉토리마다 external_directory 승인을 묻고, 서브에이전트 세션에서 그 요청은
+  # 자동 거부 + 세션 abort 로 이어진다 (워크스페이스 밖 경로이므로).
+  # mktemp 실패 시에도 워크스페이스 밖으로 새지 않게 한다.
+  jq_err=""
+  jq_err=$(mktemp "$(dirname "$cfg_file")/.load-secret.XXXXXX" 2>/dev/null) || jq_err=""
+  # mktemp 실패 시 /dev/null 로 흘린다. 이때 `jq_err` 는 빈 문자열로 남으므로
+  # 아래 정리 단계가 **실제로 만든 파일만** 지운다 — `rm -f /dev/null` 은
+  # root 로 도는 환경(이슈 #8 로그의 /root/.nvm)에서 진짜로 장치 노드를 지운다.
+  local jq_err_sink="${jq_err:-/dev/null}"
+  token=$(jq -r --arg k "$var_name" '.secrets[$k] // empty' "$cfg_file" 2>"$jq_err_sink")
   local jq_status=$?
   if [ "$jq_status" -ne 0 ]; then
     printf '[%s] makdoong2-team.json is not valid JSON: %s\n' "$tag" "$cfg_file" >&2
-    if [ -s "$jq_err" ]; then sed -e "s/^/[$tag] jq: /" "$jq_err" >&2; fi
-    rm -f "$jq_err"
+    if [ -s "$jq_err_sink" ]; then sed -e "s/^/[$tag] jq: /" "$jq_err_sink" >&2; fi
+    if [ -n "$jq_err" ]; then rm -f -- "$jq_err"; fi
     return 67
   fi
-  rm -f "$jq_err"
+  if [ -n "$jq_err" ]; then rm -f -- "$jq_err"; fi
 
   if [ -z "$token" ] || [ "$token" = "null" ]; then
     cat >&2 <<EOF

package/src/hooks/session-start.sh

@@ -55,7 +55,6 @@ jq -r '
   # Planning substages
   ($p1.substages.jira // {} | "  1_planning.jira: done=" + ((.done // false) | tostring) + (if .approved_by_user then " (approved)" else "" end)),
   ($p1.substages.requirements // {} | "  1_planning.requirements: done=" + ((.done // false) | tostring) + (if .approved_by_user then " (approved)" else "" end)),
-  ($p1.substages.scope // {} | "  1_planning.scope: done=" + ((.done // false) | tostring) + (if .approved_by_user then " (approved)" else "" end)),
   
   # Implementation substages
   ($p2.substages.analysis // {} | "  2_implementation.analysis: done=" + ((.done // false) | tostring) + (if .skipped then " (skipped)" else "" end)),

package/stages/01-planning.md

@@ -1,4 +1,4 @@
-# 1–3단계 통합 Planning — `1_planning.{jira,requirements,scope}` 연속 처리
+# 통합 Planning — `1_planning.{jira,requirements}` 연속 처리
 
 **목적**: Jira 조회 → 요구사항 확정 → 개발 범위 파악을 **단일 세션**에서 완료한다.  
 **속도**: 3개 substage dispatch(모델 호출 3회)를 1회로 단축.  
@@ -15,12 +15,10 @@
 ```bash
 bash <SCRIPTS_DIR>/state.sh get <이슈키> '.stages."1_planning".substages."jira".done'
 bash <SCRIPTS_DIR>/state.sh get <이슈키> '.stages."1_planning".substages."requirements".done'
-bash <SCRIPTS_DIR>/state.sh get <이슈키> '.stages."1_planning".substages."scope".done'
 ```
 
 - `jira.done=true` → Phase 1 건너뛰고 Phase 2로 직행
-- `jira.done=true` + `requirements.done=true` → Phase 3으로 직행
-- 셋 다 `true` → 모두 완료. 완료 메시지 출력 후 종료
+- 둘 다 `true` → 모두 완료. 완료 메시지 출력 후 종료
 
 ---
 
@@ -89,7 +87,11 @@ mkdir -p .makdoong2-team/<이슈키>
 
 파일 (repo/worktree root 기준 상대경로): `.makdoong2-team/<이슈키>/requirements-draft.md`
 
-**초안 파일은 반드시 `write` 툴(filePath 인자)로 생성·갱신한다.** bash 리디렉션(`cat > …`, `printf > …` 등)과 `apply_patch` 는 같은 경로라도 훅이 차단한다 — planner 의 유일한 파일 쓰기 수단은 `write` 다. 이 경로의 `write` 는 planner READ-ONLY 원칙의 명시적 예외이며 훅이 허용한다 (issue #8).
+**초안 파일은 반드시 쓰기 *툴* 로 생성·갱신한다 — bash 리디렉션(`cat > …`, `printf > …`, `tee`, `sed -i` 등)은 같은 경로라도 훅이 차단한다.**
+- 세션에 `write` 툴이 있으면 `write(filePath=…)` 를 쓴다.
+- **`write` 가 툴 목록에 없으면 `apply_patch` 를 쓴다.** opencode 는 모델에 따라 쓰기 툴을 바꿔 끼운다 — `gpt-5` 계열 세션에는 `write`·`edit` 가 아예 없고 `apply_patch` 만 있다. 이때 패치 본문은 `*** Begin Patch` / `*** Add File: .makdoong2-team/<이슈키>/requirements-draft.md` / `*** End Patch` 형식으로 정확히 작성한다 — 훅이 본문에서 대상 경로를 파싱해 허용 경로면 통과시킨다.
+- **툴이 없다는 이유로 초안 생성을 포기하지 않는다.** 둘 중 실제로 존재하는 툴을 골라 즉시 실행하고, 차단 메시지를 받으면 그 메시지가 지시하는 형식으로 재시도한다.
+- 이 경로의 파일 쓰기는 planner READ-ONLY 원칙의 명시적 예외이며 훅이 허용한다 (issue #8).
 
 초안 구조:
 ```markdown
@@ -104,36 +106,29 @@ mkdir -p .makdoong2-team/<이슈키>
 ```bash
 # state.json 에는 반드시 상대경로만 저장한다 (절대경로 저장 시 다른 cwd 에서 접근 불가 → Read hang 유발).
 # 이 마커는 §2-5b 의 spec_hash 와 **한 쌍**이다 — spec_hash 만 기록되고 이것이 빠지면
-# stage3-scope-verify.sh 가 1_planning.scope 진입을 하드 차단한다 (issue #6-①).
+# stage-analysis-verify.sh 가 2_implementation.analysis 진입을 하드 차단한다 (issue #6-①).
 bash <SCRIPTS_DIR>/state.sh set <이슈키> \
   '.stages."1_planning".substages."requirements".draft_path' '".makdoong2-team/<이슈키>/requirements-draft.md"'
 ```
 
-### 2-3. 다출처 교차 조사 (병렬)
+### 2-3. 다출처 교차 조사
 
-**`dispatch_research` 툴 1회 호출로 소스별 조사를 병렬 실행한다.** `skill_mcp` 를 직접 순차 호출하지 않는다 — 플러그인이 소스마다 별도 세션을 동시에 띄우므로 대기 시간이 가장 느린 소스 하나로 수렴하고, 각 소스의 원자료가 이 세션의 컨텍스트를 잠식하지 않는다. **outer-world 에이전트 위임 금지.**
+**당신의 세션에서 직접 조사한다.** 소스마다 `skill(name=...)` 로 스킬을 먼저 로드한 뒤 그 스킬의 MCP 를 호출한다. 로드 전에 `skill_mcp` 를 부르면 `MCP server "<name>" not found` 로 실패한다. **outer-world 에이전트 위임 금지.**
 
-```
-dispatch_research(
-  issue = "<이슈키>",
-  worktree = "<Working directory 절대경로>",
-  context = "<Phase 1 에서 요약한 Jira 핵심 3~5줄>",
-  queries = [
-    {source: "jira",       focus: "에픽/상위 이슈, 링크 이슈, 관련 코멘트에서 구체화된 요구"},
-    {source: "confluence", focus: "관련 설계 문서, ADR, API 스펙, 운영 가이드"},
-    {source: "bitbucket",  focus: "수정 대상 파일/클래스 현재 구현, 관련 PR 이력, 테스트 패턴"}
-  ]
-)
-```
-
-조사 세션은 서로를 보지 못한다. **한 focus 가 다른 조사 결과에 의존하면 안 된다** — 의존이 필요하면 라운드를 나눠 두 번 호출한다.
+| 소스 | skill | mcp_name | 조사 범위 |
+|---|---|---|---|
+| Jira | `jira-research` | `works` | 에픽·상위 이슈·링크 이슈·서브태스크·코멘트에서 구체화된 요구와 결정 사항 |
+| Confluence | `confluence-research` | `docs` | 설계 문서·ADR·API 스펙·운영 가이드의 제약과 합의된 규약 |
+| Bitbucket | `bitbucket-research` | `repos` | 수정 대상 파일·클래스의 현재 구현, 관련 PR 이력, 기존 테스트 패턴 |
+| GitHub OSS | `github-oss-research` | (없음 — WebFetch) | 외부 오픈소스의 사용 예시·알려진 이슈·업스트림 변경 |
 
-Simple 이슈는 조사 A + C만으로 축소 가능. 외부 라이브러리가 쟁점이면 `{source: "github-oss", ...}` 를 추가한다.
+기본 조사는 **Jira → Bitbucket** 두 소스다. 설계·규약이 쟁점이면 Confluence 를, 외부 라이브러리가 쟁점이면 GitHub OSS 를 더한다. Simple 이슈는 Jira 하나로 끝낼 수 있다.
 
-**결과 읽기**: 반환 JSON 의 `artifact_path` (`.makdoong2-team/<이슈키>/research-findings.json`) 를 Read 로 읽는다. `failed` 가 있어도 **부분 성공이 정상**이므로 나머지 결과로 진행하고, 실패 소스가 요구사항 확정에 필수인 경우에만 사유를 사용자에게 보고한다. 전 소스 실패(`ok: false`)면 추측으로 채우지 말고 보고한다.
+**조사 예산은 소스당 최대 5회 호출이다.** 초과하면 그 소스는 거기서 멈추고 미확인 항목을 `미결 사항` 에 적는다.
 
-- **`status: "partial"` 은 그 자체로 정상 종료다.** 실패한 소스를 당신이 직접 조사해 메우려 하지 말 것 — `skill_mcp` 순차 호출로 결손을 메우려다 세션 예산을 전부 소진하고 **마커를 하나도 남기지 못한 채** 종료한 사고가 이틀 연속 재현됐다 (GitHub issue #9, 각 27분·17분 소모). 결손을 더 좁히고 싶으면 focus 를 좁혀 `dispatch_research` 를 **1회만** 다시 호출한다.
-- **조사 완결성을 이유로 마커 기록을 미루지 않는다 (hardrule).** 조사가 부분적이면 `gaps` 에 미확인 항목을 남기고 그 상태 그대로 산출물과 substage 마커를 기록한 뒤 종료한다. 마커가 없는 종료는 상위에서 `completion: "incomplete"` 로 분류되어 substage 전체가 재실행된다 — 부분 결과까지 함께 버려진다.
+- **부분 조사는 그 자체로 정상 종료다.** 한 소스가 응답하지 않으면 그 소스를 포기하고 나머지로 진행한다. 결손을 메우려 같은 소스를 계속 두드리다 세션 예산을 전부 소진하고 **마커를 하나도 남기지 못한 채** 종료한 사고가 이틀 연속 재현됐다 (GitHub issue #9, 각 27분·17분 소모).
+- **조사 완결성을 이유로 마커 기록을 미루지 않는다 (hardrule).** 조사가 부분적이면 미확인 항목을 초안의 `미결 사항` 에 남기고 **그 상태 그대로** 산출물과 substage 마커를 기록한 뒤 종료한다. 마커가 없는 종료는 상위에서 `completion: "incomplete"` 로 분류되어 substage 전체가 재실행된다 — 부분 결과까지 함께 버려진다.
+- 조사 결과는 별도 파일로 만들지 않는다. `requirements-draft.md` 의 `## 수집된 정보` 에 소스별로 정리한다 (출처 URL 포함).
 
 ### 2-4. 요구사항 체크리스트 확인
 
@@ -176,7 +171,7 @@ category = (criticality == "critical" OR scope_size == "large") ? "major" : base
 
 ```bash
 bash <SCRIPTS_DIR>/state.sh set <이슈키> '.policy' \
-  '{"intent_type":"Standard","change_type":"bugfix","scope_size":"small","criticality":"normal","category":"minor","auto_approve":{"1_planning.requirements":true,"1_planning.scope":true,"3_delivery.commit":true,"3_delivery.pr":true},"rationale":"<한 줄 근거>","categorized_by":"1_planning.requirements"}'
+  '{"intent_type":"Standard","change_type":"bugfix","scope_size":"small","criticality":"normal","category":"minor","auto_approve":{"1_planning.requirements":true,"3_delivery.commit":true,"3_delivery.pr":true},"rationale":"<한 줄 근거>","categorized_by":"1_planning.requirements"}'
 bash <SCRIPTS_DIR>/state.sh set <이슈키> '.policy.categorized_at' "\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\""
 ```
 
@@ -184,7 +179,7 @@ major 로 판정된 경우에도 `auto_approve` 맵은 **모두 true** 로 두
 
 ### 2-5b. 요구사항 품질 마커 (ambiguity_score · spec_hash)
 
-`stage3-scope-verify.sh` 의 요구사항 품질 게이트는 **이 두 마커가 있을 때만** 검사한다
+`stage-analysis-verify.sh` 의 요구사항 품질 게이트는 **이 두 마커가 있을 때만** 검사한다
 (구형 state 호환을 위한 조건부 검사). 즉 여기서 기록하지 않으면 통합 경로에서는
 품질 게이트가 통째로 사문화된다 — `02-requirements.md` 를 거치는 분리 경로에서는
 검사되는데 이 경로에서만 안 되는 비대칭이 생긴다. 반드시 기록한다.
@@ -206,23 +201,9 @@ bash <SCRIPTS_DIR>/state.sh get <이슈키> '.stages."1_planning".substages."req
 bash <SCRIPTS_DIR>/state.sh get <이슈키> '.stages."1_planning".substages."requirements".spec_hash'
 ```
 
-### 2-6. Requirements 완료 기록
+### 2-5c. 개발 범위 확정 (구 `1_planning.scope` — 흡수됨)
 
-```bash
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".self_check' \
-  '{"checklist_complete":true,"conflicts_resolved":true,"user_confirmed":true,"scope_clean":true,"draft_synced":true,"categorized":true,"ambiguity_scored":true,"spec_frozen":true,"draft_recorded":true}'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".verification_pending' 'false'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".done' 'true'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".done_at' "\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\""
-```
-
----
-
-## Phase 3: 개발 범위 파악 (`1_planning.scope`)
-
-2단계 조사 결과로 코드 수정 계획을 수립한다. 2단계 `bitbucket-research` 탐색을 이어서 사용한다.
-
-### 3-1. 범위 출력
+범위 확정은 요구사항 확정과 **같은 판단의 연속**이라 별도 substage 를 두지 않는다. 조사 결과로 코드 수정 계획을 여기서 함께 확정한다. §2-3 의 `bitbucket-research` 탐색을 이어서 사용한다.
 
 ```
 ### 개발 범위
@@ -234,27 +215,27 @@ bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."req
 **스코프 아웃**: <이번 이슈에서 다루지 않는 것>
 ```
 
-### 3-2. 범주 재평가 (escalation — 하향 금지)
+이 블록은 `requirements-draft.md` 에도 그대로 남긴다 — dev 단계가 초안을 읽고 작업 단위를 잡는다.
 
-실제 수정/추가 파일과 작업 단위가 확정된 뒤, `scope_size`·`criticality`를 재평가한다.
+**범주 재평가 (escalation — 하향 금지)**: 실제 수정/추가 파일과 작업 단위가 확정된 뒤 `scope_size`·`criticality` 를 재평가한다. minor → major 상향인 경우에만 갱신하며, `auto_approve` 맵은 건드리지 않고 **모두 true 로 유지**한다 — 상향은 위험도 라벨 정정에 그치고 흐름은 무인 진행을 유지한다:
 
-minor → major로 상향될 경우에만 아래 항목들을 갱신한다. `auto_approve` 맵은 건드리지 않고 **모두 true 로 유지**한다 — 상향은 위험도 라벨 정정에 그치며 흐름 자체는 무인 진행으로 유지된다:
 ```bash
 bash <SCRIPTS_DIR>/state.sh set <이슈키> '.policy.category' '"major"'
 bash <SCRIPTS_DIR>/state.sh set <이슈키> '.policy.scope_size' '"large"'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.policy.categorized_by' '"1_planning.scope"'
+bash <SCRIPTS_DIR>/state.sh set <이슈키> '.policy.categorized_by' '"1_planning.requirements"'
 ```
 
-### 3-3. Scope 완료 기록
+### 2-6. Requirements 완료 기록
 
 ```bash
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."scope".self_check' \
-  '{"paths_explicit":true,"test_scope_defined":true,"atomic_units":true,"scope_out_listed":true,"user_approved":true}'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."scope".verification_pending' 'false'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."scope".done' 'true'
-bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."scope".done_at' "\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\""
+bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".self_check' \
+  '{"checklist_complete":true,"conflicts_resolved":true,"user_confirmed":true,"scope_clean":true,"draft_synced":true,"categorized":true,"ambiguity_scored":true,"spec_frozen":true,"draft_recorded":true,"paths_explicit":true,"test_scope_defined":true,"atomic_units":true,"scope_out_listed":true}'
+bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".verification_pending' 'false'
+bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".done' 'true'
+bash <SCRIPTS_DIR>/state.sh set <이슈키> '.stages."1_planning".substages."requirements".done_at' "\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\""
 ```
 
+
 ---
 
 ## 최종 출력