timsquad 3.5.0 → 3.7.0

package/templates/base/timsquad/feedback/feedback-router.sh

@@ -1,341 +0,0 @@
-#!/bin/bash
-
-# TimSquad Feedback Router v1.0
-# 피드백을 분석하고 적절한 담당자에게 라우팅
-#
-# 사용법:
-#   tsq feedback <message>
-#   echo "error message" | tsq feedback
-#   tsq feedback --analyze <file>
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# 색상 정의
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-# TimSquad 루트 찾기
-find_timsquad_root() {
-    local dir="$PWD"
-    while [[ "$dir" != "/" ]]; do
-        if [[ -d "$dir/.timsquad" ]]; then
-            echo "$dir"
-            return 0
-        fi
-        dir="$(dirname "$dir")"
-    done
-    return 1
-}
-
-# 도움말
-show_help() {
-    echo "사용법: tsq feedback [options] <message>"
-    echo ""
-    echo "Options:"
-    echo "  -l, --level <1|2|3>    피드백 레벨 지정"
-    echo "  -p, --pattern <name>   패턴 이름 지정"
-    echo "  -f, --file <path>      파일에서 피드백 읽기"
-    echo "  --analyze              분석만 수행 (라우팅 안함)"
-    echo "  -h, --help             도움말 표시"
-    echo ""
-    echo "예시:"
-    echo "  tsq feedback \"test failed: expected 1 but got 2\""
-    echo "  tsq feedback -l 2 \"API 인터페이스 변경 필요\""
-    echo "  echo \"error\" | tsq feedback"
-}
-
-# 키워드 기반 레벨 분류
-classify_level() {
-    local message="$1"
-    local msg_lower=$(echo "$message" | tr '[:upper:]' '[:lower:]')
-
-    # Level 3 키워드
-    local level3_keywords=(
-        "requirement" "scope" "stakeholder" "business logic"
-        "priority" "deadline" "budget" "feature request"
-        "clarification needed" "user feedback" "client"
-    )
-
-    # Level 2 키워드
-    local level2_keywords=(
-        "architecture" "design" "api mismatch" "schema"
-        "performance" "scalability" "security" "integration"
-        "ssot" "spec violation" "migration"
-    )
-
-    # Level 1 키워드
-    local level1_keywords=(
-        "test" "lint" "type error" "runtime" "exception"
-        "formatting" "code style" "naming" "coverage"
-        "bug" "fix" "typo"
-    )
-
-    # Level 3 체크
-    for keyword in "${level3_keywords[@]}"; do
-        if [[ "$msg_lower" == *"$keyword"* ]]; then
-            echo "3"
-            return
-        fi
-    done
-
-    # Level 2 체크
-    for keyword in "${level2_keywords[@]}"; do
-        if [[ "$msg_lower" == *"$keyword"* ]]; then
-            echo "2"
-            return
-        fi
-    done
-
-    # Level 1 체크
-    for keyword in "${level1_keywords[@]}"; do
-        if [[ "$msg_lower" == *"$keyword"* ]]; then
-            echo "1"
-            return
-        fi
-    done
-
-    # 기본값
-    echo "1"
-}
-
-# 패턴 감지
-detect_pattern() {
-    local message="$1"
-    local msg_lower=$(echo "$message" | tr '[:upper:]' '[:lower:]')
-
-    # 패턴 매핑
-    if [[ "$msg_lower" == *"test"*"fail"* ]]; then
-        echo "test_failure"
-    elif [[ "$msg_lower" == *"lint"* || "$msg_lower" == *"eslint"* ]]; then
-        echo "lint_error"
-    elif [[ "$msg_lower" == *"type"*"error"* || "$msg_lower" == *"typescript"* ]]; then
-        echo "type_error"
-    elif [[ "$msg_lower" == *"runtime"* || "$msg_lower" == *"exception"* ]]; then
-        echo "runtime_error"
-    elif [[ "$msg_lower" == *"api"*"mismatch"* || "$msg_lower" == *"contract"* ]]; then
-        echo "api_mismatch"
-    elif [[ "$msg_lower" == *"schema"* || "$msg_lower" == *"migration"* ]]; then
-        echo "schema_mismatch"
-    elif [[ "$msg_lower" == *"security"* || "$msg_lower" == *"vulnerab"* ]]; then
-        echo "security_vulnerability"
-    elif [[ "$msg_lower" == *"requirement"* ]]; then
-        echo "requirement_change"
-    elif [[ "$msg_lower" == *"scope"* ]]; then
-        echo "scope_creep"
-    elif [[ "$msg_lower" == *"performance"* || "$msg_lower" == *"slow"* ]]; then
-        echo "performance_issue"
-    else
-        echo "general"
-    fi
-}
-
-# 라우팅 대상 결정
-get_route_target() {
-    local level="$1"
-
-    case $level in
-        1)
-            echo "tsq-developer"
-            ;;
-        2)
-            echo "tsq-planner (architect mode)"
-            ;;
-        3)
-            echo "tsq-planner (planning mode) → User 승인 필요"
-            ;;
-        *)
-            echo "tsq-developer"
-            ;;
-    esac
-}
-
-# 피드백 로그 저장
-log_feedback() {
-    local level="$1"
-    local pattern="$2"
-    local message="$3"
-    local target="$4"
-
-    local log_dir="$TSQ_ROOT/.timsquad/logs"
-    local log_file="$log_dir/feedback.log"
-    local timestamp=$(date +"%Y-%m-%d %H:%M:%S")
-
-    mkdir -p "$log_dir"
-
-    cat >> "$log_file" << EOF
-
----
-timestamp: $timestamp
-level: $level
-pattern: $pattern
-target: $target
-message: |
-  $message
----
-EOF
-}
-
-# 메트릭 업데이트
-update_metrics() {
-    local level="$1"
-    local pattern="$2"
-
-    local metrics_file="$TSQ_ROOT/.timsquad/retrospective/metrics/feedback-stats.json"
-
-    # 파일이 없으면 초기화
-    if [[ ! -f "$metrics_file" ]]; then
-        mkdir -p "$(dirname "$metrics_file")"
-        echo '{"by_level":{"1":0,"2":0,"3":0},"by_pattern":{},"total":0}' > "$metrics_file"
-    fi
-
-    # jq가 있으면 JSON 업데이트
-    if command -v jq &> /dev/null; then
-        local tmp_file=$(mktemp)
-        jq --arg level "$level" --arg pattern "$pattern" '
-            .total += 1 |
-            .by_level[$level] += 1 |
-            .by_pattern[$pattern] = ((.by_pattern[$pattern] // 0) + 1)
-        ' "$metrics_file" > "$tmp_file" && mv "$tmp_file" "$metrics_file"
-    fi
-}
-
-# 메인 라우팅 함수
-route_feedback() {
-    local level="$1"
-    local pattern="$2"
-    local message="$3"
-    local analyze_only="$4"
-
-    local target=$(get_route_target "$level")
-
-    echo ""
-    echo -e "${CYAN}━━━ 피드백 분석 결과 ━━━${NC}"
-    echo ""
-
-    # 레벨별 색상
-    case $level in
-        1)
-            echo -e "  레벨: ${GREEN}Level 1 (구현 수정)${NC}"
-            ;;
-        2)
-            echo -e "  레벨: ${YELLOW}Level 2 (설계 수정)${NC}"
-            ;;
-        3)
-            echo -e "  레벨: ${RED}Level 3 (기획 수정)${NC}"
-            ;;
-    esac
-
-    echo -e "  패턴: ${BLUE}$pattern${NC}"
-    echo -e "  라우팅: $target"
-    echo ""
-    echo -e "  메시지:"
-    echo -e "  ${GRAY}$message${NC}"
-    echo ""
-
-    if [[ "$analyze_only" == "true" ]]; then
-        echo -e "${YELLOW}분석 모드: 라우팅 실행하지 않음${NC}"
-        return
-    fi
-
-    # 로그 저장
-    log_feedback "$level" "$pattern" "$message" "$target"
-
-    # 메트릭 업데이트
-    update_metrics "$level" "$pattern"
-
-    # Level 3인 경우 사용자 알림
-    if [[ "$level" == "3" ]]; then
-        echo -e "${RED}⚠ 사용자 승인이 필요합니다${NC}"
-        echo ""
-        echo "다음 내용을 검토해주세요:"
-        echo "  - 영향 범위 분석"
-        echo "  - 대안 옵션"
-        echo "  - SSOT 문서 업데이트 필요 여부"
-        echo ""
-    fi
-
-    echo -e "${GREEN}✓ 피드백이 기록되었습니다${NC}"
-}
-
-# ============================================================
-# 메인 실행
-# ============================================================
-
-# TimSquad 루트 확인
-TSQ_ROOT=$(find_timsquad_root) || {
-    echo -e "${RED}Error: TimSquad 프로젝트가 아닙니다.${NC}"
-    exit 1
-}
-
-# 인자 파싱
-LEVEL=""
-PATTERN=""
-MESSAGE=""
-FILE=""
-ANALYZE_ONLY=false
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        -l|--level)
-            LEVEL="$2"
-            shift 2
-            ;;
-        -p|--pattern)
-            PATTERN="$2"
-            shift 2
-            ;;
-        -f|--file)
-            FILE="$2"
-            shift 2
-            ;;
-        --analyze)
-            ANALYZE_ONLY=true
-            shift
-            ;;
-        -h|--help)
-            show_help
-            exit 0
-            ;;
-        *)
-            MESSAGE="$MESSAGE $1"
-            shift
-            ;;
-    esac
-done
-
-# 파일에서 읽기
-if [[ -n "$FILE" && -f "$FILE" ]]; then
-    MESSAGE=$(cat "$FILE")
-fi
-
-# stdin에서 읽기
-if [[ -z "$MESSAGE" && ! -t 0 ]]; then
-    MESSAGE=$(cat)
-fi
-
-# 메시지 정리
-MESSAGE=$(echo "$MESSAGE" | xargs)
-
-if [[ -z "$MESSAGE" ]]; then
-    echo -e "${RED}Error: 피드백 메시지가 필요합니다${NC}"
-    show_help
-    exit 1
-fi
-
-# 자동 분류 (지정되지 않은 경우)
-if [[ -z "$LEVEL" ]]; then
-    LEVEL=$(classify_level "$MESSAGE")
-fi
-
-if [[ -z "$PATTERN" ]]; then
-    PATTERN=$(detect_pattern "$MESSAGE")
-fi
-
-# 라우팅 실행
-route_feedback "$LEVEL" "$PATTERN" "$MESSAGE" "$ANALYZE_ONLY"

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