makdoong2-team 1.3.0

package/dist/verdict-hash.js

@@ -0,0 +1,62 @@
+import { createHash } from "node:crypto";
+export function computeVerdictHash(raw, stage) {
+    if (typeof raw !== "string") {
+        return createHash("sha256").update(`__nonstring__::${stage}`).digest("hex").slice(0, 16);
+    }
+    const trimmed = raw.trim();
+    const parsed = parseVerdictJSON(trimmed);
+    if (parsed && Array.isArray(parsed.findings)) {
+        const items = parsed.findings
+            .map((f) => {
+            const severity = String(f?.severity ?? "").toLowerCase();
+            const key = String(f?.item ?? f?.key ?? f?.name ?? "").toLowerCase();
+            return `${severity}::${key}`;
+        })
+            .filter((s) => s !== "::")
+            .sort();
+        const signature = JSON.stringify({
+            stage,
+            verdict: String(parsed.verdict ?? parsed.status ?? "").toUpperCase(),
+            items,
+        });
+        return createHash("sha256").update(signature).digest("hex").slice(0, 16);
+    }
+    return createHash("sha256").update(trimmed.slice(0, 800)).digest("hex").slice(0, 16);
+}
+function parseVerdictJSON(raw) {
+    const fenced = raw.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidates = [];
+    if (fenced)
+        candidates.push(fenced[1]);
+    const firstBrace = raw.indexOf("{");
+    if (firstBrace >= 0) {
+        const tail = raw.slice(firstBrace);
+        let depth = 0;
+        let end = -1;
+        for (let i = 0; i < tail.length; i++) {
+            const ch = tail[i];
+            if (ch === "{")
+                depth++;
+            else if (ch === "}") {
+                depth--;
+                if (depth === 0) {
+                    end = i + 1;
+                    break;
+                }
+            }
+        }
+        if (end > 0)
+            candidates.push(tail.slice(0, end));
+    }
+    for (const c of candidates) {
+        try {
+            const obj = JSON.parse(c.trim());
+            if (obj && typeof obj === "object")
+                return obj;
+        }
+        catch {
+            /* candidate not valid JSON — try next */
+        }
+    }
+    return null;
+}

package/gates/stage-analysis-verify.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+# stage-analysis-verify.sh — 2_implementation.analysis 진입 게이트 + SKIP 판정
+#
+# 사용: stage-analysis-verify.sh <issue>
+#
+# 진입 조건:
+#   1. state.json 존재
+#   2. 1_planning.scope substage done=true
+#
+# SKIP 조건:
+#   프로젝트 루트에 build tool 마커 파일이 하나도 없음
+#   → state.json 에 skipped=true, skip_reason, done=true 마킹 후 exit 0
+#
+# 의존: jq, git (state.sh 내부에서 사용)
+set -euo pipefail
+
+ISSUE="${1:?usage: stage-analysis-verify.sh <issue>}"
+HERE="$(cd "$(dirname "$0")" && pwd)"
+SCRIPTS="$HERE/../scripts"
+
+fail() { echo "MAKDOONG2-GATE BLOCKED [2_implementation.analysis]: $*" >&2; exit 2; }
+
+q() {
+  "$SCRIPTS/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo ""
+}
+
+# 1. state.json 존재 확인
+[ -n "$(q '.issue')" ] || fail "state.json 없음. 1_planning 단계 먼저 완료 필요."
+
+# 2. 이미 done=true 인 경우 재-dispatch 차단 (SKIP 마킹으로 done 이 이미 세팅되었을 수 있음)
+ANALYSIS_DONE="$(q '.stages."2_implementation".substages."analysis".done')"
+[ "$ANALYSIS_DONE" != "true" ] || fail "이미 done=true 완료됨 — auto_advance_stage 로 다음 단계 진행"
+
+# 3. scope substage 완료 확인
+SCOPE_DONE="$(q '.stages."1_planning".substages."scope".done')"
+[ "$SCOPE_DONE" = "true" ] || fail "1_planning.scope 미완료 (done=$SCOPE_DONE)"
+
+# 3. SKIP 판정: worktree 루트에서 build tool 마커 파일 존재 여부
+WT="$(q '.worktree' | tr -d '"')"
+[ -d "$WT" ] || WT="$(pwd)"
+
+MARKERS=(
+  "package.json"
+  "build.gradle"
+  "build.gradle.kts"
+  "pom.xml"
+  "Cargo.toml"
+  "go.mod"
+  "pyproject.toml"
+  "setup.py"
+  "requirements.txt"
+  "Gemfile"
+  "mix.exs"
+  "build.sbt"
+  "composer.json"
+  "Package.swift"
+  "Makefile"
+  "CMakeLists.txt"
+)
+
+FOUND=""
+for m in "${MARKERS[@]}"; do
+  if [ -f "$WT/$m" ]; then FOUND="$m"; break; fi
+done
+
+# .csproj 는 glob 확인
+if [ -z "$FOUND" ]; then
+  if compgen -G "$WT/*.csproj" > /dev/null 2>&1; then FOUND=".csproj"; fi
+fi
+
+if [ -z "$FOUND" ]; then
+  # SKIP: state.json 마킹 후 exit 0
+  "$SCRIPTS/state.sh" set "$ISSUE" \
+    '.stages."2_implementation".substages."analysis".skipped' 'true' > /dev/null
+  "$SCRIPTS/state.sh" set "$ISSUE" \
+    '.stages."2_implementation".substages."analysis".skip_reason' \
+    '"no_build_tool_marker"' > /dev/null
+  "$SCRIPTS/state.sh" set "$ISSUE" \
+    '.stages."2_implementation".substages."analysis".done' 'true' > /dev/null
+  echo "MAKDOONG2-GATE SKIP: 2_implementation.analysis (no build tool marker in $WT)"
+  exit 0
+fi
+
+echo "MAKDOONG2-GATE OK: 2_implementation.analysis (marker=$FOUND)"

