timsquad 3.4.0 → 3.6.0

package/templates/platforms/claude-code/scripts/skill-inject.sh

@@ -0,0 +1,216 @@
+#!/bin/bash
+# Skill Inject — UserPromptSubmit Hook
+# 사용자 프롬프트를 분석하여 매칭 스킬의 Contract/Protocol/Verification을
+# systemMessage로 강제 주입한다 (advisory → mandatory 전환).
+#
+# 기존 skill-suggest.sh를 대체 (상위 호환).
+# Input: JSON via stdin (Claude Code hook protocol, .prompt 필드 포함)
+# Output: JSON with systemMessage (스킬 강제 주입)
+
+set -e
+
+# Read hook input
+INPUT=$(cat 2>/dev/null || echo "")
+if [ -z "$INPUT" ]; then
+  exit 0
+fi
+
+PROMPT=$(echo "$INPUT" | jq -r '.prompt // ""' 2>/dev/null || echo "")
+if [ -z "$PROMPT" ] || [ "$PROMPT" = "null" ]; then
+  exit 0
+fi
+
+# 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
+
+# Load skill rules
+RULES_FILE="$PROJECT_ROOT/.claude/scripts/skill-rules.json"
+if [ ! -f "$RULES_FILE" ]; then
+  exit 0
+fi
+
+THRESHOLD=$(jq -r '.threshold // 2' "$RULES_FILE" 2>/dev/null || echo "2")
+PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+
+# Match skills and collect top matches with scores
+declare -a MATCH_SKILLS=()
+declare -a MATCH_SCORES=()
+
+RULE_COUNT=$(jq '.rules | length' "$RULES_FILE" 2>/dev/null || echo "0")
+
+i=0
+while [ "$i" -lt "$RULE_COUNT" ]; do
+  SKILL=$(jq -r ".rules[$i].skill" "$RULES_FILE" 2>/dev/null)
+  SCORE=0
+
+  # Check if skill is deployed
+  SKILL_DIR="$PROJECT_ROOT/.claude/skills/$SKILL"
+  if [ ! -d "$SKILL_DIR" ]; then
+    i=$((i + 1))
+    continue
+  fi
+
+  # Keyword matching (3 points each)
+  KW_COUNT=$(jq ".rules[$i].keywords | length" "$RULES_FILE" 2>/dev/null || echo "0")
+  j=0
+  while [ "$j" -lt "$KW_COUNT" ]; do
+    KW=$(jq -r ".rules[$i].keywords[$j]" "$RULES_FILE" 2>/dev/null)
+    if echo "$PROMPT_LOWER" | grep -qi -- "$KW" 2>/dev/null; then
+      SCORE=$((SCORE + 3))
+    fi
+    j=$((j + 1))
+  done
+
+  # Pattern matching (5 points each)
+  PAT_COUNT=$(jq ".rules[$i].patterns | length" "$RULES_FILE" 2>/dev/null || echo "0")
+  k=0
+  while [ "$k" -lt "$PAT_COUNT" ]; do
+    PAT=$(jq -r ".rules[$i].patterns[$k]" "$RULES_FILE" 2>/dev/null)
+    if [ -n "$PAT" ] && echo "$PROMPT_LOWER" | grep -qiE -- "$PAT" 2>/dev/null; then
+      SCORE=$((SCORE + 5))
+    fi
+    k=$((k + 1))
+  done
+
+  # Threshold check
+  if [ "$SCORE" -ge "$THRESHOLD" ]; then
+    MATCH_SKILLS+=("$SKILL")
+    MATCH_SCORES+=("$SCORE")
+  fi
+
+  i=$((i + 1))
+done
+
+# Sort by score descending and take top 3
+SORTED_INDICES=""
+if [ ${#MATCH_SKILLS[@]} -gt 0 ]; then
+  SORTED_INDICES=$(
+    for idx in "${!MATCH_SCORES[@]}"; do
+      echo "${MATCH_SCORES[$idx]} $idx"
+    done | sort -rn | head -3 | awk '{print $2}'
+  )
+fi
+
+# Extract Contract + Protocol + Verification sections from matched skills
+INJECTION=""
+CHAR_COUNT=0
+MAX_CHARS=1500
+
+for idx in $SORTED_INDICES; do
+  SKILL="${MATCH_SKILLS[$idx]}"
+  SKILL_FILE="$PROJECT_ROOT/.claude/skills/$SKILL/SKILL.md"
+
+  if [ ! -f "$SKILL_FILE" ]; then
+    continue
+  fi
+
+  # Extract key sections (Contract + Protocol + Verification)
+  SECTIONS=$(awk '
+    /^## Contract/ { capture=1; next }
+    /^## Protocol/ { capture=1; next }
+    /^## Verification/ { capture=1; next }
+    /^## / { capture=0 }
+    capture { print }
+  ' "$SKILL_FILE" 2>/dev/null | head -20)
+
+  if [ -z "$SECTIONS" ]; then
+    continue
+  fi
+
+  # Append memory/ contents if exists (project-specific decisions)
+  MEMORY_DIR="$PROJECT_ROOT/.claude/skills/$SKILL/memory"
+  MEMORY_CONTENT=""
+  if [ -d "$MEMORY_DIR" ]; then
+    for MEM_FILE in "$MEMORY_DIR"/*.md; do
+      [ ! -f "$MEM_FILE" ] && continue
+      MEM_TEXT=$(head -10 "$MEM_FILE" 2>/dev/null || echo "")
+      if [ -n "$MEM_TEXT" ]; then
+        MEMORY_CONTENT="$MEMORY_CONTENT
+$MEM_TEXT"
+      fi
+    done
+  fi
+
+  ENTRY="[Skill: $SKILL] $SECTIONS"
+  if [ -n "$MEMORY_CONTENT" ]; then
+    ENTRY="$ENTRY
+[Memory] $MEMORY_CONTENT"
+  fi
+  ENTRY_LEN=${#ENTRY}
+
+  if [ $((CHAR_COUNT + ENTRY_LEN)) -gt "$MAX_CHARS" ]; then
+    break
+  fi
+
+  if [ -n "$INJECTION" ]; then
+    INJECTION="$INJECTION
+---
+$ENTRY"
+  else
+    INJECTION="$ENTRY"
+  fi
+  CHAR_COUNT=$((CHAR_COUNT + ENTRY_LEN))
+done
+
+# SSOT Map Tier 0 injection (always injected regardless of skill match)
+SSOT_MAP="$PROJECT_ROOT/.timsquad/ssot-map.yaml"
+if [ -f "$SSOT_MAP" ]; then
+  # Parse tier-0-always compiled paths from YAML
+  TIER0_PATHS=$(awk '
+    /^tier-0-always:/ { in_tier0=1; next }
+    /^tier-[0-9]/ { in_tier0=0 }
+    in_tier0 && /compiled:/ { gsub(/.*compiled: */, ""); gsub(/^ *| *$/, ""); print }
+  ' "$SSOT_MAP" 2>/dev/null)
+
+  TIER0_CONTENT=""
+  while IFS= read -r REL_PATH; do
+    [ -z "$REL_PATH" ] && continue
+    COMPILED_FILE="$PROJECT_ROOT/.claude/skills/controller/$REL_PATH"
+    if [ -f "$COMPILED_FILE" ]; then
+      FILE_CONTENT=$(cat "$COMPILED_FILE" 2>/dev/null || echo "")
+      if [ -n "$FILE_CONTENT" ]; then
+        if [ -n "$TIER0_CONTENT" ]; then
+          TIER0_CONTENT="$TIER0_CONTENT
+---
+$FILE_CONTENT"
+        else
+          TIER0_CONTENT="$FILE_CONTENT"
+        fi
+      fi
+    fi
+  done <<< "$TIER0_PATHS"
+
+  if [ -n "$TIER0_CONTENT" ]; then
+    if [ -n "$INJECTION" ]; then
+      INJECTION="[SSOT Tier-0 Constraints]
+$TIER0_CONTENT
+---
+$INJECTION"
+    else
+      INJECTION="[SSOT Tier-0 Constraints]
+$TIER0_CONTENT"
+    fi
+  fi
+fi
+
+# Output as systemMessage (mandatory injection)
+if [ -n "$INJECTION" ]; then
+  jq -n --arg msg "$INJECTION" '{
+    hookSpecificOutput: {
+      hookEventName: "UserPromptSubmit",
+      systemMessage: $msg
+    }
+  }'
+fi
+
+exit 0

