handoff-verify

/handoff-verify — Workflow Parallel Fan-out (8 reviewers + adversarial verify)

트리거 주체 (§12, 2026-06-12): 본 스킬은 이미 Skill이다 — §12 "스킬화"는 완료 상태다. 미해결이었던 것은 트리거 주체다. 비단순 코드 변경 완료 후 에이전트가 자율 호출한다(사람이 매번 /handoff-verify를 입력하는 것은 폴백). 근거: verification.md "자율 검증 §11".

Workflow tool 기반 pre-merge 검증 게이트. v7의 "단일 메시지 8× Task() 수동 fan-out"을 Workflow tool parallel()로 전환 — 결정론적 동시 spawn(사일런트 spawn 실패 0) + schema 강제 구조화 회수 + CRITICAL/HIGH 적대적 재검증(false positive 제거).

워크플로우 SSOT: ~/.claude/skills/handoff-verify/handoff-verify.workflow.js reviewer 상세 체크리스트: ~/.claude/skills/handoff-verify/reviewer-prompts.md

v7 → v8 변경 (왜 Workflow인가)

1단계: 환경 수집 + args 생성 (bash)

# 변경 없으면 abort
if [ -z "$(git status --short)" ]; then
    echo "변경사항 없음. git status 빈 결과. /handoff-verify 종료."
    exit 0
fi

# CLI 가용성 안내 (미설치 reviewer는 워크플로우가 자동 skip)
CODEX_OK=$(command -v codex >/dev/null 2>&1 && echo true || echo false)
GEMINI_OK=$(command -v gemini >/dev/null 2>&1 && echo true || echo false)
if [ "$CODEX_OK" = "false" ] || [ "$GEMINI_OK" = "false" ]; then
    echo "⚠️  크로스모델 가용성 — codex:$CODEX_OK gemini:$GEMINI_OK"
    echo "   미설치 reviewer는 자동 skip + 푸터 명시. 설치: Read ~/.claude/skills/handoff-verify/cli-setup.md"
fi

# args JSON 생성 (python3로 안전 인코딩 — diff 8KB·따옴표·줄바꿈 이스케이프)
python3 - "$ARGUMENTS" << 'PYEOF'
import json, os, subprocess, sys

def sh(cmd):
    try:
        return subprocess.run(cmd, shell=True, capture_output=True, text=True).stdout
    except Exception:
        return ""

def has(cmd):
    return subprocess.run(f"command -v {cmd}", shell=True,
                          capture_output=True).returncode == 0

def read(path, fallback="(없음)"):
    try:
        with open(path) as f:
            return f.read().strip() or fallback
    except Exception:
        return fallback

intent = sys.argv[1] if len(sys.argv) > 1 and sys.argv[1].strip() else "(없음)"
dod = sh("grep -E '^- \\[ \\] DoD-' .claude/sprint-contract.md 2>/dev/null").strip() or "(없음)"

payload = {
    "intent": intent,
    "changed_files": sh("git diff --name-only HEAD").strip() or "(없음)",
    "diff": sh("git diff HEAD")[:8000] or "(없음)",
    "handoff": read(".claude/handoff.md"),
    "dod": dod,
    "has_codex": has("codex"),
    "has_gemini": has("gemini"),
}
print(json.dumps(payload, ensure_ascii=False))
PYEOF

# 워크플로우 본체 경로 탐지 (.claude 우선 → dotclaude fallback. 멀티PC 견고 — 동기화 가정 제거)
WF_PATH=$(ls ~/.claude/skills/handoff-verify/handoff-verify.workflow.js 2>/dev/null \
  || ls ~/qjc-office/dotclaude/skills/handoff-verify/handoff-verify.workflow.js 2>/dev/null)
if [ -z "$WF_PATH" ] || [ ! -f "$WF_PATH" ]; then
  echo "❌ handoff-verify.workflow.js 미발견 — 동기화 필요 (/dc pull 또는 /company-sync)"; exit 1
fi
echo "WF_PATH=$WF_PATH"