package/gates/stage2-requirements-verify.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# stage2-requirements-verify.sh <issue> — 2단계(요구사항) 진입 게이트
+# 의존: jq
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage2-requirements-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [1_planning.requirements]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — jira substage부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+[ "$(q '.stages."1_planning".substages."requirements".done')" != "true" ] || fail "이미 done=true 완료됨 — auto_advance_stage 로 다음 단계 진행"
+[ "$(q '.stages."1_planning".substages."jira".done')" = "true" ] || fail "jira substage 미완료"
+echo "MAKDOONG2-GATE OK: 1_planning.requirements"

package/gates/stage3-scope-verify.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# stage3-scope-verify.sh <issue> — 3단계(범위 확정) 진입 게이트
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage3-scope-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [1_planning.scope]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — jira substage부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+[ "$(q '.stages."1_planning".substages."scope".done')" != "true" ] || fail "이미 done=true 완료됨 — auto_advance_stage 로 다음 단계 진행"
+[ "$(q '.stages."1_planning".substages."requirements".done')" = "true" ] || fail "requirements substage 미완료"
+
+if [ "$(q '.policy.auto_approve."1_planning.requirements"')" != "true" ]; then
+  [ "$(q '.stages."1_planning".substages."requirements".approved_by_user')" = "true" ] \
+    || fail "requirements substage 사용자 승인 없음 (또는 .policy.auto_approve.\"1_planning.requirements\" 미설정)"
+  if [ "$(q '.stages."1_planning".substages."requirements".verification_pending')" = "true" ]; then
+    fail "requirements substage 검증 대기 중 (verification_pending) — 사용자 승인 후 approved_by_user를 기록하라"
+  fi
+fi
+
+if [ "$(q '.stages."1_planning".substages."requirements".interview_required')" = "true" ]; then
+  [ "$(q '.stages."1_planning".substages."requirements".interview_completed')" = "true" ] \
+    || fail "requirements substage 인터뷰 미완료 — 모든 미결 항목 해소 후 interview_completed=true 기록 필요"
+fi
+
+# --- 요구사항 품질 게이트 (조건부 — 마커 존재 시에만 검사, 구형 state 호환) ---
+# 1) Ambiguity Score 수렴: 기록된 값이 0.2 초과면 요구사항 미수렴 (stages/02-requirements.md §2-3-2b)
+AMB="$(q '.stages."1_planning".substages."requirements".ambiguity_score')"
+if [ "$AMB" != "__MISSING__" ] && [ "$AMB" != "null" ] && [ -n "$AMB" ]; then
+  awk -v a="$AMB" 'BEGIN { exit (a + 0 <= 0.2) ? 0 : 1 }' \
+    || fail "ambiguity_score=$AMB > 0.2 — 요구사항 미수렴. 인터뷰로 미결 항목 해소 후 재산정하라"
+fi
+
+# 2) 명세 동결(spec drift) 검증: spec_hash 기록 시 draft 파일 해시 재계산 일치 필요 (§2-4a)
+SPEC_HASH="$(q '.stages."1_planning".substages."requirements".spec_hash')"
+if [ "$SPEC_HASH" != "__MISSING__" ] && [ "$SPEC_HASH" != "null" ] && [ -n "$SPEC_HASH" ]; then
+  DRAFT="$(q '.stages."1_planning".substages."requirements".draft_path')"
+  ROOT="$("$HERE/../scripts/state.sh" root)"
+  { [ "$DRAFT" != "__MISSING__" ] && [ "$DRAFT" != "null" ] && [ -f "$ROOT/$DRAFT" ]; } \
+    || fail "spec_hash 기록됨 그러나 확정 명세 파일 없음 (draft_path=$DRAFT)"
+  ACTUAL="$(sha256sum "$ROOT/$DRAFT" | cut -d' ' -f1)"
+  [ "$ACTUAL" = "$SPEC_HASH" ] \
+    || fail "확정 명세 무단 변경 감지 (spec drift) — 동결 후 변경은 사용자 재승인 + spec_hash 재기록 절차만 허용 (stages/02-requirements.md §2-4a)"
+fi
+echo "MAKDOONG2-GATE OK: 1_planning.scope"