package/templates/platforms/claude-code/scripts/skill-rules.json

@@ -0,0 +1,95 @@
+{
+  "threshold": 2,
+  "rules": [
+    {
+      "skill": "main-session-constraints",
+      "keywords": ["요구사항", "분석", "계획", "위임", "스프린트", "pm", "관리"],
+      "patterns": ["(plan|analyze|delegate|manage).*?(task|project|sprint)"]
+    },
+    {
+      "skill": "mobile/flutter",
+      "keywords": ["flutter", "widget", "riverpod", "stateless", "stateful", "플러터"],
+      "patterns": ["(build|create|implement|add).*?(app|screen|page|widget)"]
+    },
+    {
+      "skill": "mobile/dart",
+      "keywords": ["dart", "freezed", "isolate"],
+      "patterns": []
+    },
+    {
+      "skill": "frontend/react",
+      "keywords": ["react", "component", "hook", "useState", "useEffect", "리액트", "컴포넌트"],
+      "patterns": ["(create|build|refactor).*?(component|page|layout)"]
+    },
+    {
+      "skill": "frontend/nextjs",
+      "keywords": ["nextjs", "next.js", "app router", "server component", "middleware"],
+      "patterns": ["(ssr|server.*render|static.*generat)"]
+    },
+    {
+      "skill": "backend/node",
+      "keywords": ["express", "fastify", "middleware", "api endpoint", "route"],
+      "patterns": ["(create|add|implement).*?(api|endpoint|route|server)"]
+    },
+    {
+      "skill": "database",
+      "keywords": ["database", "sql", "migration", "schema", "table", "index", "데이터베이스", "스키마"],
+      "patterns": ["(create|modify|add|alter).*?(table|column|index|migration)"]
+    },
+    {
+      "skill": "database/prisma",
+      "keywords": ["prisma", "prisma schema", "prisma migrate"],
+      "patterns": []
+    },
+    {
+      "skill": "methodology/debugging",
+      "keywords": ["debug", "bug", "error", "crash", "fix", "디버그", "버그", "에러"],
+      "patterns": ["(why|how).*?(fail|break|crash|error|not work)"]
+    },
+    {
+      "skill": "methodology/tdd",
+      "keywords": ["tdd", "test-driven", "vitest", "jest", "테스트 주도"],
+      "patterns": ["(write|add|create).*?test"]
+    },
+    {
+      "skill": "methodology/ddd",
+      "keywords": ["ddd", "domain-driven", "aggregate", "bounded context", "도메인 주도"],
+      "patterns": []
+    },
+    {
+      "skill": "security",
+      "keywords": ["security", "owasp", "vulnerability", "xss", "csrf", "injection", "보안", "취약점"],
+      "patterns": ["(security|auth|permission).*?(review|audit|check)"]
+    },
+    {
+      "skill": "testing",
+      "keywords": ["test", "coverage", "assertion", "mock", "stub", "테스트"],
+      "patterns": ["(increase|improve).*?coverage"]
+    },
+    {
+      "skill": "architecture",
+      "keywords": ["architecture", "system design", "api design", "adr", "아키텍처", "설계"],
+      "patterns": ["(design|architect|structure).*?(system|api|service)"]
+    },
+    {
+      "skill": "typescript",
+      "keywords": ["typescript", "type", "interface", "generic", "타입"],
+      "patterns": ["(type|typing).*?(error|issue|strict)"]
+    },
+    {
+      "skill": "ui-design",
+      "keywords": ["ui", "ux", "design system", "responsive", "accessibility", "a11y"],
+      "patterns": ["(design|redesign|improve).*?(ui|layout|interface)"]
+    },
+    {
+      "skill": "planning",
+      "keywords": ["prd", "requirements", "specification", "기획", "요구사항"],
+      "patterns": ["(write|create|draft).*?(prd|spec|requirement)"]
+    },
+    {
+      "skill": "tsq-cli",
+      "keywords": ["tsq", "cli", "커맨드", "init", "status"],
+      "patterns": ["tsq\\s+(init|status|log|wf|mi|audit|knowledge)"]
+    }
+  ]
+}

