timsquad 3.6.0 → 3.7.1

package/templates/base/timsquad/feedback/routing-rules.yaml

@@ -1,352 +0,0 @@
-# TimSquad Feedback Routing Rules
-# 피드백을 적절한 담당자에게 자동 라우팅하는 규칙 정의
-#
-# 이론적 기반:
-# - FRAME (Feedback-Driven Refinement): 레벨별 피드백 분류
-# - Agentsway: Agent specialization에 따른 라우팅
-#
-# 사용법:
-# 1. 피드백 발생 시 triggers 매칭
-# 2. 매칭된 레벨의 route_to로 전달
-# 3. 필요 시 사용자 승인 요청
-
-version: "1.0"
-
-# ============================================================
-# 피드백 레벨 정의
-# ============================================================
-levels:
-  level_1:
-    name: "구현 수정"
-    description: "코드 레벨 수정, 설계 변경 없음"
-    approval_required: false
-    ssot_update: false
-
-  level_2:
-    name: "설계 수정"
-    description: "아키텍처/API 설계 변경 필요"
-    approval_required: false
-    ssot_update: true
-
-  level_3:
-    name: "기획 수정"
-    description: "요구사항/기획 변경 필요, 사용자 승인 필수"
-    approval_required: true
-    ssot_update: true
-
-# ============================================================
-# 라우팅 규칙
-# ============================================================
-routing:
-  # --------------------------------------------------------
-  # Level 1: 구현 수정 → Developer
-  # --------------------------------------------------------
-  level_1:
-    triggers:
-      # 테스트 관련
-      - pattern: "test_failure"
-        keywords: ["test failed", "assertion error", "expected", "actual"]
-
-      - pattern: "test_coverage"
-        keywords: ["coverage below", "uncovered lines", "missing tests"]
-
-      # 코드 품질
-      - pattern: "lint_error"
-        keywords: ["eslint", "prettier", "formatting", "lint error"]
-
-      - pattern: "type_error"
-        keywords: ["type error", "typescript", "cannot assign", "is not assignable"]
-
-      - pattern: "runtime_error"
-        keywords: ["runtime error", "exception", "crash", "undefined is not"]
-
-      # 코드 스타일
-      - pattern: "code_style"
-        keywords: ["naming convention", "code style", "formatting issue"]
-
-      - pattern: "code_smell"
-        keywords: ["code smell", "duplicate code", "long method", "complex"]
-
-      # 성능 (minor)
-      - pattern: "minor_performance"
-        keywords: ["slow query", "n+1", "unnecessary loop"]
-
-    route_to: "tsq-developer"
-
-    actions:
-      - type: "auto_fix"
-        enabled: true
-        max_attempts: 3
-
-      - type: "log"
-        destination: ".timsquad/logs/"
-
-    escalation:
-      condition: "attempts >= 3"
-      escalate_to: "level_2"
-      notify: ["tsq-planner"]
-
-  # --------------------------------------------------------
-  # Level 2: 설계 수정 → Planner (Architect 모드)
-  # --------------------------------------------------------
-  level_2:
-    triggers:
-      # 아키텍처 관련
-      - pattern: "architecture_issue"
-        keywords: ["architecture", "design pattern", "dependency", "coupling"]
-
-      - pattern: "api_mismatch"
-        keywords: ["api mismatch", "contract violation", "interface change"]
-
-      - pattern: "schema_mismatch"
-        keywords: ["schema mismatch", "migration needed", "db change"]
-
-      # 성능 (major)
-      - pattern: "performance_issue"
-        keywords: ["performance degradation", "timeout", "memory leak", "bottleneck"]
-
-      - pattern: "scalability_concern"
-        keywords: ["scalability", "load handling", "concurrent users"]
-
-      # 보안 (implementation level)
-      - pattern: "security_vulnerability"
-        keywords: ["vulnerability", "security issue", "injection", "xss", "csrf"]
-
-      # 통합 문제
-      - pattern: "integration_issue"
-        keywords: ["integration failed", "external api", "third party"]
-
-      # SSOT 불일치
-      - pattern: "ssot_violation"
-        keywords: ["ssot mismatch", "spec violation", "documentation outdated"]
-
-    route_to: "tsq-planner"
-    planner_mode: "architect"
-
-    actions:
-      - type: "analyze"
-        agent: "tsq-planner"
-
-      - type: "update_ssot"
-        documents: ["service-spec.md", "data-design.md", "error-codes.md"]
-
-      - type: "create_adr"
-        enabled: true
-        template: "ADR-000-template.md"
-
-      - type: "log"
-        destination: ".timsquad/logs/"
-
-    escalation:
-      condition: "impact >= high OR user_facing == true"
-      escalate_to: "level_3"
-      notify: ["user"]
-
-  # --------------------------------------------------------
-  # Level 3: 기획 수정 → User 승인 필요
-  # --------------------------------------------------------
-  level_3:
-    triggers:
-      # 요구사항 관련
-      - pattern: "requirement_ambiguity"
-        keywords: ["unclear requirement", "ambiguous", "need clarification"]
-
-      - pattern: "requirement_change"
-        keywords: ["requirement change", "scope change", "new feature"]
-
-      - pattern: "scope_creep"
-        keywords: ["scope creep", "out of scope", "additional feature"]
-
-      # 비즈니스 로직
-      - pattern: "business_logic_error"
-        keywords: ["business logic", "business rule", "domain error"]
-
-      - pattern: "stakeholder_feedback"
-        keywords: ["stakeholder", "client feedback", "user feedback"]
-
-      # 우선순위/일정
-      - pattern: "priority_change"
-        keywords: ["priority change", "timeline", "deadline", "milestone"]
-
-      # 기술 결정
-      - pattern: "technology_decision"
-        keywords: ["technology choice", "framework", "library selection"]
-
-      # 비용/리소스
-      - pattern: "resource_constraint"
-        keywords: ["budget", "resource", "cost", "infrastructure"]
-
-    route_to: "tsq-planner"
-    planner_mode: "planning"
-
-    actions:
-      - type: "notify_user"
-        priority: "high"
-
-      - type: "prepare_summary"
-        include: ["impact", "options", "recommendation"]
-
-      - type: "await_approval"
-        timeout: "24h"
-        reminder: "4h"
-
-      - type: "update_ssot"
-        documents: ["prd.md", "requirements.md", "planning.md"]
-        requires_approval: true
-
-      - type: "log"
-        destination: ".timsquad/logs/"
-
-    approval_flow:
-      - step: "present_options"
-        agent: "tsq-planner"
-
-      - step: "user_decision"
-        timeout: "24h"
-
-      - step: "apply_changes"
-        condition: "approved == true"
-
-      - step: "cascade_updates"
-        documents: ["affected_ssot_documents"]
-
-# ============================================================
-# 키워드 기반 자동 분류
-# ============================================================
-classification:
-  # 자동 분류 활성화
-  auto_classify: true
-
-  # 신뢰도 임계값 (0-1)
-  confidence_threshold: 0.7
-
-  # 낮은 신뢰도 시 동작
-  low_confidence_action: "ask_user"
-
-  # 분류 우선순위 (높은 레벨 우선)
-  priority: ["level_3", "level_2", "level_1"]
-
-  # 복합 패턴 처리
-  compound_patterns:
-    - patterns: ["security_vulnerability", "architecture_issue"]
-      result_level: "level_2"
-      priority: "critical"
-
-    - patterns: ["requirement_change", "scope_creep"]
-      result_level: "level_3"
-      priority: "high"
-
-# ============================================================
-# 에스컬레이션 규칙
-# ============================================================
-escalation:
-  # 시간 기반 에스컬레이션
-  time_based:
-    level_1:
-      timeout: "2h"
-      escalate_to: "level_2"
-
-    level_2:
-      timeout: "8h"
-      escalate_to: "level_3"
-
-  # 반복 기반 에스컬레이션
-  recurrence_based:
-    threshold: 3
-    window: "7d"
-    action: "escalate_and_create_pattern"
-
-  # 심각도 기반 에스컬레이션
-  severity_based:
-    critical:
-      immediate_escalate_to: "level_3"
-      notify: ["user", "tsq-planner"]
-
-    high:
-      escalate_after: "1h"
-
-    medium:
-      follow_normal_flow: true
-
-    low:
-      batch_process: true
-      batch_interval: "4h"
-
-# ============================================================
-# 알림 설정
-# ============================================================
-notifications:
-  channels:
-    # 콘솔 출력
-    console:
-      enabled: true
-      levels: ["level_1", "level_2", "level_3"]
-
-    # 로그 파일
-    log_file:
-      enabled: true
-      path: ".timsquad/logs/feedback.log"
-
-    # 사용자 프롬프트
-    user_prompt:
-      enabled: true
-      levels: ["level_3"]
-
-  templates:
-    level_1: |
-      [Level 1] 구현 수정 필요
-      패턴: {{pattern}}
-      대상: {{target_file}}
-      담당: @tsq-developer
-
-    level_2: |
-      [Level 2] 설계 수정 필요
-      패턴: {{pattern}}
-      영향: {{impact}}
-      담당: 메인세션(PM) - SSOT 직접 수정
-      SSOT 업데이트 필요
-
-    level_3: |
-      [Level 3] 기획 검토 필요 - 사용자 승인 대기
-      패턴: {{pattern}}
-      영향: {{impact}}
-      옵션: {{options}}
-
-      승인 대기 중...
-
-# ============================================================
-# 메트릭 수집
-# ============================================================
-metrics:
-  collect:
-    - feedback_count_by_level
-    - feedback_count_by_pattern
-    - resolution_time
-    - escalation_rate
-    - recurrence_rate
-
-  storage: ".timsquad/retrospective/metrics/feedback-stats.json"
-
-  aggregation:
-    interval: "daily"
-    retention: "90d"
-
-# ============================================================
-# 학습/개선
-# ============================================================
-learning:
-  # 패턴 자동 등록
-  auto_pattern_registration:
-    enabled: true
-    threshold: 3  # 3회 이상 반복 시
-
-  # 회고 시스템 연동
-  retrospective_integration:
-    enabled: true
-    report_to: ".timsquad/retrospective/patterns/"
-
-  # 라우팅 규칙 개선 제안
-  rule_improvement:
-    enabled: true
-    suggest_new_keywords: true
-    suggest_threshold_adjustments: true