package/gates/stage4-dev-post-verify.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# stage4-dev-post-verify.sh <issue> — 4단계(개발) 종료 게이트.
+# ─────────────────────────────────────────────────────────
+# 검증 항목:
+#   1. worktree 가 존재하는가
+#   2. dev-written-files.txt 에 기록된 모든 파일이 staging(index) 혹은 HEAD tree 에 존재하는가
+#   3. .gitignore 를 존중한 untracked 파일이 0인가
+#
+# 불변식: 3_delivery.commit 는 untracked 를 자동 제외하므로,
+#         본 게이트를 통과한 파일만이 커밋 대상에 진입한다.
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage4-dev-post-verify.sh <issue>}"
+
+fail(){ echo "MAKDOONG2-GATE BLOCKED [2_implementation.dev_post]: $1" >&2; exit 2; }
+
+WT="$("$HERE/../scripts/state.sh" get "$ISSUE" '.worktree' 2>/dev/null | tr -d '"' || echo "")"
+[ -n "$WT" ] && [ -d "$WT" ] || fail "worktree 경로 부재 또는 접근 불가: $WT"
+
+TRACK="$WT/.makdoong2-team/$ISSUE/dev-written-files.txt"
+
+MISSING=""
+if [ -f "$TRACK" ]; then
+  while IFS= read -r F; do
+    [ -z "$F" ] && continue
+    if git -C "$WT" diff --cached --name-only | grep -qxF "$F"; then
+      continue
+    fi
+    if git -C "$WT" ls-tree -r --name-only HEAD 2>/dev/null | grep -qxF "$F"; then
+      continue
+    fi
+    if [ ! -e "$WT/$F" ]; then
+      continue
+    fi
+    MISSING="${MISSING}
+  - $F"
+  done < <(sort -u "$TRACK")
+fi
+
+UNTRACKED="$(git -C "$WT" ls-files --others --exclude-standard 2>/dev/null || true)"
+
+if [ -n "$MISSING" ] || [ -n "$UNTRACKED" ]; then
+  MSG="Engineer 가 편집한 파일이 staging area 에 포함되지 않았다."
+  MSG="${MSG}
+Publisher(3_delivery.commit) 가 untracked 파일을 자동 제외하므로 여기서 통과하지 못하면 신규 소스코드가 커밋되지 않는다."
+  if [ -n "$MISSING" ] && [ -f "$TRACK" ]; then
+    MSG="${MSG}
+
+[dev-written-files.txt 에 기록됐지만 staged 아님]${MISSING}"
+  fi
+  if [ -n "$UNTRACKED" ]; then
+    MSG="${MSG}
+
+[.gitignore 존중 untracked 파일 (안전망 감지)]
+$(echo "$UNTRACKED" | sed 's/^/  - /')"
+  fi
+  MSG="${MSG}
+
+→ 조치: worktree($WT) 에서 각 파일에 'git add -- <파일>' 실행 후 dev.done 재기록.
+→ 자동화 필요: tool.execute.after 훅이 auto git add 를 수행해야 하는데 미동작. 훅 상태 점검 필요."
+  fail "$MSG"
+fi
+
+echo "MAKDOONG2-GATE OK: 2_implementation.dev_post"

