timsquad 3.5.0 → 3.7.0

package/templates/platforms/claude-code/rules/plan-review.md

@@ -1,6 +1,6 @@
 ---
 description: 계획 품질 검증 루프. Full Mode에서 구현 전 필수 수행.
-globs:
+paths:
   - ".timsquad/ssot/**"
   - ".timsquad/state/**"
 ---
@@ -8,7 +8,7 @@ globs:
 # 계획 품질 검증 (Plan Review Protocol)
 
 ## 언제 수행하나
-`tsq f`로 Full Mode 진입 시, SSOT 체크 후 / 에이전트 위임 전.
+Controller를 통한 위임 시, SSOT 체크 후 / 에이전트 위임 전.
 
 ## 검증 축 (3-Axis Plan Review)
 

package/templates/platforms/claude-code/rules/quality-guards.md

@@ -1,7 +1,5 @@
 ---
 description: 품질 가드 시스템. 파괴적 명령 차단, 페이즈 제한, 완료 검증.
-globs:
-  - "**/*"
 ---
 
 # 품질 가드 시스템 (Quality Guards)

package/templates/platforms/claude-code/rules/sequence-management.md

@@ -1,6 +1,6 @@
 ---
 description: 시퀀스 관리 규칙. 네이밍, 자동화 파이프라인, 수동 모드.
-globs:
+paths:
   - ".timsquad/logs/**"
   - ".timsquad/state/workspace.xml"
 ---
@@ -18,16 +18,16 @@ Phase/Sequence/Task ID를 **자동 생성**하여 등록하세요. 사용자에
 - Phase ID: `P{N}` — planning=P1, design=P2, implementation=P3, review=P4, security=P5, deployment=P6
 - Sequence ID: `P{N}-S{NNN}` — 페이즈 내 시퀀스 번호 (zero-padded)
 - Task ID: `P{N}-S{NNN}-T{NNN}` — 시퀀스 내 태스크 번호 (zero-padded)
-- 번호는 `tsq wf status`로 기존 시퀀스를 확인한 후 이어서 부여
+- 번호는 `.timsquad/state/workflow.json`에서 기존 시퀀스를 확인한 후 이어서 부여
 
 **흐름 예시**:
 ```
 사용자: "인증 기능이랑 결제 API 구현해줘"
 PM 내부 처리:
 1. config.yaml → naming.phase.order → implementation = P3
-2. tsq wf set-phase P3
-3. tsq wf add-sequence P3-S001 --agents developer,dba
-4. tsq wf add-sequence P3-S002 --agents developer,security
+2. workflow.json → current_phase = P3 설정
+3. P3-S001 시퀀스 등록 (agents: developer, dba)
+4. P3-S002 시퀀스 등록 (agents: developer, security)
 5. @tsq-developer "P3-S001: 인증 구현"
 ```
 
