timsquad 2.0.0

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

@@ -0,0 +1,341 @@
+#!/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/common/timsquad/feedback/routing-rules.yaml

@@ -0,0 +1,352 @@
+# 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}}
+      담당: @tsq-planner (architect)
+      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