package/gates/stage4-dev-verify.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# stage4-dev-verify.sh <issue> — 4단계(개발) 진입 게이트
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage4-dev-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [2_implementation.dev]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — planning phase부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+assert_worktree_sibling(){
+  local wt="$1" main pwt pmain
+  [ -d "$wt" ] || fail "worktree 경로가 존재하지 않음: $wt"
+  main="$(git -C "$wt" worktree list --porcelain 2>/dev/null | awk '/^worktree /{print $2; exit}')"
+  [ -n "$main" ] || fail "메인 repo 식별 실패"
+  [ "$wt" != "$main" ] || fail "worktree가 메인 repo와 동일 경로 — dev 단계는 별도 worktree 필요 (메인: $main)"
+  pwt="$(cd "$(dirname "$wt")" && pwd -P)"
+  pmain="$(cd "$(dirname "$main")" && pwd -P)"
+  [ "$pwt" = "$pmain" ] || fail "worktree가 메인 repo의 형제 디렉토리가 아님: $wt (메인: $main)"
+}
+[ "$(q '.stages."2_implementation".substages."dev".done')" != "true" ] || fail "이미 done=true 완료됨 — auto_advance_stage 로 다음 단계 진행"
+[ "$(q '.stages."1_planning".substages."scope".done')" = "true" ] || fail "scope substage 미완료"
+# analysis substage 는 게이트가 SKIP 시 done=true 로 마킹하므로 skipped 여부와 무관하게 done=true 검사만 하면 된다.
+[ "$(q '.stages."2_implementation".substages."analysis".done')" = "true" ] || fail "analysis substage 미완료 (skipped 도 done=true 로 처리됨)"
+
+WT="$(q '.worktree')"
+[ -n "$WT" ] && [ "$WT" != "__MISSING__" ] || fail "worktree 경로 미설정 — state.json의 .worktree 필드 확인"
+assert_worktree_sibling "$WT"
+
+if [ "$(q '.policy.auto_approve."1_planning.scope"')" != "true" ]; then
+  [ "$(q '.stages."1_planning".substages."scope".approved_by_user')" = "true" ] \
+    || fail "scope substage 사용자 승인 없음 (또는 .policy.auto_approve.\"1_planning.scope\" 미설정)"
+  if [ "$(q '.stages."1_planning".substages."scope".verification_pending')" = "true" ]; then
+    fail "scope substage 검증 대기 중 (verification_pending) — 사용자 승인 후 approved_by_user를 기록하라"
+  fi
+fi
+echo "MAKDOONG2-GATE OK: 2_implementation.dev"

package/gates/stage5-coverage-verify.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# stage5-coverage-verify.sh <issue>
+# 수정된 코드의 테스트 커버리지가 임계값 이상인지 검증한다.
+# 임계값은 makdoong2-team.json 의 coverage.threshold 로 조정 (기본: 95).
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage5-coverage-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+THRESHOLD="$("$HERE/../scripts/config.sh" get coverage.threshold 95)"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [2_implementation.coverage]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+
+COV="$(q '.stages."2_implementation".substages."test".coverage')"
+ATTEMPT="$(q '.stages."2_implementation".substages."test".coverage_attempt')"
+[ "$ATTEMPT" = "__MISSING__" ] && ATTEMPT=1
+
+case "$COV" in
+  pass)
+    PCT="$(q '.stages."2_implementation".substages."test".coverage_pct')"
+    echo "MAKDOONG2-GATE OK: 2_implementation.coverage (${PCT}% >= ${THRESHOLD}%, 시도 ${ATTEMPT}/2)"
+    ;;
+  exempt)
+    echo "MAKDOONG2-GATE OK: 2_implementation.coverage (exempt — 사용자 승인됨, 시도 ${ATTEMPT}/2)"
+    ;;
+  fail)
+    PCT="$(q '.stages."2_implementation".substages."test".coverage_pct')"
+    fail "커버리지 미달 (${PCT}% < ${THRESHOLD}%, 시도 ${ATTEMPT}/2, 최대 2라운드) — 테스트를 추가하거나 사용자 승인 후 exempt 처리"
+    ;;
+  __MISSING__)
+    fail "커버리지 미측정 — test substage에서 커버리지를 측정하고 state.json에 기록하라"
+    ;;
+  *)
+    fail "coverage 상태 불명확 ($COV) — pass / fail / exempt 중 하나여야 함"
+    ;;
+esac

package/gates/stage5-test-verify.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# stage5-test-verify.sh <issue> — 5단계(테스트) 진입 게이트
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage5-test-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [2_implementation.test]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — planning phase부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+assert_worktree_sibling(){
+  local wt="$1" main pwt pmain
+  [ -d "$wt" ] || fail "worktree 경로가 존재하지 않음: $wt"
+  main="$(git -C "$wt" worktree list --porcelain 2>/dev/null | awk '/^worktree /{print $2; exit}')"
+  [ -n "$main" ] || fail "메인 repo 식별 실패"
+  [ "$wt" != "$main" ] || fail "worktree가 메인 repo와 동일 경로 — 별도 worktree 필요"
+  pwt="$(cd "$(dirname "$wt")" && pwd -P)"
+  pmain="$(cd "$(dirname "$main")" && pwd -P)"
+  [ "$pwt" = "$pmain" ] || fail "worktree가 메인 repo의 형제 디렉토리가 아님: $wt (메인: $main)"
+}
+[ "$(q '.stages."2_implementation".substages."test".done')" != "true" ] || fail "이미 done=true 완료됨 — auto_advance_stage 로 다음 단계 진행"
+[ "$(q '.stages."2_implementation".substages."dev".done')" = "true" ] || fail "dev substage 미완료"
+WT="$(q '.worktree')"
+assert_worktree_sibling "$WT"
+echo "MAKDOONG2-GATE OK: 2_implementation.test"