package/templates/platforms/claude-code/scripts/skill-suggest.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+# Skill Suggest — UserPromptSubmit Hook
+# 사용자 프롬프트를 분석하여 관련 스킬을 제안한다.
+# 키워드/패턴 매칭 기반, advisory only (블로킹 안 함).
+#
+# Input: JSON via stdin (Claude Code hook protocol, .prompt 필드 포함)
+# Output: JSON with additionalContext (스킬 제안)
+
+set -e
+
+# Read hook input
+INPUT=$(cat 2>/dev/null || echo "")
+if [ -z "$INPUT" ]; then
+  exit 0
+fi
+
+PROMPT=$(echo "$INPUT" | jq -r '.prompt // ""' 2>/dev/null || echo "")
+if [ -z "$PROMPT" ] || [ "$PROMPT" = "null" ]; then
+  exit 0
+fi
+
+# 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
+
+# Load skill rules
+RULES_FILE="$PROJECT_ROOT/.claude/scripts/skill-rules.json"
+if [ ! -f "$RULES_FILE" ]; then
+  exit 0
+fi
+
+THRESHOLD=$(jq -r '.threshold // 4' "$RULES_FILE" 2>/dev/null || echo "4")
+PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+
+# Match skills
+MATCHES=""
+RULE_COUNT=$(jq '.rules | length' "$RULES_FILE" 2>/dev/null || echo "0")
+
+i=0
+while [ "$i" -lt "$RULE_COUNT" ]; do
+  SKILL=$(jq -r ".rules[$i].skill" "$RULES_FILE" 2>/dev/null)
+  SCORE=0
+
+  # Check if skill is deployed
+  SKILL_DIR="$PROJECT_ROOT/.claude/skills/$SKILL"
+  if [ ! -d "$SKILL_DIR" ]; then
+    i=$((i + 1))
+    continue
+  fi
+
+  # Keyword matching (2 points each)
+  KW_COUNT=$(jq ".rules[$i].keywords | length" "$RULES_FILE" 2>/dev/null)
+  j=0
+  while [ "$j" -lt "$KW_COUNT" ]; do
+    KW=$(jq -r ".rules[$i].keywords[$j]" "$RULES_FILE" 2>/dev/null)
+    if echo "$PROMPT_LOWER" | grep -qi -- "$KW" 2>/dev/null; then
+      SCORE=$((SCORE + 2))
+    fi
+    j=$((j + 1))
+  done
+
+  # Pattern matching (4 points each)
+  PAT_COUNT=$(jq ".rules[$i].patterns | length" "$RULES_FILE" 2>/dev/null)
+  k=0
+  while [ "$k" -lt "$PAT_COUNT" ]; do
+    PAT=$(jq -r ".rules[$i].patterns[$k]" "$RULES_FILE" 2>/dev/null)
+    if [ -n "$PAT" ] && echo "$PROMPT_LOWER" | grep -qiE -- "$PAT" 2>/dev/null; then
+      SCORE=$((SCORE + 4))
+    fi
+    k=$((k + 1))
+  done
+
+  # Threshold check
+  if [ "$SCORE" -ge "$THRESHOLD" ]; then
+    if [ -n "$MATCHES" ]; then
+      MATCHES="$MATCHES, $SKILL"
+    else
+      MATCHES="$SKILL"
+    fi
+  fi
+
+  i=$((i + 1))
+done
+
+# Output suggestion if matches found
+if [ -n "$MATCHES" ]; then
+  SUGGESTION="[Skill Suggest] 관련 스킬이 감지되었습니다: $MATCHES. 해당 스킬의 rules/를 참조하면 더 높은 품질의 결과를 얻을 수 있습니다."
+  jq -n --arg ctx "$SUGGESTION" '{
+    hookSpecificOutput: {
+      hookEventName: "UserPromptSubmit",
+      additionalContext: $ctx
+    }
+  }'
+fi
+
+exit 0

