@walwal-harness/cli 1.0.0

package/gotchas/planner.md

@@ -0,0 +1,5 @@
+# Gotchas — Planner
+
+> Dispatcher가 관리. Planner는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@walwal-harness/cli",
+  "version": "1.0.0",
+  "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual) with Gotcha management",
+  "bin": {
+    "walwal-harness": "bin/init.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/init.js --auto",
+    "init": "node bin/init.js",
+    "scan": "bash scripts/scan-project.sh .",
+    "reset": "node bin/init.js --force"
+  },
+  "keywords": [
+    "harness-engineering",
+    "ai-agent",
+    "claude-code",
+    "skill",
+    "planner",
+    "generator",
+    "evaluator",
+    "nestjs",
+    "react",
+    "playwright"
+  ],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "bin/",
+    "skills/",
+    "scripts/",
+    "assets/",
+    "gotchas/"
+  ]
+}

package/scripts/init-agents-md.sh

@@ -0,0 +1,327 @@
+#!/bin/bash
+# init-agents-md.sh — scan-result.json을 기반으로 AGENTS.md를 생성/리빌드
+# 기존 CLAUDE.md의 사용자 규칙을 보존하면서 하네스 포맷으로 변환
+set -e
+
+PROJECT_ROOT="${1:-.}"
+SCAN_RESULT="${PROJECT_ROOT}/.harness/actions/scan-result.json"
+AGENTS_FILE="${PROJECT_ROOT}/AGENTS.md"
+CLAUDE_FILE="${PROJECT_ROOT}/CLAUDE.md"
+BACKUP_DIR="${PROJECT_ROOT}/.harness/archive/pre-harness-backup"
+
+if [ ! -f "$SCAN_RESULT" ]; then
+  echo "ERROR: scan-result.json not found. Run scan-project.sh first."
+  exit 1
+fi
+
+# ─────────────────────────────────────────
+# 1. Python으로 scan-result.json 파싱
+# ─────────────────────────────────────────
+eval "$(python3 << 'PYEOF'
+import json, sys, os
+
+with open(os.environ.get("SCAN_RESULT", ".harness/actions/scan-result.json")) as f:
+    scan = json.load(f)
+
+docs = scan["existing_docs"]
+tech = scan["tech_stack"]
+rec = scan["recommendation"]
+dirs = scan["structure"]["directories"]
+configs = scan["structure"]["config_files"]
+
+print(f'ACTION="{rec["agents_md_action"]}"')
+print(f'PROJECT_TYPE="{rec["project_type"]}"')
+print(f'TECH_BE="{tech["backend"]}"')
+print(f'TECH_FE="{tech["frontend"]}"')
+print(f'TECH_DB="{tech["database"]}"')
+print(f'TECH_MONO="{tech["monorepo"]}"')
+print(f'OPENAPI="{scan["api"]["openapi_spec"]}"')
+print(f'HAS_EXISTING_CLAUDE="{docs["claude_md"]}"')
+print(f'EXISTING_CONTENT={json.dumps(docs["existing_claude_md_content"])}')
+PYEOF
+)"
+
+echo "=== AGENTS.md Initialization ==="
+echo "Action: ${ACTION}"
+echo "Project Type: ${PROJECT_TYPE}"
+echo ""
+
+# ─────────────────────────────────────────
+# 2. 기존 문서 백업
+# ─────────────────────────────────────────
+if [ "$ACTION" = "migrate-claude-to-agents" ] || [ "$ACTION" = "rebuild-with-harness" ]; then
+  mkdir -p "$BACKUP_DIR"
+  TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+
+  if [ -f "$AGENTS_FILE" ] && [ ! -L "$AGENTS_FILE" ]; then
+    cp "$AGENTS_FILE" "${BACKUP_DIR}/AGENTS.md.${TIMESTAMP}.bak"
+    echo "Backed up: AGENTS.md → ${BACKUP_DIR}/AGENTS.md.${TIMESTAMP}.bak"
+  fi
+
+  if [ -f "$CLAUDE_FILE" ] && [ ! -L "$CLAUDE_FILE" ]; then
+    cp "$CLAUDE_FILE" "${BACKUP_DIR}/CLAUDE.md.${TIMESTAMP}.bak"
+    echo "Backed up: CLAUDE.md → ${BACKUP_DIR}/CLAUDE.md.${TIMESTAMP}.bak"
+  fi
+fi
+
+# ─────────────────────────────────────────
+# 3. IA-MAP 자동 생성
+# ─────────────────────────────────────────
+generate_ia_map() {
+  python3 << 'PYEOF'
+import json, os
+
+with open(os.environ.get("SCAN_RESULT", ".harness/actions/scan-result.json")) as f:
+    scan = json.load(f)
+
+dirs = scan["structure"]["directories"]
+tech = scan["tech_stack"]
+
+# 경로별 태그/설명 추론 규칙
+tag_rules = {
+    # Backend patterns
+    "apps/gateway": ("[BE]", "API Gateway", "Generator-Backend"),
+    "apps/service": ("[BE]", "Microservice", "Generator-Backend"),
+    "src/controllers": ("[BE]", "API Controllers", "Generator-Backend"),
+    "src/services": ("[BE]", "Business Logic", "Generator-Backend"),
+    "src/models": ("[BE]", "Data Models", "Generator-Backend"),
+    "src/entities": ("[BE]", "DB Entities", "Generator-Backend"),
+    "src/modules": ("[BE]", "NestJS Modules", "Generator-Backend"),
+    "src/guards": ("[BE]", "Auth Guards", "Generator-Backend"),
+    "src/pipes": ("[BE]", "Validation Pipes", "Generator-Backend"),
+    "src/interceptors": ("[BE]", "Interceptors", "Generator-Backend"),
+    "src/filters": ("[BE]", "Exception Filters", "Generator-Backend"),
+    "routers": ("[BE]", "API Routers", "Generator-Backend"),
+    "routes": ("[BE]", "API Routes", "Generator-Backend"),
+    "middleware": ("[BE]", "Middleware", "Generator-Backend"),
+    "migrations": ("[BE]", "DB Migrations", "Generator-Backend"),
+
+    # Frontend patterns
+    "apps/web": ("[FE]", "Frontend App", "Generator-Frontend"),
+    "src/components": ("[FE]", "UI Components", "Generator-Frontend"),
+    "src/pages": ("[FE]", "Page Routes", "Generator-Frontend"),
+    "src/app": ("[FE]", "App Router", "Generator-Frontend"),
+    "src/hooks": ("[FE]", "Custom Hooks", "Generator-Frontend"),
+    "src/stores": ("[FE]", "State Management", "Generator-Frontend"),
+    "src/styles": ("[FE]", "Stylesheets", "Generator-Frontend"),
+    "src/api": ("[FE]", "API Client Layer", "Generator-Frontend"),
+    "src/lib": ("[FE]", "Utility Library", "Generator-Frontend"),
+    "public": ("[FE]", "Static Assets", "Generator-Frontend"),
+
+    # Shared / Libs
+    "libs/shared": ("[BE]", "Shared Libraries", "Generator-Backend"),
+    "libs/database": ("[BE]", "Database Module", "Generator-Backend"),
+    "libs/common": ("[BE]", "Common Utilities", "Generator-Backend"),
+
+    # Infra
+    "docker": ("[INFRA]", "Docker Configuration", "Planner"),
+    ".github": ("[INFRA]", "CI/CD Workflows", "Planner"),
+    "deploy": ("[INFRA]", "Deployment Scripts", "Planner"),
+    "terraform": ("[INFRA]", "Infrastructure as Code", "Planner"),
+    "k8s": ("[INFRA]", "Kubernetes Manifests", "Planner"),
+
+    # Harness
+    ".harness": ("[HARNESS]", "Harness System", "Planner"),
+
+    # Tests
+    "test": ("[TEST]", "Test Suite", "Evaluator"),
+    "tests": ("[TEST]", "Test Suite", "Evaluator"),
+    "e2e": ("[TEST]", "E2E Tests", "Evaluator"),
+    "__tests__": ("[TEST]", "Unit Tests", "Evaluator"),
+}
+
+# 디렉토리를 분석
+ia_lines = []
+for d in sorted(dirs):
+    if d == "." or not d:
+        continue
+
+    matched = False
+    for pattern, (tag, desc, owner) in tag_rules.items():
+        if pattern in d:
+            depth = d.count("/")
+            indent = "│   " * depth
+            name = d.split("/")[-1] + "/"
+            ia_lines.append(f"{indent}├── {name:<25} # {tag} {desc:<30} → {owner}")
+            matched = True
+            break
+
+    if not matched:
+        depth = d.count("/")
+        if depth <= 1:  # 1depth만 미분류 표시
+            indent = "│   " * depth
+            name = d.split("/")[-1] + "/"
+            ia_lines.append(f"{indent}├── {name:<25} # [?] (Planner가 분류 필요)       → TBD")
+
+for line in ia_lines:
+    print(line)
+PYEOF
+}
+
+IA_MAP=$(generate_ia_map)
+
+# ─────────────────────────────────────────
+# 4. 기존 사용자 규칙 추출 (CLAUDE.md에서)
+# ─────────────────────────────────────────
+extract_user_rules() {
+  if [ "$HAS_EXISTING_CLAUDE" = "exists" ]; then
+    python3 << 'PYEOF'
+import json, os
+
+with open(os.environ.get("SCAN_RESULT", ".harness/actions/scan-result.json")) as f:
+    scan = json.load(f)
+
+content = scan["existing_docs"]["existing_claude_md_content"]
+
+if not content or content.strip() == "":
+    print("(기존 규칙 없음)")
+else:
+    # 사용자 정의 규칙 영역만 추출 (harness 관련 제외)
+    lines = content.split("\n")
+    user_section = []
+    skip = False
+    for line in lines:
+        # harness가 생성한 섹션은 제외
+        if any(kw in line.lower() for kw in ["ia-map", "ia map", "harness", "## tech stack"]):
+            skip = True
+        elif line.startswith("## ") and skip:
+            skip = False
+
+        if not skip:
+            user_section.append(line)
+
+    result = "\n".join(user_section).strip()
+    if result:
+        print(result)
+    else:
+        print("(기존 규칙 없음)")
+PYEOF
+  else
+    echo "(기존 규칙 없음)"
+  fi
+}
+
+USER_RULES=$(extract_user_rules)
+
+# ─────────────────────────────────────────
+# 5. AGENTS.md 생성
+# ─────────────────────────────────────────
+cat > "$AGENTS_FILE" << AGENTSEOF
+# AGENTS.md — Project Context for AI Agents
+
+> 이 파일은 모든 AI 에이전트(Claude, Cursor, Copilot, Windsurf 등)의 공통 진입점입니다.
+> CLAUDE.md는 이 파일의 심볼릭 링크입니다.
+> Generated by walwal-harness ($(date +%Y-%m-%d))
+
+## Project
+
+- **Name**: (Planner가 설정)
+- **Description**: (Planner가 설정)
+- **Phase**: INIT
+- **Type**: ${PROJECT_TYPE}
+- **Harness**: \`.harness/HARNESS.md\` 참조
+
+## Tech Stack (Auto-detected)
+
+- Backend: ${TECH_BE}
+- Frontend: ${TECH_FE}
+- Database: ${TECH_DB}
+- Monorepo: ${TECH_MONO}
+- OpenAPI: ${OPENAPI}
+
+## IA-MAP (Information Architecture)
+
+> 자동 스캔으로 생성됨. Planner가 검토 후 확정해야 합니다.
+> \`[?]\` 태그는 Planner가 분류해야 하는 미확인 경로입니다.
+
+\`\`\`
+/
+${IA_MAP}
+├── AGENTS.md                 # [META] 프로젝트 컨텍스트           → Planner
+├── CLAUDE.md                 # [META] → AGENTS.md 심볼릭 링크
+└── .harness/                 # [HARNESS] 하네스 시스템             → Planner
+\`\`\`
+
+### IA-MAP 범례
+
+| 태그 | 의미 | 소유 에이전트 |
+|------|------|--------------|
+| \`[BE]\` | Backend 영역 | Generator-Backend |
+| \`[FE]\` | Frontend 영역 | Generator-Frontend |
+| \`[HARNESS]\` | 하네스 시스템 | Planner / Evaluator |
+| \`[META]\` | 프로젝트 메타 문서 | Planner |
+| \`[INFRA]\` | 인프라/배포 설정 | Planner |
+| \`[TEST]\` | 테스트 코드 | Evaluator / Generator |
+| \`[?]\` | 미분류 (Planner 확인 필요) | TBD |
+
+## Preserved Rules (기존 프로젝트에서 이관)
+
+${USER_RULES}
+
+## Rules (모든 에이전트 공통)
+
+### 읽기/쓰기 권한
+
+| 파일 | 읽기 | 쓰기 |
+|------|------|------|
+| AGENTS.md | 전체 | Planner만 |
+| .harness/actions/api-contract.json | 전체 | Planner만 |
+| .harness/actions/feature-list.json | 전체 | passes: Generator, 나머지: Planner |
+| .harness/progress.txt | 전체 | 전체 (세션 종료 시 업데이트 의무) |
+| \`[BE]\` 소유 경로 | 전체 | Generator-Backend만 |
+| \`[FE]\` 소유 경로 | 전체 | Generator-Frontend만 |
+| .harness/archive/ | 전체 | 쓰기 금지 (불변) |
+
+### 변경 요청 프로토콜
+
+AGENTS.md 또는 api-contract.json 변경이 필요할 때:
+1. sprint-contract.md에 \`## Change Request\` 섹션 추가
+2. Planner가 다음 스프린트 전환 시 반영 여부 결정
+
+### 금지 사항
+
+- AGENTS.md를 Planner 외 에이전트가 수정
+- 서비스 간 직접 DB 접근
+- 테스트 삭제/약화
+- archive/ 내 파일 수정
+- 프로젝트를 조기 "완료" 선언
+
+## Harness Quick Reference
+
+| 명령 | 설명 |
+|------|------|
+| \`bash scripts/scan-project.sh\` | 프로젝트 구조 재스캔 |
+| \`.harness/progress.txt\` | 현재 진행 상태 |
+| \`.harness/actions/\` | 활성 스프린트 문서 |
+| \`.harness/HARNESS.md\` | 하네스 상세 가이드 |
+AGENTSEOF
+
+echo ""
+echo "=== AGENTS.md Generated ==="
+echo "Path: ${AGENTS_FILE}"
+
+# ─────────────────────────────────────────
+# 6. CLAUDE.md 심볼릭 링크
+# ─────────────────────────────────────────
+if [ -f "$CLAUDE_FILE" ] && [ ! -L "$CLAUDE_FILE" ]; then
+  echo ""
+  echo "WARNING: CLAUDE.md가 일반 파일로 존재합니다."
+  echo "기존 내용은 AGENTS.md의 'Preserved Rules' 섹션에 이관되었습니다."
+  echo "백업: ${BACKUP_DIR}/"
+  rm "$CLAUDE_FILE"
+fi
+
+if [ ! -L "$CLAUDE_FILE" ]; then
+  ln -sf AGENTS.md "$CLAUDE_FILE"
+  echo "Created symlink: CLAUDE.md → AGENTS.md"
+else
+  echo "Symlink already exists: CLAUDE.md → AGENTS.md"
+fi
+
+echo ""
+echo "=== Initialization Complete ==="
+echo ""
+echo "Next steps:"
+echo "  1. AGENTS.md의 [?] 태그를 확인하고 Planner에게 분류를 요청하세요"
+echo "  2. 'Preserved Rules' 섹션에서 불필요한 규칙을 정리하세요"
+echo "  3. '하네스 엔지니어링 시작'으로 Dispatcher를 실행하세요"

package/scripts/scan-project.sh

@@ -0,0 +1,269 @@
+#!/bin/bash
+# scan-project.sh — 기존 프로젝트 구조를 분석하여 하네스 초기화 정보를 생성
+# 출력: .harness/actions/scan-result.json
+set -e
+
+PROJECT_ROOT="${1:-.}"
+OUTPUT="${PROJECT_ROOT}/.harness/actions/scan-result.json"
+
+mkdir -p "$(dirname "$OUTPUT")"
+
+echo "=== Scanning project: ${PROJECT_ROOT} ==="
+
+# ─────────────────────────────────────────
+# 1. 기존 AGENTS.md / CLAUDE.md 감지
+# ─────────────────────────────────────────
+AGENTS_MD="none"
+CLAUDE_MD="none"
+CLAUDE_MD_IS_SYMLINK=false
+EXISTING_RULES=""
+
+if [ -f "${PROJECT_ROOT}/AGENTS.md" ]; then
+  AGENTS_MD="exists"
+fi
+
+if [ -L "${PROJECT_ROOT}/CLAUDE.md" ]; then
+  CLAUDE_MD="symlink"
+  CLAUDE_MD_IS_SYMLINK=true
+elif [ -f "${PROJECT_ROOT}/CLAUDE.md" ]; then
+  CLAUDE_MD="exists"
+  # 기존 CLAUDE.md 내용 보존용 추출
+  EXISTING_RULES=$(cat "${PROJECT_ROOT}/CLAUDE.md")
+fi
+
+# ─────────────────────────────────────────
+# 2. Tech Stack 감지
+# ─────────────────────────────────────────
+TECH_BACKEND="unknown"
+TECH_FRONTEND="unknown"
+TECH_DB="unknown"
+TECH_MONOREPO="none"
+TECH_LANG="unknown"
+
+# Backend
+if [ -f "${PROJECT_ROOT}/nest-cli.json" ]; then
+  TECH_BACKEND="nestjs"
+  TECH_LANG="typescript"
+elif [ -f "${PROJECT_ROOT}/requirements.txt" ] || [ -f "${PROJECT_ROOT}/pyproject.toml" ]; then
+  TECH_BACKEND="python"
+  TECH_LANG="python"
+  if grep -q "fastapi" "${PROJECT_ROOT}/requirements.txt" 2>/dev/null || grep -q "fastapi" "${PROJECT_ROOT}/pyproject.toml" 2>/dev/null; then
+    TECH_BACKEND="fastapi"
+  elif grep -q "django" "${PROJECT_ROOT}/requirements.txt" 2>/dev/null || grep -q "django" "${PROJECT_ROOT}/pyproject.toml" 2>/dev/null; then
+    TECH_BACKEND="django"
+  fi
+elif [ -f "${PROJECT_ROOT}/go.mod" ]; then
+  TECH_BACKEND="go"
+  TECH_LANG="go"
+elif [ -f "${PROJECT_ROOT}/pom.xml" ] || [ -f "${PROJECT_ROOT}/build.gradle" ]; then
+  TECH_BACKEND="java"
+  TECH_LANG="java"
+fi
+
+# Frontend
+if [ -f "${PROJECT_ROOT}/next.config.js" ] || [ -f "${PROJECT_ROOT}/next.config.ts" ] || [ -f "${PROJECT_ROOT}/next.config.mjs" ]; then
+  TECH_FRONTEND="nextjs"
+elif [ -f "${PROJECT_ROOT}/vite.config.ts" ] || [ -f "${PROJECT_ROOT}/vite.config.js" ]; then
+  TECH_FRONTEND="vite-react"
+elif [ -f "${PROJECT_ROOT}/angular.json" ]; then
+  TECH_FRONTEND="angular"
+elif [ -f "${PROJECT_ROOT}/nuxt.config.ts" ]; then
+  TECH_FRONTEND="nuxt"
+fi
+
+# Monorepo 내 Frontend 감지
+if [ -d "${PROJECT_ROOT}/apps/web" ]; then
+  if [ -f "${PROJECT_ROOT}/apps/web/next.config.js" ] || [ -f "${PROJECT_ROOT}/apps/web/next.config.ts" ]; then
+    TECH_FRONTEND="nextjs"
+  elif [ -f "${PROJECT_ROOT}/apps/web/vite.config.ts" ]; then
+    TECH_FRONTEND="vite-react"
+  fi
+fi
+
+# Database
+if grep -rq "typeorm\|prisma\|sequelize\|knex" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+  if grep -q "pg\|postgres" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+    TECH_DB="postgresql"
+  elif grep -q "mysql" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+    TECH_DB="mysql"
+  elif grep -q "sqlite" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+    TECH_DB="sqlite"
+  else
+    TECH_DB="orm-detected"
+  fi
+elif grep -rq "mongoose\|mongodb" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+  TECH_DB="mongodb"
+fi
+
+# Monorepo
+if [ -f "${PROJECT_ROOT}/turbo.json" ]; then
+  TECH_MONOREPO="turborepo"
+elif [ -f "${PROJECT_ROOT}/nx.json" ]; then
+  TECH_MONOREPO="nx"
+elif [ -f "${PROJECT_ROOT}/lerna.json" ]; then
+  TECH_MONOREPO="lerna"
+elif [ -f "${PROJECT_ROOT}/pnpm-workspace.yaml" ]; then
+  TECH_MONOREPO="pnpm-workspace"
+elif [ -f "${PROJECT_ROOT}/nest-cli.json" ] && grep -q '"monorepo": true' "${PROJECT_ROOT}/nest-cli.json" 2>/dev/null; then
+  TECH_MONOREPO="nestjs-monorepo"
+fi
+
+# ─────────────────────────────────────────
+# 3. 디렉토리 트리 스캔 (2 depth)
+# ─────────────────────────────────────────
+TREE=$(find "${PROJECT_ROOT}" -maxdepth 3 -type d \
+  ! -path "*/node_modules/*" \
+  ! -path "*/.git/*" \
+  ! -path "*/.next/*" \
+  ! -path "*/dist/*" \
+  ! -path "*/__pycache__/*" \
+  ! -path "*/.harness/archive/*" \
+  ! -name "node_modules" \
+  ! -name ".git" \
+  ! -name ".next" \
+  ! -name "dist" \
+  2>/dev/null | sort | sed "s|${PROJECT_ROOT}/||g" | sed '/^$/d')
+
+# ─────────────────────────────────────────
+# 4. 주요 설정 파일 목록
+# ─────────────────────────────────────────
+CONFIG_FILES=""
+for f in package.json tsconfig.json nest-cli.json next.config.js next.config.ts \
+         vite.config.ts docker-compose.yml docker-compose.yaml Dockerfile \
+         .env .env.example turbo.json nx.json pyproject.toml requirements.txt \
+         go.mod pom.xml build.gradle Makefile; do
+  if [ -f "${PROJECT_ROOT}/${f}" ]; then
+    CONFIG_FILES="${CONFIG_FILES}\"${f}\","
+  fi
+done
+CONFIG_FILES="[${CONFIG_FILES%,}]"
+
+# ─────────────────────────────────────────
+# 5. OpenAPI / Swagger 감지
+# ─────────────────────────────────────────
+OPENAPI="none"
+for f in openapi.json openapi.yaml swagger.json swagger.yaml api-spec.json api-spec.yaml; do
+  if [ -f "${PROJECT_ROOT}/${f}" ] || [ -f "${PROJECT_ROOT}/docs/${f}" ]; then
+    OPENAPI="${f}"
+    break
+  fi
+done
+
+# NestJS Swagger 모듈 감지
+if grep -rq "@nestjs/swagger" "${PROJECT_ROOT}/package.json" 2>/dev/null; then
+  if [ "$OPENAPI" = "none" ]; then
+    OPENAPI="nestjs-swagger-module (runtime-generated)"
+  fi
+fi
+
+# ─────────────────────────────────────────
+# 6. Git 정보
+# ─────────────────────────────────────────
+GIT_INIT=false
+GIT_COMMITS=0
+GIT_BRANCH="none"
+if [ -d "${PROJECT_ROOT}/.git" ]; then
+  GIT_INIT=true
+  GIT_COMMITS=$(git -C "${PROJECT_ROOT}" rev-list --count HEAD 2>/dev/null || echo 0)
+  GIT_BRANCH=$(git -C "${PROJECT_ROOT}" branch --show-current 2>/dev/null || echo "unknown")
+fi
+
+# ─────────────────────────────────────────
+# 7. 하네스 기존 상태
+# ─────────────────────────────────────────
+HARNESS_EXISTS=false
+HARNESS_VERSION="none"
+if [ -f "${PROJECT_ROOT}/.harness/config.json" ]; then
+  HARNESS_EXISTS=true
+  HARNESS_VERSION=$(grep '"version"' "${PROJECT_ROOT}/.harness/config.json" 2>/dev/null | head -1 | sed 's/.*: *"\(.*\)".*/\1/')
+fi
+
+# ─────────────────────────────────────────
+# 8. JSON 출력
+# ─────────────────────────────────────────
+
+# 디렉토리 트리를 JSON 배열로 변환
+TREE_JSON=$(echo "$TREE" | awk 'BEGIN{printf "["} NR>1{printf ","} {printf "\"%s\"", $0} END{printf "]"}')
+
+# 기존 CLAUDE.md 내용 (JSON escape)
+EXISTING_RULES_JSON=$(echo "$EXISTING_RULES" | python3 -c "import sys,json; print(json.dumps(sys.stdin.read()))" 2>/dev/null || echo '""')
+
+cat > "$OUTPUT" << JSONEOF
+{
+  "scanned_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+  "project_root": "${PROJECT_ROOT}",
+
+  "existing_docs": {
+    "agents_md": "${AGENTS_MD}",
+    "claude_md": "${CLAUDE_MD}",
+    "claude_md_is_symlink": ${CLAUDE_MD_IS_SYMLINK},
+    "existing_claude_md_content": ${EXISTING_RULES_JSON}
+  },
+
+  "tech_stack": {
+    "backend": "${TECH_BACKEND}",
+    "frontend": "${TECH_FRONTEND}",
+    "database": "${TECH_DB}",
+    "monorepo": "${TECH_MONOREPO}",
+    "language": "${TECH_LANG}"
+  },
+
+  "structure": {
+    "directories": ${TREE_JSON},
+    "config_files": ${CONFIG_FILES}
+  },
+
+  "api": {
+    "openapi_spec": "${OPENAPI}"
+  },
+
+  "git": {
+    "initialized": ${GIT_INIT},
+    "commits": ${GIT_COMMITS},
+    "branch": "${GIT_BRANCH}"
+  },
+
+  "harness": {
+    "exists": ${HARNESS_EXISTS},
+    "version": "${HARNESS_VERSION}"
+  },
+
+  "recommendation": {
+    "project_type": "$(
+      if [ "$TECH_BACKEND" != "unknown" ] && [ "$TECH_FRONTEND" != "unknown" ]; then
+        echo "fullstack"
+      elif [ "$TECH_BACKEND" != "unknown" ]; then
+        echo "backend-only"
+      elif [ "$TECH_FRONTEND" != "unknown" ]; then
+        echo "frontend-only"
+      else
+        echo "empty"
+      fi
+    )",
+    "agents_md_action": "$(
+      if [ "$AGENTS_MD" = "none" ] && [ "$CLAUDE_MD" = "none" ]; then
+        echo "create-new"
+      elif [ "$AGENTS_MD" = "none" ] && [ "$CLAUDE_MD" = "exists" ]; then
+        echo "migrate-claude-to-agents"
+      elif [ "$AGENTS_MD" = "exists" ]; then
+        echo "rebuild-with-harness"
+      else
+        echo "create-new"
+      fi
+    )"
+  }
+}
+JSONEOF
+
+echo ""
+echo "=== Scan Complete ==="
+echo "Output: ${OUTPUT}"
+echo ""
+echo "--- Summary ---"
+echo "Tech Stack: ${TECH_BACKEND} / ${TECH_FRONTEND} / ${TECH_DB}"
+echo "Monorepo: ${TECH_MONOREPO}"
+echo "OpenAPI: ${OPENAPI}"
+echo "Git: ${GIT_INIT} (${GIT_COMMITS} commits, branch: ${GIT_BRANCH})"
+echo "Existing Docs: AGENTS.md=${AGENTS_MD}, CLAUDE.md=${CLAUDE_MD}"
+echo "Harness: ${HARNESS_EXISTS} (v${HARNESS_VERSION})"
+echo "Recommendation: $(cat "$OUTPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(f\"type={d['recommendation']['project_type']}, agents_md={d['recommendation']['agents_md_action']}\")" 2>/dev/null)"