package/gates/stage6-commit-verify.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# stage6-commit-verify.sh <issue> — 6단계(커밋) 진입 게이트
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage6-commit-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [3_delivery.commit]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — planning phase부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+U="$(q '.stages."2_implementation".substages."test".unit')"
+case "$U" in
+  pass|skip) : ;;
+  fail) fail "단위 테스트 실패 — dev substage로 복귀해 수정하라" ;;
+  *)    fail "단위 테스트 결과 미기록(unit=$U) — test substage 미완료" ;;
+esac
+I="$(q '.stages."2_implementation".substages."test".integration')"
+case "$I" in
+  pass|skip) : ;;
+  fail) fail "통합 테스트 실패 — dev substage로 복귀해 수정하라" ;;
+  *)    fail "통합 테스트 결과 미기록(integration=$I) — test substage 미완료" ;;
+esac
+"$HERE/stage5-coverage-verify.sh" "$ISSUE"
+
+if [ "$(jq -r '.policy.auto_approve."3_delivery.commit"' "$P" 2>/dev/null)" = "false" ]; then
+  # [Check 1] verification_pending=true: 보고서 생성 완료, 사용자 승인 대기 중 → BLOCK
+  # (report 존재 여부보다 먼저 확인 — publisher가 보고서를 생성하고 pending을 세팅한 상태)
+  if [ "$(q '.stages."3_delivery".substages."commit".verification_pending')" = "true" ]; then
+    fail "major 이슈 — 커밋 승인 대기 중(verification_pending) — 사용자 승인 후 approved_by_user=true 기록 + verification_pending=false 해소"
+  fi
+  # [Check 2] 보고서가 있는데 미승인 → BLOCK
+  # (report 없음 = 최초 dispatch 시점 → PASS하여 publisher가 보고서를 생성할 수 있도록 허용)
+  REPORT="$(dirname "$P")/change-report.md"
+  if [ -f "$REPORT" ]; then
+    [ "$(q '.stages."3_delivery".substages."commit".approved_by_user')" = "true" ] \
+      || fail "major 이슈 — 최종 커밋 사용자 미승인. 보고서 검토 후 .stages.\"3_delivery\".substages.\"commit\".approved_by_user=true를 기록하라"
+  fi
+  # [Check 3 — implicit] report 없음 + pending 없음 = 초기 상태 → PASS
+  # publisher 첫 dispatch가 진입하여 change-report.md를 생성한다.
+fi
+
+echo "MAKDOONG2-GATE OK: 3_delivery.commit"

package/gates/stage6-post-commit-verify.sh

