@walwal-harness/cli 1.2.0 → 2.0.0

package/README.md

@@ -135,7 +135,7 @@ your-project/
 ├── CLAUDE.md → AGENTS.md           # 심볼릭 링크
 ├── .harness/
 │   ├── config.json                 # 하네스 설정
-│   ├── progress.txt                # 세션 간 상태 전달
+│   ├── progress.json               # 세션 간 상태 (기계 판독)
 │   ├── gotchas/                    # 에이전트별 실수 기록
 │   │   ├── planner.md
 │   │   ├── generator-backend.md
@@ -170,6 +170,17 @@ your-project/
 | Unit Testing | Jest (BE) + Vitest (FE) |
 | Database | PostgreSQL / SQLite |
 
+## 권장 외부 스킬
+
+하네스는 자체 reference 파일로 기본 가이드를 제공하지만, 아래 외부 스킬을 설치하면 품질이 향상됩니다. 초기화 시 자동으로 설치 여부를 체크하고 안내합니다.
+
+| 스킬 | 설명 | 사용 에이전트 |
+|------|------|-------------|
+| **vercel** | Vercel/Next.js 배포, 성능 최적화, AI SDK | Generator-FE |
+| **web-design-guidelines** | UI/UX 접근성, Web Interface Guidelines | Evaluator-Visual, Generator-FE |
+| **taste-skill** | AI 생성 UI 디자인 품질, AI슬롭 감지 | Evaluator-Visual, Generator-FE |
+| **supanova-design-skill** | 디자인 시스템 규칙, 시각적 일관성 | Evaluator-Visual, Generator-FE |
+
 ## Playwright MCP 설정
 
 Evaluator가 브라우저 테스트를 수행하려면 Playwright MCP가 필요합니다. `~/.mcp.json`에 추가:

package/assets/templates/AGENTS.md.template

@@ -38,7 +38,7 @@
 | AGENTS.md | 전체 | Planner만 |
 | .harness/actions/api-contract.json | 전체 | Planner만 |
 | .harness/actions/feature-list.json | 전체 | passes: Generator, 나머지: Planner |
-| .harness/progress.txt | 전체 | 전체 (세션 종료 시 업데이트 의무) |
+| .harness/progress.json | 전체 | 전체 (Session Boundary Protocol에 따라 업데이트) |
 | `[BE]` 소유 경로 | 전체 | Generator-Backend만 |
 | `[FE]` 소유 경로 | 전체 | Generator-Frontend만 |
 | .harness/archive/ | 전체 | 쓰기 금지 (불변) |

package/assets/templates/HARNESS.md

@@ -10,14 +10,9 @@
 .harness/
 ├── HARNESS.md                  # 이 파일
 ├── config.json                 # 하네스 설정
-├── progress.txt                # 세션 간 상태 전달 로그
-├── prompts/                    # 에이전트 프롬프트 (6개)
-│   ├── dispatcher.md           # Dispatcher — 파이프라인 선택
-│   ├── planner.md              # Planner — 제품 사양 + MSA 설계
-│   ├── generator-backend.md    # Generator-BE — NestJS MSA 구현
-│   ├── generator-frontend.md   # Generator-FE — React/Next.js 구현
-│   ├── evaluator-functional.md # Evaluator-기능 — Playwright E2E
-│   └── evaluator-visual.md     # Evaluator-비주얼 — 디자인/접근성
+├── progress.json               # 기계 판독 상태 (세션 오케스트레이션)
+├── progress.log                # 사람 판독 히스토리 (append-only)
+├── next-prompt.txt             # 다음 세션용 프롬프트 (claude CLI 파이프용)
 ├── actions/                    # 현재 활성 문서
 │   ├── pipeline.json           # Dispatcher 결정 (어떤 파이프라인인지)
 │   ├── plan.md                 # 제품 사양
@@ -79,55 +74,60 @@ Eval-Visual FAIL → Gen-FE 재작업 (max 10회)
 10회 초과 → 사용자 개입 요청
 ```
 
-## 수동 프롬프트 실행 방법
+## 세션 오케스트레이션
 
-### Step 0: Dispatcher (항상 최초 실행)
-```
-".harness/prompts/dispatcher.md를 읽고 Dispatcher로 동작하세요.
-[사용자의 자유 형식 요청]"
-```
+### 핵심: 한 세션에 1 에이전트 단계
 
-### Step 1: Planner
-```
-".harness/prompts/planner.md를 읽고 Planner 에이전트로 동작하세요.
-pipeline.json을 참조하여 [light/full] 모드로 실행합니다."
-```
+각 에이전트는 독립 Claude Code 세션에서 실행됩니다. 컨텍스트 소진을 방지하고 품질을 유지합니다.
 
-### Step 2: Generator-Backend (FULLSTACK, BE-ONLY)
-```
-".harness/prompts/generator-backend.md를 읽고 Generator-Backend으로 동작하세요.
-Sprint [N]을 시작합니다."
-```
+### 상태 관리
 
-### Step 3: Generator-Frontend (FULLSTACK, FE-ONLY)
-```
-".harness/prompts/generator-frontend.md를 읽고 Generator-Frontend으로 동작하세요.
-Sprint [N]의 프론트엔드를 구현합니다."
-```
+| 파일 | 역할 |
+|------|------|
+| `.harness/progress.json` | 기계 판독 상태 (현재 에이전트, 파이프라인, 실패 정보) |
+| `.harness/progress.log` | 사람 판독 히스토리 (append-only) |
+| `.harness/next-prompt.txt` | 다음 세션용 프롬프트 (claude CLI 파이프용) |
 
-### Step 4: Evaluator-Functional
-```
-".harness/prompts/evaluator-functional.md를 읽고 Evaluator-Functional로 동작하세요.
-Sprint [N]을 평가합니다. Playwright MCP를 사용하세요."
-```
+### 실행 방법
 
-### Step 5: Evaluator-Visual
+#### 1. 첫 세션: Dispatcher
 ```