package/templates/platforms/claude-code/scripts/subagent-inject.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Subagent Inject — SubagentStart Hook
+# 서브에이전트 시작 시 tsq-protocol 핵심 내용을 자동 주입한다.
+#
+# 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
+
+# Load tsq-protocol Contract + Protocol sections
+PROTOCOL_FILE="$PROJECT_ROOT/.claude/skills/tsq-protocol/SKILL.md"
+if [ ! -f "$PROTOCOL_FILE" ]; then
+  exit 0
+fi
+
+# Extract Contract + Quick Rules (compact, max 1000 chars)
+SECTIONS=$(awk '
+  /^## Contract/ { capture=1; next }
+  /^## Quick Rules/ { capture=1; next }
+  /^## / { capture=0 }
+  capture { print }
+' "$PROTOCOL_FILE" 2>/dev/null | head -30)
+
+if [ -z "$SECTIONS" ]; then
+  exit 0
+fi
+
+INJECTION="[TSQ Protocol - Subagent] $SECTIONS"
+
+# Trim to 1000 chars max
+INJECTION="${INJECTION:0:1000}"
+
+jq -n --arg msg "$INJECTION" '{
+  hookSpecificOutput: {
+    hookEventName: "SubagentStart",
+    systemMessage: $msg
+  }
+}'
+
+exit 0