@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+# stage6-post-commit-verify.sh <issue> — 6단계 커밋 완료 후 검증 게이트
+# ─────────────────────────────────────────────────────────
+# 검증 항목:
+#   1. worktree 가 메인 repo 의 형제 디렉토리인지
+#   2. base_sha 기록 + HEAD 조상 여부
+#   3. base_sha..HEAD 커밋 수 > 0
+#   4. 각 커밋이 정확히 1개 파일만 포함 (1 파일 = 1 commit 원칙)
+#   5. 각 커밋 subject 에 결합어 (and / & / + / 및 / 그리고) 없음
+#   6. 각 커밋 subject 가 Git Commit Guidelines 형식 준수
+#      - 형식: <Type>: <이슈키> - <요약> (제목 50자 이내, 마침표 없음)
+#      - Type: Feat/Fix/Chore/Refactor/Docs/Style/Test/Perf/Ci/Build/Revert
+#      - 이슈키 = 인자로 받은 $ISSUE 와 정확히 일치
+#   7. 각 커밋 본문에 이슈 참조 마커 ([RV] <이슈키>) 포함
+#   8. atomic_review.all_atomic == true + one_file_per_commit == true
+#   9. atomic_review.count_commits == 실제 커밋 수
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage6-post-commit-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [3_delivery.commit_post]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — planning phase부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+
+assert_worktree_sibling(){
+  local wt="$1" main pwt pmain
+  [ -d "$wt" ] || fail "worktree 경로가 존재하지 않음: $wt"
+  main="$(git -C "$wt" worktree list --porcelain 2>/dev/null | awk '/^worktree /{print $2; exit}')"
+  [ -n "$main" ] || fail "메인 repo 식별 실패"
+  [ "$wt" != "$main" ] || fail "worktree가 메인 repo와 동일 경로 — 별도 worktree 필요"
+  pwt="$(cd "$(dirname "$wt")" && pwd -P)"
+  pmain="$(cd "$(dirname "$main")" && pwd -P)"
+  [ "$pwt" = "$pmain" ] || fail "worktree가 메인 repo의 형제 디렉토리가 아님: $wt (메인: $main)"
+}
+
+WT="$(q '.worktree')"
+assert_worktree_sibling "$WT"
+
+# ─── §2. base_sha ───
+BASE="$(q '.stages."3_delivery".substages."commit".base_sha')"
+{ [ -n "$BASE" ] && [ "$BASE" != "null" ] && [ "$BASE" != "__MISSING__" ]; } || \
+  fail "commit substage base_sha 미기록 — commit substage 시작 시 git rev-parse HEAD를 base_sha로 기록해야 함"
+git -C "$WT" merge-base --is-ancestor "$BASE" HEAD 2>/dev/null || \
+  fail "base_sha($BASE)가 현재 HEAD의 조상이 아님 — base_sha 또는 분기 상태 확인 필요"
+
+# ─── §3. 커밋 수 > 0 ───
+N=$(git -C "$WT" rev-list --count "$BASE..HEAD" 2>/dev/null || echo 0)
+[ "$N" -gt 0 ] || fail "base_sha와 HEAD가 동일 — commit substage에서 만든 커밋이 없음"
+
+# ─── §4. 1 파일 = 1 commit 원칙 (hardrule) ───
+MULTI_FILE_VIOLATIONS=""
+for SHA in $(git -C "$WT" rev-list "$BASE..HEAD"); do
+  NF=$(git -C "$WT" show --name-only --pretty="" "$SHA" | grep -c . || true)
+  if [ "$NF" -ne 1 ]; then
+    SUBJ=$(git -C "$WT" log -1 --format='%s' "$SHA")
+    MULTI_FILE_VIOLATIONS="${MULTI_FILE_VIOLATIONS}
+  - ${SHA:0:7} '${SUBJ}' 파일수=${NF} (기대: 1)"
+  fi
+done
+[ -z "$MULTI_FILE_VIOLATIONS" ] || \
+  fail "1 파일 = 1 commit 원칙 위반. 각 커밋은 정확히 1개 파일만 포함해야 함:${MULTI_FILE_VIOLATIONS}
+  → 조치: 'bash <SCRIPTS_DIR>/rollback-commits.sh $ISSUE' 후 파일별로 재커밋"
+
+# ─── §5. 결합어 검사 ───
+BAD=$(git -C "$WT" log --format='%s' "$BASE..HEAD" | grep -cE ' and | & | \+ | 및 | 그리고 ' || true)
+[ "$BAD" -eq 0 ] || \
+  fail "커밋 subject에 결합어(and / & / + / 및 / 그리고) ${BAD}건 발견 — 1 commit = 1 change 위반 가능. git log로 확인 후 재구성하라"
+
+# ─── §6. 커밋 메시지 형식 재검증 ───
+# 형식: ^(Feat|Fix|Chore|Refactor|Docs|Style|Test|Perf|Ci|Build|Revert): <ISSUE> - <요약>$
+# 제목 50자 이내, 마침표 없음
+MSG_FMT_RE="^(Feat|Fix|Chore|Refactor|Docs|Style|Test|Perf|Ci|Build|Revert): ${ISSUE} - .+$"
+MSG_VIOLATIONS=""
+while IFS= read -r line; do
+  # line 형식: <SHA_short><TAB><subject>
+  SHA="${line%%$'\t'*}"
+  SUBJ="${line#*$'\t'}"
+  if ! [[ "$SUBJ" =~ $MSG_FMT_RE ]]; then
+    MSG_VIOLATIONS="${MSG_VIOLATIONS}
+  - ${SHA} '${SUBJ}' 형식 불일치 (기대: <Type>: ${ISSUE} - <요약>)"
+    continue
+  fi
+  # wc -m 은 로케일 기준 문자 수 (bash ${#SUBJ} 는 UTF-8 바이트 수로 한글 3배).
+  SUBJ_LEN=$(printf '%s' "$SUBJ" | wc -m)
+  if [ "$SUBJ_LEN" -gt 50 ]; then
+    MSG_VIOLATIONS="${MSG_VIOLATIONS}
+  - ${SHA} '${SUBJ}' 제목 ${SUBJ_LEN}자 초과 (최대 50자)"
+  fi
+  # 마침표 금지
+  if [[ "$SUBJ" == *. ]]; then
+    MSG_VIOLATIONS="${MSG_VIOLATIONS}
+  - ${SHA} '${SUBJ}' 제목 끝에 마침표 금지"
+  fi
+done < <(git -C "$WT" log --format='%h%x09%s' "$BASE..HEAD")
+
+[ -z "$MSG_VIOLATIONS" ] || \
+  fail "커밋 메시지 형식 위반:${MSG_VIOLATIONS}
+  → 조치: git commit --amend 로 수정하거나 rollback-commits.sh 후 재작성"
+
+# ─── §7. 이슈 참조 마커 확인 ───
+# 커밋 body 어딘가에 [RV] <이슈키> 마커가 포함되어야 한다.
+# body 가 빈 커밋은 허용하되 (선택), body 가 있다면 마커 필수.
+KW_RE='\[RV\][[:space:]]+[A-Z]+-[0-9]+'
+KW_VIOLATIONS=""
+for SHA in $(git -C "$WT" rev-list "$BASE..HEAD"); do
+  BODY=$(git -C "$WT" log -1 --format='%b' "$SHA")
+  if [ -n "$(printf '%s' "$BODY" | tr -d '[:space:]')" ]; then
+    if ! printf '%s' "$BODY" | grep -qE "$KW_RE"; then
+      SUBJ=$(git -C "$WT" log -1 --format='%s' "$SHA")
+      KW_VIOLATIONS="${KW_VIOLATIONS}
+  - ${SHA:0:7} '${SUBJ}' 본문에 이슈 참조 마커 없음 ([RV] ${ISSUE} 필요)"
+    fi
+  fi
+done
+[ -z "$KW_VIOLATIONS" ] || \
+  fail "커밋 본문에 이슈 참조 마커 누락:${KW_VIOLATIONS}"
+
+# ─── §8. atomic_review 마커 ───
+A="$(q '.stages."3_delivery".substages."commit".atomic_review.all_atomic')"
+[ "$A" = "true" ] || \
+  fail "atomic_review.all_atomic 미기록 또는 false — 각 커밋이 단일 변경인지 검토 후 true로 기록해야 함"
+OFPC="$(q '.stages."3_delivery".substages."commit".atomic_review.one_file_per_commit')"
+[ "$OFPC" = "true" ] || \
+  fail "atomic_review.one_file_per_commit 미기록 또는 false — 1 파일/commit 자체 검토 후 true로 기록해야 함"
+
+# ─── §9. count_commits 일치 ───
+C="$(q '.stages."3_delivery".substages."commit".atomic_review.count_commits')"
+[ "$C" = "$N" ] || \
+  fail "atomic_review.count_commits=$C 와 실제 커밋 수 $N 불일치 — 다시 기록하라"
+
+echo "MAKDOONG2-GATE OK: 3_delivery.commit_post (${N}개 커밋 모두 1파일/commit + 메시지 형식 통과)"