-".harness/prompts/evaluator-visual.md를 읽고 Evaluator-Visual로 동작하세요.
-Sprint [N]의 비주얼을 평가합니다."
+"하네스 엔지니어링 시작" 또는 /harness-dispatcher
 ```
 
-### Archive (Eval-Visual PASS 후)
+#### 2. 이후 세션: harness-next.sh로 안내받기
+```bash
+bash scripts/harness-next.sh
 ```
-"Sprint [N] 문서를 아카이브 하세요.
-.harness/actions/의 스프린트 문서를 .harness/archive/sprint-NNN/으로 이동합니다."
+Feature-level 프로그래스를 출력하고 다음 에이전트를 안내합니다.
+
+#### 3. 다음 세션 시작
+```bash
+# 방법 A: 새 세션에서 스킬 직접 호출
+/harness-generator-backend
+
+# 방법 B: claude CLI 자동 실행
+claude --prompt "$(cat .harness/next-prompt.txt)"
 ```
 
+#### 4. SessionStart 훅 (자동)
+세션 시작 시 `.claude/settings.json` 훅이 자동으로 현재 프로그래스를 출력합니다.
+
+### Session Boundary Protocol
+
+모든 에이전트 스킬에 내장된 프로토콜:
+
+- **On Start**: `progress.json` 읽기 → `agent_status: "running"` 설정
+- **On Complete**: `progress.json` 업데이트 → `next_agent` 계산 → **STOP**
+- **On Fail** (Evaluator): `failure` 정보 기록 → `retry_target` 설정 → **STOP**
+
+에이전트는 절대 다음 에이전트를 직접 호출하지 않습니다.
+
 ## 핵심 원칙
 
 1. **Backend First** — API가 안정된 후 Frontend 연동 (없는 API 호출 방지)
 2. **api-contract.json이 진실의 원천** — FE↔Gateway↔Services 간 유일한 계약
-3. **한 세션에 1 스프린트** — 컨텍스트 소진 방지
+3. **한 세션에 1 에이전트 단계** — 컨텍스트 소진 방지, Session Boundary Protocol 준수
 4. **feature-list.json의 passes만 수정** — 기능 정의는 Planner만 변경
 5. **테스트 삭제/약화 금지** — 테스트는 계약이다
 6. **Evaluator는 회의적** — 자기 설득 금지, 기준 미달 = FAIL

package/assets/templates/config.json

@@ -8,54 +8,46 @@
   "agents": {
     "dispatcher": {
       "role": "사용자 요청 분석 → 파이프라인 결정 (FE-ONLY / BE-ONLY / FULLSTACK)",
-      "prompt_file": "prompts/dispatcher.md",
+      "skill": "harness-dispatcher",
       "outputs": ["actions/pipeline.json"],
-      "triggers_next": "planner",
       "always_first": true
     },
     "planner": {
       "role": "제품 사양 + API 계약서 + 서비스 분할 설계",
-      "prompt_file": "prompts/planner.md",
+      "skill": "harness-planner",
       "outputs": [
         "actions/plan.md",
         "actions/feature-list.json",
         "actions/api-contract.json"
-      ],
-      "triggers_next": ["generator-backend", "generator-frontend"]
+      ]
     },
     "generator-backend": {
       "role": "NestJS MSA 서비스 구현, API 엔드포인트, DB 스키마",
-      "prompt_file": "prompts/generator-backend.md",
+      "skill": "harness-generator-backend",
       "inputs": ["actions/plan.md", "actions/feature-list.json", "actions/api-contract.json", "actions/sprint-contract.md"],
       "outputs": ["code:backend", "actions/sprint-contract.md"],
-      "triggers_next": "generator-frontend",
       "order": 1
     },
     "generator-frontend": {
       "role": "React/Next.js UI 컴포넌트, 상태관리, API 연동",
-      "prompt_file": "prompts/generator-frontend.md",
+      "skill": "harness-generator-frontend",
       "inputs": ["actions/plan.md", "actions/feature-list.json", "actions/api-contract.json", "actions/sprint-contract.md"],
       "outputs": ["code:frontend", "actions/sprint-contract.md"],
-      "triggers_next": "evaluator-functional",
       "order": 2
     },
     "evaluator-functional": {
       "role": "Playwright로 E2E 기능 검증, API 응답/DB 상태 확인",
-      "prompt_file": "prompts/evaluator-functional.md",
+      "skill": "harness-evaluator-functional",
       "tools": ["playwright:browser_*"],
       "inputs": ["actions/sprint-contract.md"],
-      "outputs": ["actions/evaluation-functional.md"],
-      "on_fail": "generator-backend OR generator-frontend (결함 위치에 따라)",
-      "on_pass": "evaluator-visual"
+      "outputs": ["actions/evaluation-functional.md"]
     },
     "evaluator-visual": {
       "role": "디자인 일관성, 반응형, 접근성, AI슬롭 감지",
-      "prompt_file": "prompts/evaluator-visual.md",
+      "skill": "harness-evaluator-visual",
       "tools": ["playwright:browser_take_screenshot", "playwright:browser_resize", "playwright:browser_snapshot"],
       "inputs": ["actions/sprint-contract.md", "actions/evaluation-functional.md"],
-      "outputs": ["actions/evaluation-visual.md"],
-      "on_fail": "generator-frontend",
-      "on_pass": "archive_and_next_sprint"
+      "outputs": ["actions/evaluation-visual.md"]
     }
   },
   "flow": {
@@ -77,12 +69,45 @@
     "max_retries_per_sprint": 10,
     "archive_on_sprint_complete": true
   },
+  "session": {
+    "isolation": true,
+    "state_file": ".harness/progress.json",
+    "state_log": ".harness/progress.log",
+    "next_prompt_file": ".harness/next-prompt.txt"
+  },
   "paths": {
     "actions": ".harness/actions",
     "archive": ".harness/archive",
-    "prompts": ".harness/prompts",
     "gotchas": ".harness/gotchas",
-    "progress": ".harness/progress.txt"
+    "progress_state": ".harness/progress.json",
+    "progress_log": ".harness/progress.log"
+  },
+  "recommended_skills": {
+    "comment": "Claude Code에 설치하면 하네스 품질이 향상되는 외부 스킬 목록",
+    "vercel": {
+      "description": "Vercel/Next.js 배포, 성능 최적화, AI SDK 가이드",
+      "used_by": ["generator-frontend"],
+      "install": "claude skill install vercel",
+      "check_path": ".claude/skills/vercel"
+    },
+    "web-design-guidelines": {
+      "description": "UI/UX 접근성, 디자인 리뷰, Web Interface Guidelines",
+      "used_by": ["evaluator-visual", "generator-frontend"],
+      "install": "claude skill install web-design-guidelines",
+      "check_path": ".claude/skills/web-design-guidelines"
+    },
+    "taste-skill": {
+      "description": "AI 생성 UI의 디자인 품질 검증, AI슬롭 패턴 감지",
+      "used_by": ["evaluator-visual", "generator-frontend"],
+      "install": "npx claude-skill install leonxlnx/taste-skill",
+      "check_path": ".claude/skills/taste-skill"
+    },
+    "supanova-design-skill": {
+      "description": "디자인 시스템 규칙, 컴포넌트 패턴, 시각적 일관성",
+      "used_by": ["evaluator-visual", "generator-frontend"],
+      "install": "npx claude-skill install uxjoseph/supanova-design-skill",
+      "check_path": ".claude/skills/supanova-design-skill"
+    }
   },
   "tech_stack": {
     "backend": {

package/assets/templates/progress.json.template

@@ -0,0 +1,22 @@
+{
+  "version": 1,
+  "project_name": "",
+  "pipeline": null,
+  "sprint": {
+    "number": 0,
+    "status": "init",
+    "retry_count": 0
+  },
+  "current_agent": null,
+  "agent_status": "pending",
+  "completed_agents": [],
+  "next_agent": "dispatcher",
+  "failure": {
+    "agent": null,
+    "location": null,
+    "message": null,
+    "retry_target": null
+  },
+  "updated_at": "{{DATE}}",
+  "history": []
+}

package/bin/init.js

@@ -112,7 +112,7 @@ function scaffoldHarness() {
 
   // Copy templates as initial files
   const templateMap = {
-    'progress.txt.template': path.join(HARNESS_DIR, 'progress.txt'),
+    'progress.json.template': path.join(HARNESS_DIR, 'progress.json'),
   };
 
   const templatesDir = path.join(PKG_ROOT, 'assets', 'templates');
@@ -141,6 +141,19 @@ function scaffoldHarness() {
     copyFile(harnessMdSrc, harnessMdDest);
   }
 
+  // Create progress.log
+  const progressLog = path.join(HARNESS_DIR, 'progress.log');
+  if (!fileExists(progressLog) || isForce) {
+    const date = new Date().toISOString().split('T')[0];
+    fs.writeFileSync(progressLog, `# Harness Progress Log\n# ${date} — Initialized\n`);
+  }
+
+  // Create next-prompt.txt placeholder
+  const nextPrompt = path.join(HARNESS_DIR, 'next-prompt.txt');
+  if (!fileExists(nextPrompt) || isForce) {
+    fs.writeFileSync(nextPrompt, '');
+  }
+
   log('.harness/ scaffolding complete');
 }
 