package/templates/platforms/claude-code/settings.json

@@ -1,24 +1,44 @@
 {
   "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/skill-inject.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "Write|Edit",
         "hooks": [
           {
             "type": "command",
-            "command": "bash .claude/scripts/phase-guard.sh 2>/dev/null || true",
+            "command": "bash .claude/scripts/phase-guard.sh",
             "timeout": 3
           }
         ]
-      }
-    ],
-    "SessionStart": [
+      },
       {
+        "matcher": "Bash",
         "hooks": [
           {
             "type": "command",
-            "command": "tsq daemon start 2>/dev/null || true",
-            "timeout": 5
+            "command": "bash .claude/scripts/safe-guard.sh",
+            "timeout": 3
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "tsq daemon notify subagent-start 2>/dev/null || true",
+            "timeout": 3
           }
         ]
       }
@@ -30,6 +50,11 @@
             "type": "command",
             "command": "tsq daemon notify subagent-start 2>/dev/null || true",
             "timeout": 3
+          },
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/subagent-inject.sh",
+            "timeout": 5
           }
         ]
       }
@@ -40,6 +65,27 @@
           {
             "type": "command",
             "command": "tsq daemon notify subagent-stop 2>/dev/null || true",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "tsq daemon start 2>/dev/null || true",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/context-restore.sh",
             "timeout": 5
           }
         ]
@@ -77,7 +123,23 @@
           },
           {
             "type": "command",
-            "command": "bash .claude/scripts/completion-guard.sh 2>/dev/null || true",
+            "command": "bash .claude/scripts/completion-guard.sh",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/build-gate.sh",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/scripts/pre-compact.sh",
             "timeout": 5
           }
         ]
@@ -88,8 +150,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "tsq daemon notify session-end 2>/dev/null || true && tsq daemon stop 2>/dev/null || true",
-            "timeout": 15
+            "command": "tsq daemon notify session-end 2>/dev/null || true",
+            "timeout": 5
           }
         ]
       }