package/gates/stage7-post-pr-verify.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# stage7-post-pr-verify.sh <issue> — 7단계(PR 생성) post-execution 게이트
+#
+# 원칙: entry gate 는 전제조건, post-verify 는 완료 조건. publisher 가 §2-5 마지막에
+# .done=true 를 기록하기 직전 본 스크립트를 호출한다. 실패 시 exit 2 로 publisher
+# 재작업 loop 를 유도한다.
+#
+# 검사 항목 (완료조건):
+#   1) origin/<current-branch> 원격 브랜치 존재 (git push 성공 여부)
+#   2) .stages.3_delivery.substages.pr.draft_url 이 HTTPS URL 문자열
+#   3) .stages.3_delivery.substages.pr.body_validation 3항목 모두 true
+#   4) reviewer 마커 (reviewer_added=true XOR reviewer_self_skipped=true; 상호 배타)
+#   5) .stages.3_delivery.substages.pr.done == true (publisher 자기선언)
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage7-post-pr-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-POSTGATE BLOCKED [3_delivery.pr_post]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+
+WT="$(q '.worktree')"
+[ -d "$WT" ] || fail "worktree 경로 없음: $WT"
+
+BR="$(git -C "$WT" rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')"
+[ -n "$BR" ] || fail "현재 브랜치 확인 불가"
+git -C "$WT" rev-parse --verify "origin/$BR" >/dev/null 2>&1 \
+  || fail "remote 에 push 되지 않음 (origin/$BR 없음) — publisher 가 §2-4 에서 git push -u origin HEAD 를 실행했는지 확인"
+
+URL="$(q '.stages."3_delivery".substages."pr".draft_url')"
+case "$URL" in
+  http://*|https://*) : ;;
+  *) fail "draft_url 이 유효한 HTTPS URL 문자열 아님: $URL" ;;
+esac
+
+for k in no_orphan_scenarios template_match section_content_match; do
+  v="$(q ".stages.\"3_delivery\".substages.\"pr\".body_validation.$k")"
+  [ "$v" = "true" ] || fail "body_validation.$k=$v — 3항목 모두 true 여야 함"
+done
+
+RA="$(q '.stages."3_delivery".substages."pr".reviewer_added')"
+RS="$(q '.stages."3_delivery".substages."pr".reviewer_self_skipped')"
+if [ "$RA" = "true" ] && [ "$RS" = "true" ]; then
+  fail "reviewer 마커 상호 배타 위반 — reviewer_added 와 reviewer_self_skipped 가 동시에 true"
+fi
+if [ "$RA" != "true" ] && [ "$RS" != "true" ]; then
+  fail "reviewer 마커 미기록 — reviewer_added=true 또는 reviewer_self_skipped=true 중 하나 필수"
+fi
+
+D="$(q '.stages."3_delivery".substages."pr".done')"
+[ "$D" = "true" ] || fail "pr.done 이 true 아님(=$D) — publisher 가 §2-5 완료 마킹을 누락"
+
+echo "MAKDOONG2-POSTGATE OK: 3_delivery.pr_post"