package/templates/platforms/claude-code/CLAUDE.md.template

@@ -1,89 +0,0 @@
-# {{PROJECT_NAME}}
-
-> TimSquad v3.1으로 관리되는 프로젝트입니다.
-
-<timsquad-initialization>
-  이 프로젝트는 TimSquad 프레임워크를 사용합니다.
-  `.timsquad/` 디렉토리가 없으면 진행을 중단하고 사용자에게 알리세요:
-  "TimSquad 프로젝트가 초기화되지 않았습니다. `tsq init --type {{PROJECT_TYPE}}`을 실행하세요."
-</timsquad-initialization>
-
-## 역할: Project Manager
-
-당신은 이 프로젝트의 PM입니다. 사용자와 직접 소통하며, 작업을 분류하여 서브에이전트에 위임합니다.
-
-### 핵심 책임
-1. **요구사항 수집** — 사용자와 소통, 진행 보고, 승인 요청
-2. **작업 위임** — 적절한 서브에이전트에게 배분
-3. **기획** — 최초 기획 + 변경 시 (`skills/planning/` 활용)
-4. **리뷰** — architect 보고서 기반 시퀀스 검토
-5. **SSOT 관리** — 문서 일관성과 최신성 유지
-6. **피드백 라우팅** — L1/L2/L3 분류 후 적절한 담당자 전달
-
-### 활성 서브에이전트
-
-{{ACTIVE_AGENTS}}
-
----
-
-## 필수 참조 파일
-
-작업 전 반드시 확인:
-- `.timsquad/config.yaml` — 프로젝트 설정
-- `.timsquad/state/current-phase.json` — 현재 Phase
-- `.timsquad/state/workspace.xml` — 실시간 작업 상태
-- `.timsquad/ssot/` — SSOT 문서들
-- `.claude/knowledge/` — 참조 지식
-
-## 서브에이전트 위임 규칙
-
-<rules>
-  <must>서브에이전트 위임은 controller skill의 프로세스를 따를 것</must>
-  <must>위임 전 해당 에이전트의 prerequisites가 compiled spec으로 존재하는지 확인</must>
-  <must>compiled spec의 stale 여부를 .compile-manifest.json으로 확인</must>
-  <must-not>controller 우회하여 Task() 직접 호출</must-not>
-  <must-not>compiled spec 없이 서브에이전트 실행</must-not>
-</rules>
-
-{{DELEGATION_RULES}}
-
----
-
-## 작업 모드 분류
-
-<task-classification>
-  사용자가 `tsq f` 또는 `tsq q` 없이 직접 작업을 지시하면, 실행 전에 반드시 모드를 분류한다.
-
-  <quick-indicators>CSS, 스타일, 오타, typo, 색상, 텍스트, 변수명, 간단한 버그, 1-2줄 수정</quick-indicators>
-  <full-indicators>새 기능, API, DB, 구조 변경, 인증, 아키텍처, 리팩토링, 여러 파일 수정</full-indicators>
-
-  <rules>
-    <must>Full로 판단되면 사용자에게 확인 후 진행:
-      "이 작업은 Full 모드로 진행합니다 (SSOT 검증 + controller 경유). 진행할까요?"</must>
-    <must>Quick으로 판단되면 바로 진행하되 모드를 명시:
-      "Quick 모드로 바로 진행합니다."</must>
-    <must>판단이 모호하면 사용자에게 선택지를 제시</must>
-  </rules>
-</task-classification>
-
-## 작업 원칙
-
-1. 요구사항에 여러 해석이 가능하면 조용히 선택하지 말고 **선택지를 제시**하라
-2. 구현 전에 **검증 기준**(테스트 or 확인 방법)을 먼저 명시하라
-
-## 금지 사항
-
-- SSOT 문서 없이 구현 시작 금지
-- User 승인 없이 Level 3 변경 금지
-- 에이전트 간 직접 통신 금지 (모든 조율은 PM 통해)
-- 로그 기록 없이 작업 완료 선언 금지
-- Phase 전환 조건 미충족 시 다음 Phase 진행 금지
-
-## 상세 규칙
-
-Phase 관리, 시퀀스 관리, workspace 동기화, 피드백 라우팅, ADR, 보고 형식 등
-상세 규칙은 `.claude/rules/`에 정의되어 있습니다. 관련 작업 시 자동 로드됩니다.
-
----
-
-**타입**: {{PROJECT_TYPE}} | **레벨**: {{PROJECT_LEVEL}} | **초기화**: {{INIT_DATE}}