@@ -51,11 +51,11 @@ SessionEnd → tsq daemon stop
 ```
 
 ## 자동화 토글
-```bash
-tsq wf config sequence_log off   # L2 자동 생성 끄기
-tsq wf config retro off          # 자동 회고 끄기
-tsq wf status                    # 현재 상태 확인
-```
+
+`.timsquad/state/workflow.json` → `automation` 섹션에서 직접 toggle:
+- `sequence_log: false` — L2 자동 생성 끄기
+- `retro: false` — 자동 회고 끄기
+- `/status`로 현재 상태 확인
 
 ## 수동 모드 (자동화 꺼진 경우)
 
@@ -65,8 +65,8 @@ tsq wf status                    # 현재 상태 확인
 - 보고서 저장: `.timsquad/reports/{SEQ-ID}-report.md`
 
 ### 수동 L2/L3 생성
-```bash
-tsq log sequence create {SEQ-ID} --phase {phase} --report {path} --verdict proceed
-tsq log phase create {phase-id} --sequences "SEQ-01,SEQ-02"
-tsq log phase gate {phase-id}
-```
+
+`/log` 스킬을 사용하여 수동 로그 생성:
+- 시퀀스 로그: `.timsquad/logs/sequences/{SEQ-ID}.md`
+- 페이즈 로그: `.timsquad/logs/phases/{phase-id}.md`
+- 페이즈 게이트: workflow.json → completed_phases 업데이트

package/templates/platforms/claude-code/rules/session-notes.md

@@ -1,6 +1,6 @@
 ---
 description: 컨텍스트 생존 메모. 세션 압축 후 작업 연속성 유지.
-globs:
+paths:
   - ".timsquad/.daemon/**"
 ---
 

package/templates/platforms/claude-code/rules/test-conventions.md

@@ -0,0 +1,13 @@
+---
+paths:
+  - "tests/**/*.test.ts"
+  - "tests/**/*.spec.ts"
+  - "**/*.test.ts"
+  - "**/*.spec.ts"
+---
+
+- describe/it 중첩 3단계 이하 유지
+- 테스트 데이터는 인라인 또는 fixtures/ 디렉토리 사용
+- 각 테스트는 독립적 (공유 상태 금지, beforeEach에서 초기화)
+- 테스트 이름은 "should + 기대 동작" 형식
+- mock은 최소 범위로 사용 (외부 의존성만 mock)

package/templates/platforms/claude-code/rules/workspace-sync.md

@@ -1,6 +1,6 @@
 ---
 description: workspace.xml 실시간 상태 관리 규칙.
-globs:
+paths:
   - ".timsquad/state/workspace.xml"
 ---
 

package/templates/platforms/claude-code/scripts/build-gate.sh

@@ -30,7 +30,12 @@ fi
 
 # ── 1. Get changed TypeScript files ──
 cd "$PROJECT_ROOT"
-CHANGED_TS=$(git diff --name-only --diff-filter=ACMR HEAD -- '*.ts' '*.tsx' 2>/dev/null || echo "")
+CHANGED_TS=$(git diff --cached --name-only --diff-filter=ACMR -- '*.ts' '*.tsx' 2>/dev/null || echo "")
+# Include unstaged changes too
+CHANGED_TS_UNSTAGED=$(git diff --name-only --diff-filter=ACMR -- '*.ts' '*.tsx' 2>/dev/null || echo "")
+if [ -n "$CHANGED_TS_UNSTAGED" ]; then
+  CHANGED_TS=$(printf '%s\n%s' "$CHANGED_TS" "$CHANGED_TS_UNSTAGED" | sort -u)
+fi
 
 # No TypeScript files changed → pass
 if [ -z "$CHANGED_TS" ]; then

package/templates/platforms/claude-code/scripts/change-scope-guard.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+# change-scope-guard.sh — PreToolUse Hook (Edit/Write)
+# Tracks cumulative file changes and enforces SCR (Single Change Rule).
+# 3 files: warning, 6 files: block, >100 lines total: warning
+#
+# Input: JSON via stdin (Claude Code hook protocol)
+# Output: JSON with permissionDecision (allow/deny/ask)
+#
+# State file: /tmp/tsq-scope-guard-${SESSION_ID:-default}.json
+
+set -euo pipefail
+
+WARN_FILES=3
+BLOCK_FILES=6
+WARN_LINES=100
+
+# Session-scoped state file
+SESSION_ID="${CLAUDE_SESSION_ID:-default}"
+STATE_FILE="/tmp/tsq-scope-guard-${SESSION_ID}.json"
+
+# Read hook input from stdin
+INPUT=$(cat 2>/dev/null || echo "")
+
+# Fail-open: no input → allow
+if [ -z "$INPUT" ]; then
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Extract tool name
+TOOL_NAME=""
+if command -v jq >/dev/null 2>&1; then
+  TOOL_NAME=$(echo "$INPUT" | jq -r '.toolName // empty' 2>/dev/null || true)
+fi
+
+# Only track Edit and Write tools
+if [ "$TOOL_NAME" != "Edit" ] && [ "$TOOL_NAME" != "Write" ]; then
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Extract file path from tool input
+FILE_PATH=""
+if command -v jq >/dev/null 2>&1; then
+  FILE_PATH=$(echo "$INPUT" | jq -r '.toolInput.file_path // empty' 2>/dev/null || true)
+fi
+
+if [ -z "$FILE_PATH" ]; then
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Initialize state file if needed
+if [ ! -f "$STATE_FILE" ]; then
+  echo '{"files":[],"total_lines":0}' > "$STATE_FILE"
+fi
+
+# Read current state
+if command -v jq >/dev/null 2>&1; then
+  CURRENT_FILES=$(jq -r '.files[]' "$STATE_FILE" 2>/dev/null || true)
+  TOTAL_LINES=$(jq -r '.total_lines // 0' "$STATE_FILE" 2>/dev/null || echo "0")
+else
+  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  exit 0
+fi
+
+# Check if file is already tracked
+ALREADY_TRACKED=false
+while IFS= read -r f; do
+  if [ "$f" = "$FILE_PATH" ]; then
+    ALREADY_TRACKED=true
+    break
+  fi
+done <<< "$CURRENT_FILES"
+
+# Add new file if not tracked
+if [ "$ALREADY_TRACKED" = false ]; then
+  jq --arg fp "$FILE_PATH" '.files += [$fp]' "$STATE_FILE" > "${STATE_FILE}.tmp" && mv "${STATE_FILE}.tmp" "$STATE_FILE"
+fi
+
+# Estimate line changes (for Edit: old_string length approximation)
+if [ "$TOOL_NAME" = "Edit" ]; then
+  NEW_LINES=$(echo "$INPUT" | jq -r '.toolInput.new_string // ""' 2>/dev/null | wc -l || echo "0")
+  TOTAL_LINES=$((TOTAL_LINES + NEW_LINES))
+  jq --argjson tl "$TOTAL_LINES" '.total_lines = $tl' "$STATE_FILE" > "${STATE_FILE}.tmp" && mv "${STATE_FILE}.tmp" "$STATE_FILE"
+fi
+
+# Count unique files
+FILE_COUNT=$(jq '.files | length' "$STATE_FILE" 2>/dev/null || echo "0")
+
+# Decision logic
+if [ "$FILE_COUNT" -ge "$BLOCK_FILES" ]; then
+  MSG="SCR violation: ${FILE_COUNT} files modified (limit: ${BLOCK_FILES}). Split into smaller tasks."
+  echo "{\"hookSpecificOutput\":{\"permissionDecision\":\"deny\",\"message\":\"${MSG}\"}}"
+  exit 0
+fi
+
+if [ "$FILE_COUNT" -ge "$WARN_FILES" ]; then
+  MSG="SCR warning: ${FILE_COUNT} files modified. Consider splitting this task."
+  echo "{\"hookSpecificOutput\":{\"permissionDecision\":\"allow\",\"message\":\"${MSG}\"}}"
+  exit 0
+fi
+
+if [ "$TOTAL_LINES" -ge "$WARN_LINES" ]; then
+  MSG="Large change: ~${TOTAL_LINES} lines modified across ${FILE_COUNT} files."
+  echo "{\"hookSpecificOutput\":{\"permissionDecision\":\"allow\",\"message\":\"${MSG}\"}}"
+  exit 0
+fi
+
+echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'

package/templates/platforms/claude-code/scripts/check-capability.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# Hook Gate: controller capability token 검증
+# PreToolUse (Write|Edit) — controller 미경유 시 차단
+#
+# 동작:
+# 1. controller-active 파일 없으면 → deny
+# 2. allowed-paths.txt에 없는 파일이면 → deny
+# 3. .timsquad/ 내부 파일은 항상 허용
+
+set -euo pipefail
+
+STATE_DIR=".timsquad/state"
+ACTIVE_FILE="$STATE_DIR/controller-active"
+ALLOWED_FILE="$STATE_DIR/allowed-paths.txt"
+
+# Read tool input from stdin
+INPUT=$(cat 2>/dev/null || echo "")
+FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//' | sed 's/"$//')
+
+# No file path → allow (not a file operation)
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# .timsquad/ internal files → always allow
+if [[ "$FILE_PATH" == *".timsquad/"* ]]; then
+  exit 0
+fi
+
+# .claude/ internal files → always allow
+if [[ "$FILE_PATH" == *".claude/"* ]]; then
+  exit 0
+fi
+
+# No state directory → pipeline not active, allow (no enforcement)
+if [ ! -d "$STATE_DIR" ]; then
+  exit 0
+fi
+
+# Controller active check
+if [ ! -f "$ACTIVE_FILE" ]; then
+  # Controller not active → allow without enforcement
+  # (enforcement only when pipeline is explicitly started)
+  exit 0
+fi
+
+# Allowed paths check
+if [ -f "$ALLOWED_FILE" ]; then
+  MATCH=0
+  while IFS= read -r pattern; do
+    [ -z "$pattern" ] && continue
+    # shellcheck disable=SC2254
+    case "$FILE_PATH" in
+      $pattern) MATCH=1; break ;;
+    esac
+  done < "$ALLOWED_FILE"
+
+  if [ "$MATCH" -eq 0 ]; then
+    # File not in allowed paths → deny
+    PATTERNS=$(tr '\n' ', ' < "$ALLOWED_FILE")
+    jq -n --arg msg "작업 범위 밖 파일입니다. controller가 허용한 파일만 수정할 수 있습니다. 허용 패턴: $PATTERNS" \
+      '{"hookSpecificOutput":{"permissionDecision":"deny"},"systemMessage":$msg}'
+    exit 0
+  fi
+fi
+
+# All checks passed
+exit 0

package/templates/platforms/claude-code/scripts/completion-guard.sh

@@ -34,18 +34,65 @@ fi
 
 BLOCK_REASON=""
 
-# ── 1. Test execution gate (implementation phase only) ──
-# 자기 보고 금지: 테스트 exit code로 완료를 판정한다.
-# stop_hook_active=false일 때만 블로킹 (1회 기회 부여, 루프 방지는 섹션 0에서 처리)
+# ── 1. Test execution gate ──
+# 변경된 소스 파일에 대한 테스트 실행 여부 확인
+# implementation phase에서만 block, 그 외에는 warning
 PHASE_FILE="$PROJECT_ROOT/.timsquad/state/current-phase.json"
+PHASE="unknown"
 if [ -f "$PHASE_FILE" ]; then
   PHASE=$(jq -r '.current // .current_phase // .phase // "unknown"' "$PHASE_FILE" 2>/dev/null || echo "unknown")
-  if [ "$PHASE" = "implementation" ]; then
-    SESSION_STATE="$PROJECT_ROOT/.timsquad/.daemon/session-state.json"
-    if [ -f "$SESSION_STATE" ]; then
-      BASH_COMMANDS=$(jq -r '.metrics.bashCommands // 0' "$SESSION_STATE" 2>/dev/null || echo "0")
-      if [ "$BASH_COMMANDS" -eq 0 ] 2>/dev/null; then
-        BLOCK_REASON="[Completion Guard] 이번 세션에서 테스트가 실행되지 않았습니다. 프로젝트의 테스트를 실행하여 변경사항을 검증한 후 완료하세요."
+fi
+
+TEST_WARNING=""
+SESSION_STATE="$PROJECT_ROOT/.timsquad/.daemon/session-state.json"
+if [ -f "$SESSION_STATE" ]; then
+  # Check if any bash commands were executed (tests run via bash)
+  BASH_COMMANDS=$(jq -r '.metrics.bashCommands // 0' "$SESSION_STATE" 2>/dev/null || echo "0")
+
+  if [ "$BASH_COMMANDS" -eq 0 ] 2>/dev/null; then
+    # No tests or bash at all — check for changed source files
+    CHANGED_SRC=$(cd "$PROJECT_ROOT" && git diff --name-only --diff-filter=ACMR HEAD 2>/dev/null | grep -E '\.(ts|tsx|js|jsx)$' | grep -vE '\.(test|spec)\.' | head -5)
+    if [ -n "$CHANGED_SRC" ]; then
+      # List related test files that should have been run
+      RELATED_TESTS=""
+      while IFS= read -r SRC_FILE; do
+        [ -z "$SRC_FILE" ] && continue
+        BASE_NAME=$(basename "$SRC_FILE" | sed 's/\.[^.]*$//')
+        POTENTIAL=$(cd "$PROJECT_ROOT" && find . -name "${BASE_NAME}.test.*" -o -name "${BASE_NAME}.spec.*" 2>/dev/null | head -1)
+        if [ -n "$POTENTIAL" ]; then
+          RELATED_TESTS="$RELATED_TESTS $POTENTIAL"
+        fi
+      done <<< "$CHANGED_SRC"
+
+      if [ -n "$RELATED_TESTS" ]; then
+        TEST_WARNING="[Test Gate] 변경된 파일에 대한 테스트가 실행되지 않았습니다. 관련 테스트:$RELATED_TESTS"
+      else
+        TEST_WARNING="[Test Gate] 변경된 소스 파일이 있으나 테스트가 실행되지 않았습니다."
+      fi
+
+      if [ "$PHASE" = "implementation" ]; then
+        BLOCK_REASON="$TEST_WARNING 테스트를 실행한 후 완료하세요."
+      fi
+    fi
+  fi
+fi
+
+# ── 1b. TDD gate: 소스 변경 시 테스트 파일도 변경되었는지 확인 ──
+if [ "$PHASE" = "implementation" ] && [ -z "$BLOCK_REASON" ]; then
+  ALL_CHANGED=$(cd "$PROJECT_ROOT" && {
+    git diff --cached --name-only --diff-filter=ACMR 2>/dev/null
+    git diff --name-only --diff-filter=ACMR 2>/dev/null
+    git ls-files --others --exclude-standard 2>/dev/null
+  } | sort -u | grep -E '\.(ts|tsx|js|jsx)$')
+
+  if [ -n "$ALL_CHANGED" ]; then
+    SRC_CHANGED=$(echo "$ALL_CHANGED" | grep -vE '\.(test|spec)\.' | grep -v '__tests__/' | head -5)
+    TEST_CHANGED=$(echo "$ALL_CHANGED" | grep -E '\.(test|spec)\.' | head -1)
+
+    if [ -n "$SRC_CHANGED" ] && [ -z "$TEST_CHANGED" ]; then
+      REFACTOR_ONLY=$(echo "$INPUT" | jq -r '.transcript // ""' 2>/dev/null | grep -ci 'refactor-only' || echo "0")
+      if [ "$REFACTOR_ONLY" -eq 0 ] 2>/dev/null; then
+        BLOCK_REASON="[TDD Gate] 소스 파일이 변경되었으나 테스트 파일(.test./.spec.)이 없습니다. 테스트를 먼저 작성하세요. (리팩토링만 한 경우 Notes에 'refactor-only' 명시)"
       fi
     fi
   fi
@@ -72,22 +119,95 @@ if [ -f "$NOTES_FILE" ]; then
 
     # ── 3. Context window monitor (85% threshold) ──
     if [ "$CTX_PCT" -ge 85 ] 2>/dev/null; then
-      SESSION_CTX="$SESSION_CTX\\n⚠ [Context ${CTX_PCT}%] 컨텍스트 윈도우 85% 이상 사용. 중요 정보를 session-notes에 기록하고, 현재 태스크를 정리한 뒤 완료하세요."
+      SESSION_CTX="$SESSION_CTX\\n⚠ [Context ${CTX_PCT}%] 컨텍스트 윈도우 85% 이상. 현재 작업을 마무리하고, Phase Memory(.timsquad/state/phase-memory.md)를 갱신한 뒤 /clear로 컨텍스트를 초기화하세요. /clear 후에도 phase-memory가 자동 주입됩니다."
     elif [ "$CTX_PCT" -ge 70 ] 2>/dev/null; then
       SESSION_CTX="$SESSION_CTX | Ctx: ${CTX_PCT}%"
     fi
   fi
 fi
 
-# ── 4. Combine and output ──
+# ── 4. SSOT readiness check ──
+SSOT_WARNING=""
+PRD_FILE="$PROJECT_ROOT/.timsquad/ssot/prd.md"
+if [ -f "$PRD_FILE" ]; then
+  # Check if PRD is mostly placeholder (TBD, [Resource Name], example.com)
+  TOTAL_LINES=$(wc -l < "$PRD_FILE" 2>/dev/null || echo "0")
+  PLACEHOLDER_LINES=$(grep -ciE 'TBD|\[Resource Name\]|\[프로젝트|example\.com|placeholder' "$PRD_FILE" 2>/dev/null || echo "0")
+  if [ "$TOTAL_LINES" -gt 0 ] 2>/dev/null; then
+    PCT=$((PLACEHOLDER_LINES * 100 / TOTAL_LINES))
+    if [ "$PCT" -ge 50 ] 2>/dev/null; then
+      SSOT_WARNING="[SSOT] PRD가 아직 작성되지 않았습니다. /tsq-start로 온보딩을 진행하세요 (PRD 작성 + 기능별 /grill 인터뷰)."
+    fi
+  fi
+elif [ -d "$PROJECT_ROOT/.timsquad/ssot" ]; then
+  SSOT_WARNING="[SSOT] PRD가 존재하지 않습니다. /tsq-start로 온보딩을 시작하세요."
+fi
+
+# Check Sub-PRD coverage (grill completeness)
+if [ -z "$SSOT_WARNING" ] && [ -f "$PRD_FILE" ]; then
+  # Count features in PRD index that have no Sub-PRD link
+  FEATURE_COUNT=$(grep -cE '^\|.*\|.*\|' "$PRD_FILE" 2>/dev/null || echo "0")
+  SUBPRD_DIR="$PROJECT_ROOT/.timsquad/ssot/prd"
+  SUBPRD_COUNT=0
+  if [ -d "$SUBPRD_DIR" ]; then
+    SUBPRD_COUNT=$(find "$SUBPRD_DIR" -name "*.md" -not -name "_template.md" 2>/dev/null | wc -l | tr -d ' ')
+  fi
+  if [ "$FEATURE_COUNT" -gt 2 ] && [ "$SUBPRD_COUNT" -eq 0 ] 2>/dev/null; then
+    SSOT_WARNING="[SSOT] PRD에 기능이 정의되었으나 Sub-PRD가 없습니다. /tsq-grill로 각 기능을 상세화하세요."
+  fi
+fi
+
+# ── 5. Skill Verification reminder (max 3 skills) ──
+VERIFICATION=""
+SKILLS_DIR="$PROJECT_ROOT/.claude/skills"
+if [ -d "$SKILLS_DIR" ]; then
+  SKILL_COUNT=0
+  for SKILL_DIR in "$SKILLS_DIR"/*/; do
+    [ "$SKILL_COUNT" -ge 3 ] && break
+    SKILL_FILE="$SKILL_DIR/SKILL.md"
+    [ ! -f "$SKILL_FILE" ] && continue
+
+    SKILL_NAME=$(basename "$SKILL_DIR")
+    # Skip non-active/template skills
+    case "$SKILL_NAME" in _template|tsq-cli|main-session-constraints) continue ;; esac
+
+    # Extract Verification section (2 lines max)
+    CHECKS=$(awk '/^## Verification/{capture=1; next} /^## /{capture=0} capture && /\|.*\|.*\|/ && !/Check.*Command/' "$SKILL_FILE" 2>/dev/null | head -2)
+    if [ -n "$CHECKS" ]; then
+      VERIFICATION="$VERIFICATION
+[Skill Verification] $SKILL_NAME: $CHECKS"
+      SKILL_COUNT=$((SKILL_COUNT + 1))
+    fi
+  done
+fi
+
+# ── 6. Combine and output ──
 # BLOCK_REASON이 있으면 decision:block으로 강제 속행 (세션 컨텍스트 포함)
 if [ -n "$BLOCK_REASON" ]; then
   FULL_REASON="$BLOCK_REASON"
-  [ -n "$SESSION_CTX" ] && FULL_REASON="$BLOCK_REASON
+  [ -n "$SESSION_CTX" ] && FULL_REASON="$FULL_REASON
 $SESSION_CTX"
+  [ -n "$SSOT_WARNING" ] && FULL_REASON="$FULL_REASON
+$SSOT_WARNING"
+  [ -n "$VERIFICATION" ] && FULL_REASON="$FULL_REASON
+$VERIFICATION"
   jq -n --arg reason "$FULL_REASON" '{"decision": "block", "reason": $reason}'
-elif [ -n "$SESSION_CTX" ]; then
-  jq -n --arg msg "$SESSION_CTX" '{"systemMessage": $msg}'
+elif [ -n "$SESSION_CTX" ] || [ -n "$VERIFICATION" ] || [ -n "$TEST_WARNING" ] || [ -n "$SSOT_WARNING" ]; then
+  FULL_MSG=""
+  [ -n "$SESSION_CTX" ] && FULL_MSG="$SESSION_CTX"
+  if [ -n "$SSOT_WARNING" ]; then
+    [ -n "$FULL_MSG" ] && FULL_MSG="$FULL_MSG
+$SSOT_WARNING" || FULL_MSG="$SSOT_WARNING"
+  fi
+  if [ -n "$TEST_WARNING" ]; then
+    [ -n "$FULL_MSG" ] && FULL_MSG="$FULL_MSG
+$TEST_WARNING" || FULL_MSG="$TEST_WARNING"
+  fi
+  if [ -n "$VERIFICATION" ]; then
+    [ -n "$FULL_MSG" ] && FULL_MSG="$FULL_MSG
+$VERIFICATION" || FULL_MSG="$VERIFICATION"
+  fi
+  jq -n --arg msg "$FULL_MSG" '{"systemMessage": $msg}'
 else
   echo '{}'
 fi

package/templates/platforms/claude-code/scripts/context-restore.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+# Context Restore — SessionStart (compact) Hook
+# 컴팩션 후 핵심 컨텍스트를 재주입하여 에이전트 맥락 유실을 방지한다.
+#
+# Input: JSON via stdin (Claude Code hook protocol)
+# Output: JSON with systemMessage (컨텍스트 재주입)
+
+set -e
+
+# Find project root
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+  if [ -d "$PROJECT_ROOT/.timsquad" ]; then
+    break
+  fi
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+if [ ! -d "$PROJECT_ROOT/.timsquad" ]; then
+  exit 0
+fi
+
+# Build context summary
+CONTEXT=""
+
+# 1. Project name from config
+PROJECT_NAME=""
+CONFIG_FILE="$PROJECT_ROOT/.timsquad/config.yaml"
+if [ -f "$CONFIG_FILE" ]; then
+  PROJECT_NAME=$(grep -m1 'name:' "$CONFIG_FILE" 2>/dev/null | awk '{print $2}' || echo "")
+fi
+
+if [ -n "$PROJECT_NAME" ]; then
+  CONTEXT="[Context Restore] Project: $PROJECT_NAME"
+else
+  CONTEXT="[Context Restore] TimSquad project"
+fi
+
+# 2. Current phase
+PHASE_FILE="$PROJECT_ROOT/.timsquad/state/current-phase.json"
+if [ -f "$PHASE_FILE" ]; then
+  CURRENT_PHASE=$(jq -r '.current // .current_phase // .phase // "unknown"' "$PHASE_FILE" 2>/dev/null || echo "unknown")
+  CONTEXT="$CONTEXT | Phase: $CURRENT_PHASE"
+fi
+
+# 3. Read compact summary if exists (saved by pre-compact.sh)
+COMPACT_SUMMARY="$PROJECT_ROOT/.timsquad/.daemon/compact-summary.md"
+if [ -f "$COMPACT_SUMMARY" ]; then
+  SUMMARY_CONTENT=$(head -10 "$COMPACT_SUMMARY" 2>/dev/null || echo "")
+  if [ -n "$SUMMARY_CONTENT" ]; then
+    CONTEXT="$CONTEXT
+$SUMMARY_CONTENT"
+  fi
+fi
+
+# 4. Phase Memory (이전 Phase 요약)
+PHASE_MEMORY="$PROJECT_ROOT/.timsquad/state/phase-memory.md"
+if [ -f "$PHASE_MEMORY" ]; then
+  MEMORY_CONTENT=$(head -50 "$PHASE_MEMORY" 2>/dev/null || echo "")
+  if [ -n "$MEMORY_CONTENT" ]; then
+    CONTEXT="$CONTEXT
+[Phase Memory]
+$MEMORY_CONTENT"
+  fi
+fi
+
+# 5. SSOT readiness check
+PRD_FILE="$PROJECT_ROOT/.timsquad/ssot/prd.md"
+if [ -f "$PRD_FILE" ]; then
+  TOTAL_LINES=$(wc -l < "$PRD_FILE" 2>/dev/null || echo "0")
+  PLACEHOLDER_LINES=$(grep -ciE 'TBD|\[Resource Name\]|\[프로젝트|example\.com|placeholder' "$PRD_FILE" 2>/dev/null || echo "0")
+  TOTAL_LINES=${TOTAL_LINES:-0}
+  PLACEHOLDER_LINES=${PLACEHOLDER_LINES:-0}
+  if [ "$TOTAL_LINES" -gt 0 ] && [ "$((PLACEHOLDER_LINES * 100 / TOTAL_LINES))" -ge 50 ] 2>/dev/null; then
+    CONTEXT="$CONTEXT
+[SSOT] PRD 미작성. /tsq-start로 온보딩을 진행하세요 (PRD + /tsq-grill 인터뷰)."
+  fi
+elif [ -d "$PROJECT_ROOT/.timsquad/ssot" ]; then
+  CONTEXT="$CONTEXT
+[SSOT] PRD 없음. /tsq-start로 온보딩을 시작하세요."
+fi
+
+# 6. Key constraints (3 lines max)
+CONTEXT="$CONTEXT
+[Key Constraints] 구현 전 검증 기준 명시. 작업 지시 시 SSOT + 데몬 사전조건 확인."
+
+# Output as systemMessage
+jq -n --arg msg "$CONTEXT" '{
+  hookSpecificOutput: {
+    hookEventName: "SessionStart",
+    systemMessage: $msg
+  }
+}'
+
+exit 0

package/templates/platforms/claude-code/scripts/e2e-commit-gate.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# e2e-commit-gate.sh — Pre-commit hook: validates E2E marker before allowing commit
+# Checks: JSON marker exists, valid format, source_hash matches, not expired
+#
+# Exit 0 = allow commit, Exit 1 = block commit
+
+set -euo pipefail
+
+MARKER_FILE=".e2e-passed"
+
+# No marker = no E2E tests configured, allow
+if [ ! -f "$MARKER_FILE" ]; then
+  exit 0
+fi
+
+# Try to parse as JSON; if not JSON, treat as bare touch (legacy fallback)
+if ! command -v jq >/dev/null 2>&1; then
+  echo "Warning: jq not installed, skipping E2E marker validation"
+  exit 0
+fi
+
+# Attempt JSON parse
+if ! jq empty "$MARKER_FILE" 2>/dev/null; then
+  # Bare touch file (legacy) — allow with warning
+  echo "Warning: .e2e-passed is not JSON format. Consider running E2E tests with e2e-marker.sh"
+  exit 0
+fi
+
+# Validate required fields
+EXIT_CODE=$(jq -r '.exit_code // empty' "$MARKER_FILE")
+SOURCE_HASH=$(jq -r '.source_hash // empty' "$MARKER_FILE")
+EXPIRES_AT=$(jq -r '.expires_at // empty' "$MARKER_FILE")
+
+# exit_code must be 0
+if [ -n "$EXIT_CODE" ] && [ "$EXIT_CODE" -ne 0 ]; then
+  echo "E2E commit gate: BLOCKED — marker shows exit_code=$EXIT_CODE (tests failed)"
+  exit 1
+fi
+
+# source_hash check
+if [ -n "$SOURCE_HASH" ] && [ "$SOURCE_HASH" != "unknown" ]; then
+  CURRENT_HASH=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+  if [ "$SOURCE_HASH" != "$CURRENT_HASH" ]; then
+    echo "E2E commit gate: WARNING — marker source_hash ($SOURCE_HASH) != current HEAD ($CURRENT_HASH)"
+    echo "  E2E tests may be stale. Consider re-running."
+  fi
+fi
+
+# Expiry check
+if [ -n "$EXPIRES_AT" ]; then
+  EXPIRES_EPOCH=$(date -u -j -f "%Y-%m-%dT%H:%M:%SZ" "$EXPIRES_AT" +%s 2>/dev/null || \
+                  date -u -d "$EXPIRES_AT" +%s 2>/dev/null || echo "0")
+  NOW_EPOCH=$(date -u +%s)
+  if [ "$EXPIRES_EPOCH" -gt 0 ] && [ "$NOW_EPOCH" -gt "$EXPIRES_EPOCH" ]; then
+    echo "E2E commit gate: BLOCKED — marker expired at $EXPIRES_AT"
+    echo "  Re-run E2E tests to refresh the marker."
+    exit 1
+  fi
+fi
+
+# All checks passed
+PASSED=$(jq -r '.passed // 0' "$MARKER_FILE")
+FLAKY=$(jq -r '.flaky // 0' "$MARKER_FILE")
+if [ "$FLAKY" -gt 0 ]; then
+  echo "E2E commit gate: PASSED ($PASSED tests, $FLAKY flaky — investigate flaky tests)"
+else
+  echo "E2E commit gate: PASSED ($PASSED tests)"
+fi
+
+exit 0