package/gates/stage7-pr-verify.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# stage7-pr-verify.sh <issue> — 7단계(PR 생성) 진입 게이트
+#
+# 원칙: entry gate 는 substage 진입 "전제조건" 만 검사한다.
+# 완료 조건(원격 push 여부, PR URL 존재, reviewer 등)은 publisher 가 substage 수행 후
+# stage7-post-pr-verify.sh + verifier 에서 검증된다.
+#
+# 검사 항목 (전제조건):
+#   1) state.json 존재
+#   2) 3_delivery.commit substage 완료
+#   3) worktree 가 메인 repo 의 형제 디렉토리로 존재
+#   4) worktree 에 uncommitted 변경 없음 (tracked 파일 기준; untracked 는 무시)
+#   5) 현재 브랜치 확인 가능
+#
+# 제거된 조건 (완료조건 → post-verify 로 이동):
+#   * origin/<BR> 원격 브랜치 존재 여부 — publisher 가 §2-4 에서 git push 를 수행하므로
+#     first-entry 시점에는 존재할 수 없음. chicken-and-egg 방지를 위해 post-verify 로 이관.
+set -euo pipefail
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ISSUE="${1:?usage: stage7-pr-verify.sh <issue>}"
+P="$("$HERE/../scripts/state.sh" root)/.makdoong2-team/$ISSUE/state.json"
+fail(){ echo "MAKDOONG2-GATE BLOCKED [3_delivery.pr]: $1" >&2; exit 2; }
+[ -f "$P" ] || fail "state.json 없음 — planning phase부터 시작하라"
+q(){ "$HERE/../scripts/state.sh" get "$ISSUE" "$1" 2>/dev/null || echo "__MISSING__"; }
+assert_worktree_sibling(){
+  local wt="$1" main pwt pmain
+  [ -d "$wt" ] || fail "worktree 경로가 존재하지 않음: $wt"
+  main="$(git -C "$wt" worktree list --porcelain 2>/dev/null | awk '/^worktree /{print $2; exit}')"
+  [ -n "$main" ] || fail "메인 repo 식별 실패"
+  [ "$wt" != "$main" ] || fail "worktree가 메인 repo와 동일 경로 — 별도 worktree 필요"
+  pwt="$(cd "$(dirname "$wt")" && pwd -P)"
+  pmain="$(cd "$(dirname "$main")" && pwd -P)"
+  [ "$pwt" = "$pmain" ] || fail "worktree가 메인 repo의 형제 디렉토리가 아님: $wt (메인: $main)"
+}
+[ "$(q '.stages."3_delivery".substages."commit".done')" = "true" ] || fail "commit substage 미완료"
+WT="$(q '.worktree')"
+assert_worktree_sibling "$WT"
+
+MODIFIED="$(git -C "$WT" status --porcelain | grep -v '^?? ' || true)"
+
+if [ -n "$MODIFIED" ]; then
+  fail "worktree에 uncommitted 변경(M/A/D/R)이 있음 — 커밋하거나 제거 필요"
+fi
+
+BR="$(git -C "$WT" rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')"
+[ -n "$BR" ] || fail "현재 브랜치 확인 불가"
+
+echo "MAKDOONG2-GATE OK: 3_delivery.pr"