package/templates/platforms/claude-code/rules/skill-suggest.md

@@ -1,27 +0,0 @@
----
-description: 런타임 스킬 제안. 프롬프트 분석 후 관련 스킬 자동 추천.
-globs:
-  - "**/*"
----
-
-# 런타임 스킬 제안 (Skill Suggest)
-
-## 자동 감지
-
-매 프롬프트 제출 시 `[Skill Suggest]` 메시지가 주입될 수 있습니다.
-- 사용자 프롬프트의 키워드/패턴을 분석하여 관련 스킬 추천
-- 배포된 스킬만 추천 (프로젝트에 없는 스킬은 무시)
-
-## 제안 수신 시 대응
-
-`[Skill Suggest] 관련 스킬이 감지되었습니다: ...` 메시지를 받으면:
-1. 추천된 스킬의 `rules/` 디렉토리를 확인하세요
-2. 현재 태스크에 관련된 규칙을 참조하여 품질을 높이세요
-3. 스킬이 현재 작업과 무관하면 무시해도 됩니다
-
-## 스킬 규칙 위치
-
-배포된 스킬: `.claude/skills/{skill-name}/`
-- `SKILL.md` — 스킬 개요
-- `rules/` — 구체적 규칙 (on-demand 참조)
-- `references/` — 참고 자료

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

@@ -1,216 +0,0 @@
-#!/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