timsquad 3.6.0 → 3.7.1

package/templates/base/skills/tsq-cli/SKILL.md

@@ -1,73 +0,0 @@
----
-name: tsq-cli
-description: |
-  TimSquad CLI(tsq) 사용 가이드. 모든 TSQ 커맨드의 인덱스와 사용법을 제공한다.
-  에이전트가 TSQ CLI 커맨드를 사용해야 할 때 이 스킬을 참조한다.
-  상세 커맨드 레퍼런스는 references/cli-reference.md 참조.
-version: "1.0.0"
-tags: [tsq, cli, commands, reference]
-depends_on: [tsq-protocol]
-conflicts_with: []
-user-invocable: false
----
-
-# TSQ CLI Reference
-
-TimSquad CLI 커맨드 인덱스. 상세 옵션은 `references/cli-reference.md` 참조.
-
-## Core Commands
-
-| Command | Description |
-|---------|-------------|
-| `tsq init` | 프로젝트 초기화 |
-| `tsq status` | 현재 상태 확인 |
-| `tsq q "task"` | Quick 모드 (간단한 작업) |
-| `tsq f "task"` | Full 모드 (SSOT 기반) |
-| `tsq retro` | 회고 실행 |
-| `tsq metrics` | 메트릭 확인 |
-
-## Meta Index
-
-| Command | Description |
-|---------|-------------|
-| `tsq mi rebuild` | 전체 코드+UI 인덱스 재구축 |
-| `tsq mi update` | 변경분만 반영 |
-| `tsq mi stats` | 통계 (Health Score) |
-| `tsq mi stage <file>` | semantic 데이터 추가 |
-| `tsq mi query` | 인덱스 조회 |
-| `tsq mi validate` | semantic 완성도 검증 |
-
-## Log System
-
-| Command | Description |
-|---------|-------------|
-| `tsq log add <agent> <type> "msg"` | 로그 추가 |
-| `tsq log enrich <agent> --json` | semantic 데이터 병합 |
-| `tsq log task list` | L1 태스크 로그 목록 |
-| `tsq log sequence create` | L2 시퀀스 로그 생성 |
-| `tsq log phase create` | L3 페이즈 로그 생성 |
-| `tsq log phase gate <id>` | L3 전환 게이트 |
-
-## Workflow
-
-| Command | Description |
-|---------|-------------|
-| `tsq wf set-phase <id>` | 현재 Phase 설정 |
-| `tsq wf add-sequence <id>` | 시퀀스 등록 |
-| `tsq wf status` | 워크플로우 상태 |
-| `tsq wf config <key> <on\|off>` | 자동화 토글 |
-
-## Knowledge & Audit
-
-| Command | Description |
-|---------|-------------|
-| `tsq knowledge validate` | 지식 파일 검증 |
-| `tsq knowledge list` | 지식 파일 목록 |
-| `tsq audit validate` | 감사 리포트 검증 |
-| `tsq audit diff` | 감사 전후 비교 |
-
-## Resources
-
-| Priority | Type | Resource | Description |
-|----------|------|----------|-------------|
-| HIGH | ref | [cli-reference](references/cli-reference.md) | 전체 커맨드 상세 옵션 |

package/templates/base/skills/tsq-cli/references/cli-reference.md

@@ -1,92 +0,0 @@
----
-title: TSQ CLI Full Reference
-category: reference
----
-
-# TSQ CLI Full Reference
-
-## tsq init
-```bash
-tsq init --type web-service   # 프로젝트 초기화
-tsq init -n my-project -t web-app -l 2 --domain general-web
-tsq init --stack react,node,prisma --workspaces "packages/*"
-tsq init -y                   # 대화형 프롬프트 스킵
-```
-
-Options:
-- `-n, --name <name>` — 프로젝트명
-- `-t, --type <type>` — web-service|web-app|api-backend|platform|fintech|infra|mobile-app
-- `-l, --level <level>` — 1(MVP)|2(Standard)|3(Enterprise)
-- `--domain <domain>` — general-web|ml-engineering|fintech|mobile|gamedev|systems
-- `--stack <items>` — 기술 스택 (콤마 구분)
-- `--workspaces <pattern>` — 모노레포 워크스페이스 glob
-- `-y, --yes` — 확인 프롬프트 스킵
-
-## tsq status
-```bash
-tsq status                    # 프로젝트 상태 확인
-```
-
-## tsq q / tsq f
-```bash
-tsq q "버튼 색상 변경"          # Quick 모드 — 간단한 작업
-tsq f "새 기능 추가"            # Full 모드 — SSOT 기반 작업
-```
-
-## Meta Index (tsq mi)
-```bash
-tsq mi rebuild                # 전체 코드+UI 인덱스 재구축
-tsq mi update                 # 변경분만 반영
-tsq mi stats                  # 통계 (Health Score, UI Health)
-tsq mi stage <file> [options] # semantic 데이터 추가
-tsq mi query [options]        # 인덱스 조회
-tsq mi validate               # semantic 완성도 검증
-```
-
-## Log (L1/L2/L3)
-```bash
-tsq log add <agent> work "msg"         # 작업 로그 추가
-tsq log add <agent> decision "msg"     # 결정 로그 추가
-tsq log enrich <agent> --json '{...}'  # semantic 데이터 병합
-tsq log task list [--agent <name>]     # L1 태스크 로그 목록
-tsq log task view <file>               # L1 태스크 로그 상세
-tsq log task stats                     # L1 통계
-tsq log sequence create <seq-id> --phase <id> --report <path>  # L2 생성
-tsq log sequence list                  # L2 목록
-tsq log sequence check <seq-id>        # L1 완성도 확인
-tsq log phase create <phase-id> --sequences "..."  # L3 생성
-tsq log phase gate <phase-id>          # L3 전환 게이트
-```
-
-## Knowledge
-```bash
-tsq knowledge create <category> <name> # 지식 파일 생성
-tsq knowledge validate                 # 지식 파일 검증
-tsq knowledge list                     # 지식 파일 목록
-```
-
-## Workflow (tsq wf)
-```bash
-tsq wf set-phase <phase-id>                           # Phase 설정
-tsq wf add-sequence <seq-id> --agents "developer,dba"  # 시퀀스 등록
-tsq wf remove-sequence <seq-id>                        # 시퀀스 제거
-tsq wf status                                          # 상태 확인
-tsq wf config <key> <on|off>                           # 자동화 토글
-# keys: sequence_log, phase_log, phase_gate, metrics, retro
-```
-
-## Audit
-```bash
-tsq audit validate <report>            # 감사 리포트 검증
-tsq audit diff <before> <after>        # 감사 전후 비교
-tsq audit fp list                      # FP Registry 목록
-tsq audit fp add <item> --reason "msg" # FP 등록
-```
-
-## Other
-```bash
-tsq feedback "이슈 설명"               # 피드백 제출
-tsq commit -m "메시지"                 # 커밋 (developer/dba만)
-tsq retro                              # 회고 실행
-tsq metrics                            # 메트릭 확인
-```

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"