@@ -186,12 +199,29 @@ function installScripts() {
 
   if (fs.existsSync(scriptsSrc)) {
     ensureDir(scriptsDest);
-    const files = fs.readdirSync(scriptsSrc);
-    for (const file of files) {
-      const dest = path.join(scriptsDest, file);
-      if (!fileExists(dest) || isForce) {
-        copyFile(path.join(scriptsSrc, file), dest);
-        try { fs.chmodSync(dest, '755'); } catch (e) {}
+    const entries = fs.readdirSync(scriptsSrc, { withFileTypes: true });
+    for (const entry of entries) {
+      const srcPath = path.join(scriptsSrc, entry.name);
+      const destPath = path.join(scriptsDest, entry.name);
+      if (entry.isDirectory()) {
+        // Copy subdirectories (e.g., lib/)
+        if (!fileExists(destPath) || isForce) {
+          copyDir(srcPath, destPath);
+          // Make scripts in subdirs executable
+          try {
+            const subFiles = fs.readdirSync(destPath);
+            for (const f of subFiles) {
+              if (f.endsWith('.sh')) {
+                fs.chmodSync(path.join(destPath, f), '755');
+              }
+            }
+          } catch (e) {}
+        }
+      } else {
+        if (!fileExists(destPath) || isForce) {
+          copyFile(srcPath, destPath);
+          try { fs.chmodSync(destPath, '755'); } catch (e) {}
+        }
       }
     }
   }
@@ -199,6 +229,48 @@ function installScripts() {
   log('Scripts installation complete');
 }
 
+// ─────────────────────────────────────────
+// 3b. SessionStart hook
+// ─────────────────────────────────────────
+function installSessionHook() {
+  log('Installing SessionStart hook...');
+
+  const settingsDir = path.join(PROJECT_ROOT, '.claude');
+  const settingsFile = path.join(settingsDir, 'settings.json');
+
+  ensureDir(settingsDir);
+
+  let settings = {};
+  if (fileExists(settingsFile)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+    } catch (e) {
+      log('WARNING: Could not parse existing .claude/settings.json, creating new');
+    }
+  }
+
+  // Ensure hooks.SessionStart array exists
+  if (!settings.hooks) settings.hooks = {};
+  if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
+
+  // Check if our hook is already installed
+  const hookCmd = 'bash scripts/harness-session-start.sh';
+  const alreadyInstalled = settings.hooks.SessionStart.some(
+    h => h.command && h.command.includes('harness-session-start')
+  );
+
+  if (!alreadyInstalled) {
+    settings.hooks.SessionStart.push({
+      type: 'command',
+      command: hookCmd
+    });
+    fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+    log('SessionStart hook installed in .claude/settings.json');
+  } else {
+    log('SessionStart hook already installed');
+  }
+}
+
 // ─────────────────────────────────────────
 // 4. AGENTS.md + CLAUDE.md
 // ─────────────────────────────────────────
@@ -283,6 +355,60 @@ function checkPlaywrightMcp() {
   log('');
 }
 
+// ─────────────────────────────────────────
+// 6. Recommended skills check
+// ─────────────────────────────────────────
+function checkRecommendedSkills() {
+  const configPath = path.join(HARNESS_DIR, 'config.json');
+  if (!fileExists(configPath)) return;
+
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  } catch (e) { return; }
+
+  const skills = config.recommended_skills;
+  if (!skills) return;
+
+  const missing = [];
+  const found = [];
+
+  for (const [name, info] of Object.entries(skills)) {
+    if (name === 'comment') continue;
+    const checkPath = path.join(PROJECT_ROOT, info.check_path);
+    if (fileExists(checkPath)) {
+      found.push(name);
+    } else {
+      missing.push({ name, ...info });
+    }
+  }
+
+  if (found.length > 0) {
+    log(`Recommended skills installed: ${found.join(', ')}`);
+  }
+
+  if (missing.length > 0) {
+    console.log('');
+    log('╔═══════════════════════════════════════════════════════════╗');
+    log('║  Recommended skills (not installed)                      ║');
+    log('╠═══════════════════════════════════════════════════════════╣');
+    for (const skill of missing) {
+      const agents = skill.used_by.join(', ');
+      log(`║  ${skill.name}`);
+      log(`║    ${skill.description}`);
+      log(`║    Used by: ${agents}`);
+      log(`║    Install: ${skill.install}`);
+      log('║');
+    }
+    log('║  These skills are optional but improve output quality.   ║');
+    log('║  Harness reference files provide baseline guidance       ║');
+    log('║  even without these skills installed.                    ║');
+    log('╚═══════════════════════════════════════════════════════════╝');
+  } else if (found.length > 0) {
+    log('All recommended skills are installed!');
+  }
+}
+
 // ─────────────────────────────────────────
 // Help
 // ─────────────────────────────────────────
@@ -305,6 +431,7 @@ What it does:
   3. Copies helper scripts to scripts/
   4. Creates AGENTS.md + CLAUDE.md symlink
   5. Checks Playwright MCP configuration
+  6. Checks recommended external skills (Vercel, design skills)
 
 After init:
   1. Restart Claude Code session (exit and re-enter) for skills to load
@@ -335,8 +462,10 @@ function main() {
   scaffoldHarness();
   installSkills();
   installScripts();
+  installSessionHook();
   setupAgentsMd();
   checkPlaywrightMcp();
+  checkRecommendedSkills();
 
   console.log('');
   log('═══ Initialization Complete ═══');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "1.2.0",
+  "version": "2.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"

package/scripts/harness-next.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+# harness-next.sh — 세션 오케스트레이터
+# 현재 progress.json 상태를 읽고 다음 에이전트를 결정한다.
+# Feature-level 프로그래스를 출력하고 next-prompt.txt를 생성한다.
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+# ─────────────────────────────────────────
+# Resolve project root
+# ─────────────────────────────────────────
+PROJECT_ROOT="$(resolve_harness_root "${1:-.}")" || {
+  echo "[harness] ERROR: .harness/ directory not found" >&2
+  echo "  Run 'npx walwal-harness' to initialize." >&2
+  exit 1
+}
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+CONFIG="$PROJECT_ROOT/.harness/config.json"
+NEXT_PROMPT="$PROJECT_ROOT/.harness/next-prompt.txt"
+
+check_jq || exit 1
+
+if [ ! -f "$PROGRESS" ]; then
+  echo "[harness] ERROR: progress.json not found" >&2
+  echo "  Run 'npx walwal-harness --force' to reinitialize." >&2
+  exit 1
+fi
+
+# ─────────────────────────────────────────
+# Read current state
+# ─────────────────────────────────────────
+pipeline=$(jq -r '.pipeline // "null"' "$PROGRESS")
+sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
+sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS")
+current_agent=$(jq -r '.current_agent // "null"' "$PROGRESS")
+agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS")
+next_agent=$(jq -r '.next_agent // "null"' "$PROGRESS")
+retry_count=$(jq -r '.sprint.retry_count // 0' "$PROGRESS")
+max_retries=$(jq -r '.flow.max_retries_per_sprint // 10' "$CONFIG" 2>/dev/null || echo 10)
+
+# ─────────────────────────────────────────
+# Determine next agent
+# ─────────────────────────────────────────
+compute_next_agent() {
+  local current="$1"
+  local status="$2"
+
+  # If blocked, no next
+  if [ "$status" = "blocked" ]; then
+    echo "null"
+    return
+  fi
+
+  # If failure with retry target, use that
+  local retry_target
+  retry_target=$(jq -r '.failure.retry_target // "null"' "$PROGRESS")
+  if [ "$retry_target" != "null" ] && [ "$status" = "failed" ]; then
+    echo "$retry_target"
+    return
+  fi
+
+  # If next_agent is already set in progress.json, use it
+  if [ "$next_agent" != "null" ]; then
+    echo "$next_agent"
+    return
+  fi
+
+  # Compute from pipeline sequence
+  if [ "$pipeline" = "null" ] || [ ! -f "$CONFIG" ]; then
+    echo "dispatcher"
+    return
+  fi
+
+  local -a agents
+  mapfile -t agents < <(jq -r ".flow.pipeline_selection.pipelines[\"${pipeline}\"][]" "$CONFIG" 2>/dev/null | sed 's/:.*//')
+
+  local found=false
+  for agent in "${agents[@]}"; do
+    if [ "$found" = true ]; then
+      echo "$agent"
+      return
+    fi
+    if [ "$agent" = "$current" ]; then
+      found=true
+    fi
+  done
+
+  # Current is last agent → sprint complete
+  echo "archive"
+}
+
+# If current agent completed, compute next
+if [ "$agent_status" = "completed" ] && [ "$next_agent" = "null" ]; then
+  next_agent=$(compute_next_agent "$current_agent" "$agent_status")
+fi
+
+# ─────────────────────────────────────────
+# Render progress
+# ─────────────────────────────────────────
+render_progress "$PROJECT_ROOT"
+render_agent_bar "$PROJECT_ROOT"
+echo ""
+
+# ─────────────────────────────────────────
+# Generate next-prompt.txt
+# ─────────────────────────────────────────
+if [ "$next_agent" != "null" ] && [ "$next_agent" != "archive" ] && [ "$agent_status" != "blocked" ]; then
+  # Build prompt
+  prompt="/harness-${next_agent} 를 실행하세요."
+
+  if [ "$sprint_num" -gt 0 ]; then
+    prompt+=$'\n'"Sprint ${sprint_num}"
+    if [ "$sprint_status" = "failed" ]; then
+      prompt+=" (retry ${retry_count}/${max_retries})"
+    fi
+    prompt+="을 진행합니다."
+  fi
+
+  prompt+=$'\n'".harness/progress.json을 읽고 현재 상태를 확인하세요."
+
+  # Add failure context if retrying
+  failure_msg=$(jq -r '.failure.message // empty' "$PROGRESS")
+  if [ -n "$failure_msg" ] && [ "$failure_msg" != "null" ]; then
+    prompt+=$'\n\n'"이전 실패 사유: ${failure_msg}"
+  fi
+
+  echo "$prompt" > "$NEXT_PROMPT"
+
+elif [ "$next_agent" = "archive" ]; then
+  cat > "$NEXT_PROMPT" <<'PROMPT'
+Sprint 문서를 아카이브 하세요.
+.harness/actions/의 스프린트 문서를 .harness/archive/sprint-NNN/으로 이동합니다.
+.harness/progress.json을 읽고 sprint 번호를 확인하세요.
+PROMPT
+
+else
+  echo "" > "$NEXT_PROMPT"
+fi

package/scripts/harness-session-start.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# harness-session-start.sh — SessionStart 훅
+# Claude Code 세션 시작 시 자동 실행되어 현재 하네스 상태를 출력한다.
+# .claude/settings.json의 SessionStart 훅으로 등록된다.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB="$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+# lib이 없으면 silent exit (훅이므로 에러 출력하지 않음)
+if [ ! -f "$LIB" ]; then exit 0; fi
+source "$LIB"
+
+# jq 없으면 silent exit
+command -v jq &>/dev/null || exit 0
+
+# .harness/ 찾기
+PROJECT_ROOT="$(resolve_harness_root "." 2>/dev/null)" || exit 0
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+[ -f "$PROGRESS" ] || exit 0
+
+# init 상태면 간단 안내만
+sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS" 2>/dev/null)
+if [ "$sprint_status" = "init" ]; then
+  echo "# Harness ready — say \"하네스 엔지니어링 시작\" or /harness-dispatcher"
+  exit 0
+fi
+
+# Feature-level 프로그래스 출력
+render_progress "$PROJECT_ROOT"
+render_agent_bar "$PROJECT_ROOT"

package/scripts/init-agents-md.sh

@@ -267,7 +267,7 @@ ${USER_RULES}
 | AGENTS.md | 전체 | Planner만 |
 | .harness/actions/api-contract.json | 전체 | Planner만 |
 | .harness/actions/feature-list.json | 전체 | passes: Generator, 나머지: Planner |
-| .harness/progress.txt | 전체 | 전체 (세션 종료 시 업데이트 의무) |
+| .harness/progress.json | 전체 | 전체 (Session Boundary Protocol에 따라 업데이트) |
 | \`[BE]\` 소유 경로 | 전체 | Generator-Backend만 |
 | \`[FE]\` 소유 경로 | 전체 | Generator-Frontend만 |
 | .harness/archive/ | 전체 | 쓰기 금지 (불변) |
@@ -291,7 +291,7 @@ AGENTS.md 또는 api-contract.json 변경이 필요할 때:
 | 명령 | 설명 |
 |------|------|
 | \`bash scripts/scan-project.sh\` | 프로젝트 구조 재스캔 |
-| \`.harness/progress.txt\` | 현재 진행 상태 |
+| \`.harness/progress.json\` | 현재 진행 상태 (기계 판독) |
 | \`.harness/actions/\` | 활성 스프린트 문서 |
 | \`.harness/HARNESS.md\` | 하네스 상세 가이드 |
 AGENTSEOF

package/scripts/lib/harness-render-progress.sh

@@ -0,0 +1,318 @@
+#!/bin/bash
+# harness-render-progress.sh — Feature-level 프로그래스 렌더링 (공통 함수)
+# source로 포함하여 사용: source "$(dirname "$0")/lib/harness-render-progress.sh"
+
+# ─────────────────────────────────────────
+# Dependencies: jq
+# ─────────────────────────────────────────
+check_jq() {
+  if ! command -v jq &>/dev/null; then
+    echo "[harness] ERROR: jq is required. Install with: brew install jq" >&2
+    return 1
+  fi
+}
+
+# ─────────────────────────────────────────
+# resolve_harness_root — .harness/ 디렉토리 찾기
+# ─────────────────────────────────────────
+resolve_harness_root() {
+  local dir="${1:-.}"
+  dir="$(cd "$dir" && pwd)"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.harness" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  return 1
+}
+
+# ─────────────────────────────────────────
+# render_progress — Feature-level 프로그래스 출력
+#
+# Args:
+#   $1 — project root (optional, defaults to auto-detect)
+#
+# Reads:
+#   .harness/progress.json
+#   .harness/config.json
+#   .harness/actions/feature-list.json (if exists)
+# ─────────────────────────────────────────
+render_progress() {
+  check_jq || return 1
+
+  local PROJECT_ROOT
+  PROJECT_ROOT="$(resolve_harness_root "${1:-.}")" || {
+    echo "[harness] .harness/ directory not found" >&2
+    return 1
+  }
+
+  local PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+  local CONFIG="$PROJECT_ROOT/.harness/config.json"
+  local FEATURES="$PROJECT_ROOT/.harness/actions/feature-list.json"
+
+  if [ ! -f "$PROGRESS" ]; then
+    return 1
+  fi
+
+  # Read progress.json
+  local pipeline sprint_num sprint_status retry_count
+  local current_agent agent_status next_agent
+  local failure_agent failure_location failure_message
+
+  pipeline=$(jq -r '.pipeline // "unknown"' "$PROGRESS")
+  sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
+  sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS")
+  retry_count=$(jq -r '.sprint.retry_count // 0' "$PROGRESS")
+  current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS")
+  agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS")
+  next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS")
+  failure_agent=$(jq -r '.failure.agent // empty' "$PROGRESS")
+  failure_location=$(jq -r '.failure.location // empty' "$PROGRESS")
+  failure_message=$(jq -r '.failure.message // empty' "$PROGRESS")
+
+  # Read max retries from config
+  local max_retries=10
+  if [ -f "$CONFIG" ]; then
+    max_retries=$(jq -r '.flow.max_retries_per_sprint // 10' "$CONFIG")
+  fi
+
+  # Pipeline agents for progress bar
+  local -a pipeline_agents
+  if [ -f "$CONFIG" ] && [ "$pipeline" != "null" ] && [ "$pipeline" != "unknown" ]; then
+    mapfile -t pipeline_agents < <(jq -r ".flow.pipeline_selection.pipelines[\"${pipeline}\"][]" "$CONFIG" 2>/dev/null | sed 's/:.*//')
+  fi
+
+  # ── Header ──
+  local header="Sprint ${sprint_num} / ${pipeline}"
+  local pad_len=$(( 40 - ${#header} ))
+  local padding=""
+  for ((i=0; i<pad_len; i++)); do padding+="═"; done
+  echo ""
+  echo "  ═══ ${header} ${padding}"
+  echo ""
+
+  # ── Feature Progress ──
+  if [ -f "$FEATURES" ]; then
+    local total_features completed_features=0 in_progress_features=0
+    total_features=$(jq '.features | length' "$FEATURES" 2>/dev/null || echo 0)
+
+    if [ "$total_features" -gt 0 ]; then
+      # Determine columns based on pipeline
+      local show_be=true show_fe=true
+      case "$pipeline" in
+        BE-ONLY)  show_fe=false ;;
+        FE-ONLY)  show_be=false ;;
+      esac
+
+      # Build feature lines
+      local i=0
+      while [ $i -lt "$total_features" ]; do
+        local fid fname passes be_pass fe_pass eval_func_pass eval_visual_pass
+        fid=$(jq -r ".features[$i].id // \"F-$((i+1))\"" "$FEATURES")
+        fname=$(jq -r ".features[$i].name // .features[$i].description // \"Feature $((i+1))\"" "$FEATURES")
+        passes=$(jq -r ".features[$i].passes // [] | .[]" "$FEATURES" 2>/dev/null)
+
+        # Truncate name to 20 chars
+        if [ ${#fname} -gt 20 ]; then
+          fname="${fname:0:18}.."
+        fi
+
+        # Check passes
+        be_pass="○"; fe_pass="○"; eval_func_pass="○"; eval_visual_pass="○"
+        local eval_done=false
+
+        while IFS= read -r p; do
+          case "$p" in
+            generator-backend)    be_pass="✓" ;;
+            generator-frontend)   fe_pass="✓" ;;
+            evaluator-functional) eval_func_pass="✓" ;;
+            evaluator-visual)     eval_visual_pass="✓" ;;
+          esac
+        done <<< "$passes"
+
+        # Eval column: both must pass
+        local eval_pass="○"
+        if [ "$eval_func_pass" = "✓" ] && [ "$eval_visual_pass" = "✓" ]; then
+          eval_pass="✓"
+        elif [ "$eval_func_pass" = "✓" ] || [ "$eval_visual_pass" = "✓" ]; then
+          eval_pass="◐"
+        fi
+
+        # Feature status icon
+        local icon="○"
+        local is_complete=false
+        if [ "$show_be" = true ] && [ "$show_fe" = true ]; then
+          # FULLSTACK: all must pass
+          if [ "$be_pass" = "✓" ] && [ "$fe_pass" = "✓" ] && [ "$eval_pass" = "✓" ]; then
+            icon="✓"; is_complete=true
+          elif [ "$be_pass" = "✓" ] || [ "$fe_pass" = "✓" ]; then
+            icon="◐"
+          fi
+        elif [ "$show_be" = true ]; then
+          # BE-ONLY
+          if [ "$be_pass" = "✓" ] && [ "$eval_pass" = "✓" ]; then
+            icon="✓"; is_complete=true
+          elif [ "$be_pass" = "✓" ]; then
+            icon="◐"
+          fi
+        else
+          # FE-ONLY
+          if [ "$fe_pass" = "✓" ] && [ "$eval_pass" = "✓" ]; then
+            icon="✓"; is_complete=true
+          elif [ "$fe_pass" = "✓" ]; then
+            icon="◐"
+          fi
+        fi
+
+        if [ "$is_complete" = true ]; then
+          completed_features=$((completed_features + 1))
+        fi
+
+        # Build columns
+        local cols=""
+        if [ "$show_be" = true ]; then cols+="BE${be_pass}  "; fi
+        if [ "$show_fe" = true ]; then cols+="FE${fe_pass}  "; fi
+        cols+="Eval${eval_pass}"
+
+        printf "  %s %-5s %-22s %s\n" "$icon" "$fid" "$fname" "$cols"
+
+        i=$((i + 1))
+      done
+
+      echo ""
+
+      # ── Progress Bar ──
+      local steps_per_feature=0
+      if [ "$show_be" = true ]; then steps_per_feature=$((steps_per_feature + 1)); fi
+      if [ "$show_fe" = true ]; then steps_per_feature=$((steps_per_feature + 1)); fi
+      steps_per_feature=$((steps_per_feature + 1))  # eval
+
+      local total_steps=$((total_features * steps_per_feature))
+      local done_steps=0
+
+      # Count individual passes across all features
+      i=0
+      while [ $i -lt "$total_features" ]; do
+        passes=$(jq -r ".features[$i].passes // [] | .[]" "$FEATURES" 2>/dev/null)
+        while IFS= read -r p; do
+          case "$p" in
+            generator-backend)
+              if [ "$show_be" = true ]; then done_steps=$((done_steps + 1)); fi
+              ;;
+            generator-frontend)
+              if [ "$show_fe" = true ]; then done_steps=$((done_steps + 1)); fi
+              ;;
+            evaluator-functional|evaluator-visual)
+              # Each eval counts as 0.5 of the eval step
+              # We'll handle this by checking both at the end
+              ;;
+          esac
+        done <<< "$passes"
+
+        # Check eval completion
+        local ef ev
+        ef=$(jq -r ".features[$i].passes // [] | map(select(. == \"evaluator-functional\")) | length" "$FEATURES" 2>/dev/null)
+        ev=$(jq -r ".features[$i].passes // [] | map(select(. == \"evaluator-visual\")) | length" "$FEATURES" 2>/dev/null)
+        if [ "${ef:-0}" -gt 0 ] && [ "${ev:-0}" -gt 0 ]; then
+          done_steps=$((done_steps + 1))
+        elif [ "${ef:-0}" -gt 0 ] || [ "${ev:-0}" -gt 0 ]; then
+          # partial eval — don't count
+          :
+        fi
+
+        i=$((i + 1))
+      done
+
+      local pct=0
+      if [ "$total_steps" -gt 0 ]; then
+        pct=$(( done_steps * 100 / total_steps ))
+      fi
+
+      local bar_width=16
+      local filled=$(( pct * bar_width / 100 ))
+      local empty=$(( bar_width - filled ))
+      local bar=""
+      for ((j=0; j<filled; j++)); do bar+="█"; done
+      for ((j=0; j<empty; j++)); do bar+="░"; done
+
+      echo "  Features: ${completed_features}/${total_features} completed"
+      echo "  Pipeline: ${bar}  ${pct}%"
+    fi
+  else
+    echo "  (feature-list.json not yet created — run Planner first)"
+  fi
+
+  echo ""
+
+  # ── Current Agent Status ──
+  if [ "$current_agent" != "none" ] && [ "$current_agent" != "null" ]; then
+    echo "  Current:  ${current_agent} [${agent_status}] (retry ${retry_count}/${max_retries})"
+  fi
+
+  # ── Failure Info ──
+  if [ -n "$failure_agent" ] && [ "$failure_agent" != "null" ]; then
+    echo ""
+    echo "  ⚠ FAIL: ${failure_agent} → ${failure_location}"
+    if [ -n "$failure_message" ] && [ "$failure_message" != "null" ]; then
+      echo "    ${failure_message}"
+    fi
+  fi
+
+  # ── Blocked ──
+  if [ "$agent_status" = "blocked" ]; then
+    echo ""
+    echo "  ✖ BLOCKED: retry limit (${max_retries}) reached — user intervention required"
+  fi
+
+  # ── Next Action ──
+  if [ "$next_agent" != "none" ] && [ "$next_agent" != "null" ] && [ "$agent_status" != "blocked" ]; then
+    echo ""
+    echo "  Next → /harness-${next_agent}"
+    echo "  Auto → claude --prompt \"\$(cat .harness/next-prompt.txt)\""
+  fi
+
+  echo ""
+}
+
+# ─────────────────────────────────────────
+# render_agent_bar — 에이전트 시퀀스 바 (compact)
+# ─────────────────────────────────────────
+render_agent_bar() {
+  local PROGRESS="${1:-.}/.harness/progress.json"
+  local CONFIG="${1:-.}/.harness/config.json"
+
+  if [ ! -f "$PROGRESS" ] || [ ! -f "$CONFIG" ]; then return 1; fi
+
+  local pipeline current_agent
+  pipeline=$(jq -r '.pipeline // "unknown"' "$PROGRESS")
+  current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS")
+
+  local completed_agents
+  completed_agents=$(jq -r '.completed_agents // [] | .[]' "$PROGRESS")
+
+  if [ "$pipeline" = "null" ] || [ "$pipeline" = "unknown" ]; then return 1; fi
+
+  local agents_line="  Agents: "
+  local first=true
+
+  while IFS= read -r agent; do
+    agent=$(echo "$agent" | sed 's/:.*//')  # strip mode suffix like :light, :api-only
+    if [ "$first" = true ]; then
+      first=false
+    else
+      agents_line+=" → "
+    fi
+
+    if echo "$completed_agents" | grep -q "^${agent}$"; then
+      agents_line+="${agent}✓"
+    elif [ "$agent" = "$current_agent" ]; then
+      agents_line+="[${agent}]"
+    else
+      agents_line+="${agent}"
+    fi
+  done < <(jq -r ".flow.pipeline_selection.pipelines[\"${pipeline}\"][]" "$CONFIG" 2>/dev/null)
+
+  echo "$agents_line"
+}

package/skills/dispatcher/SKILL.md

@@ -6,6 +6,23 @@ disable-model-invocation: false
 
 # Dispatcher — Pipeline Selector + Gotcha Manager
 
+## Session Boundary Protocol
+
+### On Start
+1. `.harness/progress.json` 읽기 — `next_agent`가 `"dispatcher"`인지 확인
+2. progress.json 업데이트: `current_agent` → `"dispatcher"`, `agent_status` → `"running"`, `updated_at` 갱신
+
+### On Complete
+1. progress.json 업데이트:
+   - `agent_status` → `"completed"`
+   - `completed_agents`에 `"dispatcher"` 추가
+   - `next_agent` → `"planner"`
+   - `pipeline` → 선택된 파이프라인 (FULLSTACK/FE-ONLY/BE-ONLY)
+   - `sprint.number` → `1`, `sprint.status` → `"in_progress"`
+2. `.harness/progress.log`에 요약 한 줄 추가
+3. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+4. 출력: `"✓ Dispatcher 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+
 ## 1. Request Classification (최우선)
 
 사용자 입력을 먼저 분류합니다:
@@ -50,4 +67,4 @@ AGENTS.md 비하네스  → 기존 백업 + 리빌드
 
 ## 5. Output
 
-`.harness/actions/pipeline.json` 생성 → 사용자 확인 → 다음 에이전트 실행
+`.harness/actions/pipeline.json` 생성 → 사용자 확인 → Session Boundary Protocol On Complete 실행

package/skills/evaluator-functional/SKILL.md

@@ -6,6 +6,37 @@ disable-model-invocation: true
 
 # Evaluator-Functional — Playwright MCP
 
+## Session Boundary Protocol
+
+### On Start
+1. `.harness/progress.json` 읽기 — `next_agent`가 `"evaluator-functional"`인지 확인
+2. progress.json 업데이트: `current_agent` → `"evaluator-functional"`, `agent_status` → `"running"`, `updated_at` 갱신
+
+### On Complete (PASS)
+1. progress.json 업데이트:
+   - `agent_status` → `"completed"`
+   - `completed_agents`에 `"evaluator-functional"` 추가
+   - `next_agent` → 파이프라인에 따라 결정 (FULLSTACK/FE-ONLY: `"evaluator-visual"`, BE-ONLY: `"archive"`)
+   - `failure` 필드 초기화
+2. `feature-list.json`의 통과 feature `passes`에 `"evaluator-functional"` 추가
+3. `.harness/progress.log`에 PASS 요약 추가
+4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+5. 출력: `"✓ Evaluator-Functional PASS. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+
+### On Fail
+1. progress.json 업데이트:
+   - `agent_status` → `"failed"`
+   - `failure.agent` → `"evaluator-functional"`
+   - `failure.location` → `"backend"` 또는 `"frontend"` (결함 위치)
+   - `failure.message` → 실패 요약 (1줄)
+   - `failure.retry_target` → `"generator-backend"` 또는 `"generator-frontend"`
+   - `next_agent` → `failure.retry_target`과 동일
+   - `sprint.retry_count` 증가
+2. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
+3. `.harness/progress.log`에 FAIL 요약 추가
+4. **STOP.**
+5. 출력: `"✖ Evaluator-Functional FAIL. bash scripts/harness-next.sh 실행하여 재작업 대상 확인."`
+
 ## Critical Mindset
 
 - **회의적 평가자**. Generator의 자체 평가를 신뢰하지 마세요.
@@ -20,7 +51,7 @@ disable-model-invocation: true
 3. `actions/sprint-contract.md` — BE + FE 성공 기준 전체
 4. `actions/feature-list.json` — 이번 스프린트 범위
 5. `actions/api-contract.json` — 기대 API 동작
-6. `progress.txt`
+6. `.harness/progress.json`
 
 ## Evaluation Steps
 
@@ -54,5 +85,5 @@ Playwright 도구 → [도구 레퍼런스](references/playwright-tools.md)
 
 ## After Evaluation
 
-- **PASS** → Evaluator-Visual 핸드오프
-- **FAIL** → `failure_location` 기반 라우팅 (backend/frontend), max 10회
+- **PASS** → Session Boundary Protocol On Complete (PASS) 실행
+- **FAIL** → Session Boundary Protocol On Fail 실행

package/skills/evaluator-visual/SKILL.md

@@ -6,6 +6,37 @@ disable-model-invocation: true
 
 # Evaluator-Visual — Design & Accessibility
 
+## Session Boundary Protocol
+
+### On Start
+1. `.harness/progress.json` 읽기 — `next_agent`가 `"evaluator-visual"`인지 확인
+2. progress.json 업데이트: `current_agent` → `"evaluator-visual"`, `agent_status` → `"running"`, `updated_at` 갱신
+
+### On Complete (PASS)
+1. progress.json 업데이트:
+   - `agent_status` → `"completed"`
+   - `completed_agents`에 `"evaluator-visual"` 추가
+   - `next_agent` → `"archive"`
+   - `failure` 필드 초기화
+2. `feature-list.json`의 통과 feature `passes`에 `"evaluator-visual"` 추가
+3. `.harness/progress.log`에 PASS 요약 추가
+4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+5. 출력: `"✓ Evaluator-Visual PASS. bash scripts/harness-next.sh 실행하여 아카이브 진행."`
+
+### On Fail
+1. progress.json 업데이트:
+   - `agent_status` → `"failed"`
+   - `failure.agent` → `"evaluator-visual"`
+   - `failure.location` → `"frontend"` (비주얼 = 항상 프론트)
+   - `failure.message` → 실패 요약 (1줄)
+   - `failure.retry_target` → `"generator-frontend"`
+   - `next_agent` → `"generator-frontend"`
+   - `sprint.retry_count` 증가
+2. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
+3. `.harness/progress.log`에 FAIL 요약 추가
+4. **STOP.**
+5. 출력: `"✖ Evaluator-Visual FAIL. bash scripts/harness-next.sh 실행하여 재작업 대상 확인."`
+
 ## Startup
 
 1. `AGENTS.md` 읽기
@@ -37,5 +68,5 @@ disable-model-invocation: true
 
 ## After Evaluation
 
-- **PASS** → progress.txt 업데이트, Archive 실행 요청
-- **FAIL** → Generator-Frontend 재작업 (비주얼=항상 프론트), max 10회
+- **PASS** → Session Boundary Protocol On Complete (PASS) 실행
+- **FAIL** → Session Boundary Protocol On Fail 실행

package/skills/generator-backend/SKILL.md

@@ -6,11 +6,29 @@ disable-model-invocation: true
 
 # Generator-Backend — NestJS MSA
 
+## Session Boundary Protocol
+
+### On Start
+1. `.harness/progress.json` 읽기 — `next_agent`가 `"generator-backend"`인지 확인
+2. progress.json 업데이트: `current_agent` → `"generator-backend"`, `agent_status` → `"running"`, `updated_at` 갱신
+3. `failure` 필드 확인 — retry인 경우 `evaluation-functional.md`의 실패 사유 우선 읽기
+
+### On Complete
+1. progress.json 업데이트:
+   - `agent_status` → `"completed"`
+   - `completed_agents`에 `"generator-backend"` 추가
+   - `next_agent` → 파이프라인에 따라 결정 (FULLSTACK: `"generator-frontend"`, BE-ONLY: `"evaluator-functional"`)
+   - `failure` 필드 초기화 (retry 성공 시)
+2. `feature-list.json`의 해당 feature `passes`에 `"generator-backend"` 추가
+3. `.harness/progress.log`에 요약 추가
+4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+5. 출력: `"✓ Generator-Backend 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+
 ## Startup
 
 1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인
 2. `.harness/gotchas/generator-backend.md` 읽기 — **과거 실수 반복 금지**
-3. `pwd` + `.harness/progress.txt` + `git log --oneline -20`
+3. `pwd` + `.harness/progress.json` + `git log --oneline -20`
 4. `.harness/actions/api-contract.json` 읽기 — **이것이 스펙**
 5. `.harness/actions/feature-list.json` — `layer: "backend"` 필터
 6. 통합 러너: `npm run dev`

package/skills/generator-frontend/SKILL.md

@@ -6,11 +6,29 @@ disable-model-invocation: true
 
 # Generator-Frontend — React/Next.js + Premium Design
 
+## Session Boundary Protocol
+
+### On Start
+1. `.harness/progress.json` 읽기 — `next_agent`가 `"generator-frontend"`인지 확인
+2. progress.json 업데이트: `current_agent` → `"generator-frontend"`, `agent_status` → `"running"`, `updated_at` 갱신
+3. `failure` 필드 확인 — retry인 경우 평가 문서의 실패 사유 우선 읽기
+
+### On Complete
+1. progress.json 업데이트:
+   - `agent_status` → `"completed"`
+   - `completed_agents`에 `"generator-frontend"` 추가
+   - `next_agent` → `"evaluator-functional"`
+   - `failure` 필드 초기화 (retry 성공 시)
+2. `feature-list.json`의 해당 feature `passes`에 `"generator-frontend"` 추가
+3. `.harness/progress.log`에 요약 추가
+4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+5. 출력: `"✓ Generator-Frontend 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+
 ## Startup
 
 1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인
 2. `.harness/gotchas/generator-frontend.md` 읽기 — **과거 실수 반복 금지**
-3. `pwd` + `.harness/progress.txt` + `git log --oneline -20`
+3. `pwd` + `.harness/progress.json` + `git log --oneline -20`
 4. `.harness/actions/api-contract.json` 읽기 — **Gateway가 유일한 API 인터페이스**
 5. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
 6. Gateway 확인: `curl -s http://localhost:3000/health`

package/skills/planner/SKILL.md

@@ -6,11 +6,26 @@ disable-model-invocation: true
 
 # Planner Agent
 
+## Session Boundary Protocol
+
+### On Start
+1. `.harness/progress.json` 읽기 — `next_agent`가 `"planner"`인지 확인
+2. progress.json 업데이트: `current_agent` → `"planner"`, `agent_status` → `"running"`, `updated_at` 갱신
+
+### On Complete
+1. progress.json 업데이트:
+   - `agent_status` → `"completed"`
+   - `completed_agents`에 `"planner"` 추가
+   - `next_agent` → 파이프라인에 따라 결정 (FULLSTACK/BE-ONLY: `"generator-backend"`, FE-ONLY: `"generator-frontend"`)
+2. `.harness/progress.log`에 요약 추가
+3. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
+4. 출력: `"✓ Planner 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
+
 ## Startup
 
 1. `AGENTS.md` 읽기
 2. `.harness/gotchas/planner.md` 읽기 — **과거 실수 반복 금지**
-3. `.harness/progress.txt` 읽기
+3. `.harness/progress.json` 읽기
 4. `.harness/actions/pipeline.json` 읽기 — `planner_mode` 확인
 
 ## Outputs (4개)
@@ -43,6 +58,5 @@ disable-model-invocation: true
 
 ## After Completion
 
-1. `progress.txt` 업데이트 (Phase: PLANNED)
-2. 사용자에게 plan.md + api-contract.json 리뷰 요청
-3. 승인 후 → 다음 에이전트 (pipeline.json 참조)
+1. 사용자에게 plan.md + api-contract.json 리뷰 요청
+2. 승인 후 → Session Boundary Protocol On Complete 실행

package/assets/templates/progress.txt.template

@@ -1,15 +0,0 @@
-# Harness Progress Log
-# 세션 간 상태 전달을 위한 진행 기록 파일
-# ─────────────────────────────────────────────────
-
-## [{{DATE}}] Harness Initialized
-- walwal-harness 설치 완료
-- 6-Agent 아키텍처 (Dispatcher → Planner → Gen-BE → Gen-FE → Eval-Func → Eval-Visual)
-- Gotcha 관리 시스템 활성화
-
-## Current State
-- Phase: INIT (Dispatcher 실행 대기)
-- Active Sprint: none
-- Features Completed: 0 / 0
-- Blocking Issues: none
-- Next Action: "하네스 엔지니어링 시작"으로 Dispatcher 실행