timsquad 3.4.0 → 3.6.0

package/templates/base/skills/stability-verification/scripts/verify.sh

@@ -0,0 +1,294 @@
+#!/bin/bash
+# Stability Verification — 6-Layer 자동 검증 오케스트레이터
+#
+# Usage: bash verify.sh [--layer L0-L5] [--skip L0-L5] [--report]
+# Exit: 0=PASS, 1=FAIL
+#
+# 출처: OWASP, ShellCheck Wiki, npm security best practices
+
+set -e
+
+# ── Colors ──
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# ── Args ──
+ONLY_LAYER=""
+SKIP_LAYERS=""
+REPORT_MODE=false
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --layer) ONLY_LAYER="$2"; shift 2 ;;
+    --skip) SKIP_LAYERS="$SKIP_LAYERS $2"; shift 2 ;;
+    --report) REPORT_MODE=true; shift ;;
+    *) shift ;;
+  esac
+done
+
+# ── Helpers ──
+PASS=0
+FAIL=0
+WARN=0
+
+layer_header() {
+  echo -e "\n${CYAN}━━━ $1 ━━━${NC}"
+}
+
+pass() {
+  echo -e "  ${GREEN}✓${NC} $1"
+  PASS=$((PASS + 1))
+}
+
+fail() {
+  echo -e "  ${RED}✗${NC} $1"
+  FAIL=$((FAIL + 1))
+}
+
+warn() {
+  echo -e "  ${YELLOW}!${NC} $1"
+  WARN=$((WARN + 1))
+}
+
+should_run() {
+  local layer="$1"
+  if [ -n "$ONLY_LAYER" ] && [ "$ONLY_LAYER" != "$layer" ]; then
+    return 1
+  fi
+  if echo "$SKIP_LAYERS" | grep -q "$layer"; then
+    return 1
+  fi
+  return 0
+}
+
+# ── Find project root ──
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+  if [ -f "$PROJECT_ROOT/package.json" ]; then break; fi
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+cd "$PROJECT_ROOT"
+
+echo -e "${CYAN}Stability Verification${NC} — $(basename "$PROJECT_ROOT")"
+echo "──────────────────────────────────────"
+
+# ════════════════════════════════════════
+# L0: 정적 분석
+# ════════════════════════════════════════
+if should_run "L0"; then
+  layer_header "L0: 정적 분석 (Syntax/Lint)"
+
+  # tsc --noEmit
+  if [ -f "tsconfig.json" ]; then
+    if npx tsc --noEmit 2>&1 | grep -q "error TS"; then
+      fail "tsc --noEmit — TypeScript 에러 발견"
+    else
+      pass "tsc --noEmit"
+    fi
+  fi
+
+  # shellcheck
+  SH_FILES=$(find . -name '*.sh' -not -path '*/node_modules/*' -not -path '*/.git/*' 2>/dev/null || echo "")
+  if [ -n "$SH_FILES" ] && command -v shellcheck &>/dev/null; then
+    SC_RESULT=$(echo "$SH_FILES" | xargs shellcheck --severity=warning 2>&1 || true)
+    SC_ERRORS=$(echo "$SC_RESULT" | grep -c "^In " 2>/dev/null || echo "0")
+    if [ "$SC_ERRORS" -gt 0 ]; then
+      warn "shellcheck — ${SC_ERRORS}개 파일에서 경고 발견"
+    else
+      pass "shellcheck"
+    fi
+  fi
+
+  # bash -n
+  BASH_FAIL=0
+  for f in $SH_FILES; do
+    bash -n "$f" 2>/dev/null || { BASH_FAIL=$((BASH_FAIL + 1)); }
+  done
+  if [ "$BASH_FAIL" -gt 0 ]; then
+    fail "bash -n — ${BASH_FAIL}개 파일 구문 에러"
+  else
+    pass "bash -n (전체 .sh)"
+  fi
+
+  # JSON validation
+  JSON_FILES=$(find . -name '*.json' -not -path '*/node_modules/*' -not -path '*/.git/*' -not -path '*/dist/*' 2>/dev/null || echo "")
+  JSON_FAIL=0
+  for f in $JSON_FILES; do
+    jq empty < "$f" 2>/dev/null || { JSON_FAIL=$((JSON_FAIL + 1)); }
+  done
+  if [ "$JSON_FAIL" -gt 0 ]; then
+    fail "JSON — ${JSON_FAIL}개 파일 구문 에러"
+  else
+    pass "JSON 유효성 ($(echo "$JSON_FILES" | wc -w | tr -d ' ')개)"
+  fi
+fi
+
+# ════════════════════════════════════════
+# L1: 유닛 테스트
+# ════════════════════════════════════════
+if should_run "L1"; then
+  layer_header "L1: 유닛 테스트"
+
+  TEST_OUTPUT=$(npm run test:unit 2>&1 || true)
+  if echo "$TEST_OUTPUT" | grep -q "passed"; then
+    TEST_COUNT=$(echo "$TEST_OUTPUT" | grep "Tests" | grep -oE '[0-9]+ passed' || echo "? passed")
+    pass "test:unit — $TEST_COUNT"
+  else
+    fail "test:unit — 실패"
+  fi
+fi
+
+# ════════════════════════════════════════
+# L2: 보안 스캔
+# ════════════════════════════════════════
+if should_run "L2"; then
+  layer_header "L2: 보안 스캔"
+
+  # npm audit (production dependencies only — devDeps are warn-only)
+  AUDIT_PROD=$(npm audit --omit=dev 2>&1 || true)
+  if echo "$AUDIT_PROD" | grep -q "found 0 vulnerabilities"; then
+    pass "npm audit (prod)"
+  elif echo "$AUDIT_PROD" | grep -qiE "high|critical"; then
+    fail "npm audit (prod) — high/critical 취약점 발견"
+  else
+    warn "npm audit (prod) — moderate/low 취약점 존재"
+  fi
+
+  # npm audit (dev — warn only, ReDoS in eslint/vitest chain is common)
+  AUDIT_FULL=$(npm audit 2>&1 || true)
+  AUDIT_DEV_COUNT=$(echo "$AUDIT_FULL" | grep -oE '[0-9]+ vulnerabilities' | grep -oE '[0-9]+' || echo "0")
+  if [ "$AUDIT_DEV_COUNT" -gt 0 ] 2>/dev/null; then
+    warn "npm audit (dev) — ${AUDIT_DEV_COUNT}개 취약점 (devDependencies)"
+  fi
+
+  # execSync injection check
+  EXEC_SYNC=$(grep -rn 'execSync(' src/ 2>/dev/null | grep -v 'gh --version' | grep -v '\.test\.' || true)
+  if [ -n "$EXEC_SYNC" ]; then
+    # 변수 보간 확인 (template literal 또는 string concat)
+    INJECTION=$(echo "$EXEC_SYNC" | grep -E '\$\{|` \+' || true)
+    if [ -n "$INJECTION" ]; then
+      fail "execSync 커맨드 인젝션 의심: $(echo "$INJECTION" | wc -l | tr -d ' ')건"
+    else
+      pass "execSync — 변수 보간 없음"
+    fi
+  else
+    pass "execSync — 미사용 또는 상수만 사용"
+  fi
+
+  # eval check
+  EVAL_USAGE=$(grep -rn 'eval ' templates/**/*.sh scripts/**/*.sh 2>/dev/null | grep -v '^\s*#' || true)
+  if [ -n "$EVAL_USAGE" ]; then
+    fail "eval 사용 발견: $(echo "$EVAL_USAGE" | wc -l | tr -d ' ')건"
+  else
+    pass "eval 미사용"
+  fi
+
+  # .gitignore security
+  if [ -f ".gitignore" ]; then
+    MISSING=""
+    grep -q '\.env' .gitignore 2>/dev/null || MISSING="$MISSING .env"
+    grep -q '\*.pem' .gitignore 2>/dev/null || MISSING="$MISSING *.pem"
+    grep -q '\*.key' .gitignore 2>/dev/null || MISSING="$MISSING *.key"
+    if [ -n "$MISSING" ]; then
+      warn ".gitignore 보안 항목 누락:$MISSING"
+    else
+      pass ".gitignore 보안 항목"
+    fi
+  fi
+fi
+
+# ════════════════════════════════════════
+# L3: 쉘 스크립트 테스트
+# ════════════════════════════════════════
+if should_run "L3"; then
+  layer_header "L3: 쉘 스크립트 테스트"
+
+  HOOK_DIR="templates/platforms/claude-code/scripts"
+  if [ -d "$HOOK_DIR" ]; then
+    HOOK_SCRIPTS=$(find "$HOOK_DIR" -name '*.sh' 2>/dev/null || echo "")
+    L3_FAIL=0
+
+    for script in $HOOK_SCRIPTS; do
+      NAME=$(basename "$script" .sh)
+
+      # malformed JSON → fail-open
+      RESULT=$(echo "not json" | bash "$script" 2>/dev/null || true)
+      EXIT=$?
+      if [ $EXIT -ne 0 ]; then
+        fail "$NAME — malformed JSON 시 crash (exit $EXIT)"
+        L3_FAIL=$((L3_FAIL + 1))
+      fi
+
+      # empty stdin → fail-open
+      RESULT=$(echo "" | bash "$script" 2>/dev/null || true)
+      EXIT=$?
+      if [ $EXIT -ne 0 ]; then
+        fail "$NAME — empty stdin 시 crash"
+        L3_FAIL=$((L3_FAIL + 1))
+      fi
+    done
+
+    if [ $L3_FAIL -eq 0 ]; then
+      pass "훅 스크립트 fail-open 검증 ($(echo "$HOOK_SCRIPTS" | wc -w | tr -d ' ')개)"
+    fi
+  else
+    warn "훅 스크립트 디렉토리 없음: $HOOK_DIR"
+  fi
+fi
+
+# ════════════════════════════════════════
+# L5: 패키지 무결성
+# ════════════════════════════════════════
+if should_run "L5"; then
+  layer_header "L5: 패키지 무결성"
+
+  # Build
+  BUILD_OUTPUT=$(npm run build 2>&1 || true)
+  if echo "$BUILD_OUTPUT" | grep -q "error TS"; then
+    fail "npm run build — TypeScript 에러"
+  else
+    pass "npm run build"
+  fi
+
+  # Version
+  if [ -f "bin/tsq.js" ]; then
+    VER=$(node bin/tsq.js --version 2>/dev/null || echo "FAIL")
+    if [ "$VER" != "FAIL" ]; then
+      pass "CLI version: $VER"
+    else
+      fail "CLI version 출력 실패"
+    fi
+  fi
+
+  # npm pack
+  PACK_OUTPUT=$(npm pack --dry-run 2>&1)
+  if echo "$PACK_OUTPUT" | grep -qiE '\.env|\.key.*\.pem|credential'; then
+    fail "npm pack — 민감 파일 포함"
+  else
+    pass "npm pack — 민감 파일 미포함"
+  fi
+
+  # domains/ exclusion
+  if echo "$PACK_OUTPUT" | grep -q "templates/domains/"; then
+    fail "npm pack — templates/domains/ 포함 (유료 콘텐츠)"
+  else
+    pass "npm pack — templates/domains/ 제외"
+  fi
+fi
+
+# ════════════════════════════════════════
+# Summary
+# ════════════════════════════════════════
+echo ""
+echo "──────────────────────────────────────"
+echo -e "  ${GREEN}PASS: $PASS${NC}  ${RED}FAIL: $FAIL${NC}  ${YELLOW}WARN: $WARN${NC}"
+
+if [ $FAIL -gt 0 ]; then
+  echo -e "\n${RED}VERIFICATION FAILED${NC} — $FAIL개 항목 실패"
+  exit 1
+else
+  echo -e "\n${GREEN}VERIFICATION PASSED${NC}"
+  exit 0
+fi

package/templates/base/skills/testing/SKILL.md

@@ -6,6 +6,8 @@ description: |
   Use when: "테스트 작성, TDD, 단위 테스트, 통합 테스트, E2E, 커버리지"
 version: "1.0.0"
 tags: [testing, tdd, quality]
+depends_on: []
+conflicts_with: []
 user-invocable: false
 ---
 
@@ -19,45 +21,51 @@ user-invocable: false
 - 테스트 피라미드: Unit(다수) > Integration(중간) > E2E(소수)
 - 행동(behavior) 테스트 — 구현 디테일이 아닌 결과 검증
 
+## Contract
+
+- **Trigger**: 테스트 작성/수정 태스크, 코드 변경 후 테스트 필요 시
+- **Input**: 테스트 대상 코드 + 요구사항
+- **Output**: Given-When-Then 패턴 테스트 + 커버리지 기준 충족
+- **Error**: 커버리지 미달 시 추가 테스트 작성
+- **Dependencies**: 없음
+
+## Protocol
+
+1. **Red**: 실패하는 테스트 작성
+2. **Green**: 테스트를 통과하는 최소 코드 작성
+3. **Refactor**: 코드 정리 (테스트는 계속 통과)
+4. **Coverage 확인**: 기준 충족 여부 점검
+
+## Verification
+
+| Check | Command | Pass Criteria |
+|-------|---------|---------------|
+| 테스트 실행 | `npm test` | exit code 0 |
+| 라인 커버리지 | coverage report | >= 80% |
+| 브랜치 커버리지 | coverage report | >= 70% |
+| 3카테고리 | 수동 검증 | Happy/Edge/Error 포함 |
+
 ## Resources
 
 | Priority | Type | Resource | Description |
 |----------|------|----------|-------------|
-| HIGH | ref | [testing-patterns](references/testing-patterns.md) | Given-When-Then, Mock 가이드, 카테고리별 예시 |
+| HIGH | ref | [testing-patterns](references/testing-patterns.md) | Given-When-Then, Mock 가이드 |
+| HIGH | ref | [e2e-stability](references/e2e-stability.md) | E2E Viewport, Wait, Retry 가이드 |
 
 ## Quick Rules
 
-### TDD Cycle
-1. **Red** — 실패하는 테스트 작성
-2. **Green** — 테스트를 통과하는 최소 코드 작성
-3. **Refactor** — 코드 정리 (테스트는 계속 통과)
-
 ### Test Naming
 - 형식: `should {expected behavior} when {condition}`
-- Good: `should return null when user is not found`
 - Bad: `test getUser`, `works correctly`
 
 ### Test Categories
-모든 테스트는 3가지 카테고리 커버:
 - **Happy Path** — 정상 흐름
 - **Edge Cases** — 경계 조건 (빈 문자열, 0, null, 최대값)
 - **Error Cases** — 오류 상황
 
 ### Coverage Standards
-
-| Metric | Minimum | Recommended |
-|--------|---------|-------------|
-| Line Coverage | 80% | 90% |
-| Branch Coverage | 70% | 80% |
-| Function Coverage | 80% | 90% |
-
-## Checklist
-
-| Priority | Item |
-|----------|------|
-| CRITICAL | Given-When-Then 패턴을 따르는가 |
-| CRITICAL | Happy path, Edge case, Error case 커버하는가 |
-| HIGH | 테스트 이름이 `should...when...` 형식인가 |
-| HIGH | 커버리지 기준을 충족하는가 |
-| MEDIUM | Mock이 적절히 사용되었는가 (외부 서비스만) |
-| MEDIUM | 테스트가 독립적인가 (순서 무관) |
+| Metric | Min | Recommended |
+|--------|-----|-------------|
+| Line | 80% | 90% |
+| Branch | 70% | 80% |
+| Function | 80% | 90% |

package/templates/base/skills/testing/references/e2e-stability.md

@@ -0,0 +1,33 @@
+---
+title: E2E Stability Guide
+category: reference
+---
+
+# E2E Stability Guide
+
+## Viewport & Selectors
+- 테스트 전 `page.setViewportSize({ width: 1280, height: 720 })` 고정
+- `data-testid` 셀렉터 사용 — CSS 클래스/태그 기반 셀렉터 금지
+- `getByRole`, `getByText` 등 의미 기반 셀렉터 우선
+
+## Serial Execution
+- E2E 테스트는 `describe.serial` 또는 `--shard` 사용
+- 상태 의존 테스트는 반드시 순서 보장 (`test.describe.configure({ mode: 'serial' })`)
+
+## Wait Strategy
+- `waitForSelector` 대신 `waitForLoadState('networkidle')` + assertion
+- 하드코딩 `sleep`/`setTimeout` 절대 사용 금지
+- 동적 콘텐츠: `expect(locator).toBeVisible({ timeout: 10000 })`
+
+## Retry & Flakiness
+- Playwright `retries: 2` 설정 (CI 환경)
+- flaky 테스트 발견 시 `test.fixme()` 마킹 후 원인 분석
+- 재시도 성공도 flaky로 기록 → `.e2e-passed` 마커에 `flaky` 카운트 포함
+
+## Timeout Standards
+
+| Category | Timeout | Rationale |
+|----------|---------|-----------|
+| Unit Test | 120s | 빠른 피드백 |
+| E2E Test | 300s | 네트워크/렌더링 대기 |
+| Build | 180s | 컴파일 + 번들링 |

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

@@ -0,0 +1,73 @@
+---
+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

@@ -0,0 +1,92 @@
+---
+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/skills/tsq-protocol/SKILL.md

@@ -6,46 +6,62 @@ description: |
   자동 주입 스킬 — 직접 호출하지 마세요.
 version: "1.0.0"
 tags: [tsq, protocol, agent]
+depends_on: []
+conflicts_with: []
 user-invocable: false
 ---
 
 # TSQ Agent Protocol
 
-## File Access
-코드 탐색 시 `.timsquad/.daemon/task-context.json`을 **먼저** 확인하세요.
-이 파일에 작업 범위의 파일/메서드/클래스 위치가 정리되어 있습니다.
-context 파일이 없거나 범위 밖 파일이 필요할 때만 Grep/Glob을 사용하세요.
+에이전트가 TimSquad 시스템 내에서 따라야 하는 공통 프로토콜.
 
-## TSQ CLI (Required)
+## Philosophy
 
-모든 로그/피드백/커밋은 TSQ CLI를 통해서만 수행합니다. 직접 파일 조작 금지.
+- TSQ CLI를 통해서만 로그/피드백/커밋 수행
+- task-context.json을 우선 탐색하여 불필요한 탐색 최소화
+- 피드백은 반드시 Level 분류를 명시
 
+## Contract
+
+- **Trigger**: 모든 에이전트 세션 (자동 활성)
+- **Input**: 태스크 지시 + task-context.json
+- **Output**: TSQ 프로세스 준수 작업 결과
+- **Error**: 프로토콜 위반 시 경고 + 수정 안내
+- **Dependencies**: 없음
+
+## Protocol
+
+1. **task-context 확인**: `.timsquad/.daemon/task-context.json` 우선 읽기
+2. **TSQ CLI 사용**: 로그/피드백/커밋 모두 CLI 경유
+3. **피드백 라우팅**: Level 분류 후 적절한 대상에 전달
+
+## Verification
+
+| Check | Command | Pass Criteria |
+|-------|---------|---------------|
+| TSQ CLI 사용 | `tsq log` 사용 여부 | 직접 파일 조작 0건 |
+| 피드백 Level | 피드백 내용 확인 | L1/L2/L3 분류 존재 |
+| task-context | 탐색 순서 확인 | context 우선 사용 |
+
+## Quick Rules
+
+### CLI Commands
 | 이벤트 | 커맨드 |
 |--------|--------|
 | 작업 시작 | `tsq log add {agent} work "TASK-XXX 시작: {설명}"` |
 | 결정 기록 | `tsq log add {agent} decision "{결정 근거}"` |
 | 이슈 발견 | `tsq feedback "{이슈 설명}"` |
 | 작업 완료 | `tsq log add {agent} work "TASK-XXX 완료: {결과}"` |
-| semantic 보강 | `tsq log enrich {agent} --json '{...}'` |
 | 커밋 | `tsq commit -m "{메시지}"` (developer/dba만) |
 
 ### Forbidden
-- 직접 `.timsquad/logs/` 파일 생성/수정 금지 → `tsq log` 사용
-- 직접 `.timsquad/feedback/` 파일 생성 금지 → `tsq feedback` 사용
-- 직접 `git commit` 금지 → `tsq commit` 사용 (해당 역할만)
-
-## Output Format
-작업 결과는 `knowledge/templates/task-result.md` 형식으로 리턴하세요.
-
-## Feedback Routing
-
-| Level | 심각도 | 기준 | 라우팅 |
-|-------|--------|------|--------|
-| L1 | Minor | 즉시 수정 가능 (린트, 타입, 스타일) | 자체 수정 또는 @tsq-developer |
-| L2 | Major | 설계 변경 필요 (API 불일치, 성능 구조) | 메인세션(PM) 보고 |
-| L3 | Critical | 요구사항 오류, 스코프 변경, 데이터 손실 위험 | 메인세션(PM) → 사용자 승인 |
-
-모든 피드백에 Level 분류와 심각도를 반드시 명시하세요.
+- 직접 `.timsquad/logs/` 파일 조작 → `tsq log` 사용
+- 직접 `.timsquad/feedback/` 파일 조작 → `tsq feedback` 사용
+- 직접 `git commit` → `tsq commit` 사용
 
-## Mandatory Skills
-작업 시작 전 에이전트 frontmatter에 지정된 스킬 파일을 반드시 읽고 가이드라인을 준수하세요.
+### Feedback Routing
+| Level | 기준 | 라우팅 |
+|-------|------|--------|
+| L1 | 즉시 수정 가능 (린트, 타입) | 자체 수정 |
+| L2 | 설계 변경 필요 | 메인세션(PM) 보고 |
+| L3 | 요구사항 오류, 스코프 변경 | 메인세션 → 사용자 승인 |

package/templates/base/skills/typescript/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: typescript
-description: TypeScript 개발 가이드라인
+description: |
+  TypeScript 개발 가이드라인. strict 모드, 타입 패턴, Zod 검증, Branded Types.
+  Use when: .ts/.tsx 파일 작성·수정, tsconfig 설정, 타입 안전성 이슈, any 제거, 외부 입력 검증 시.
 version: "1.0.0"
 tags: [typescript, types, strict]
 user-invocable: false
@@ -54,14 +56,6 @@ user-invocable: false
 - `@ts-ignore`, `@ts-expect-error` 남용
 - `!` non-null assertion 남용
 
-## Checklist
-- [ ] strict 모드 활성화
-- [ ] any 타입 없음
-- [ ] 함수 반환 타입 명시
-- [ ] 외부 입력 Zod 검증
-- [ ] Discriminated Union으로 상태 표현
-- [ ] Branded Types로 ID 구분
-
 ## 참조
 - `rules/type-patterns.md` — 각 패턴의 코드 예시
 - `rules/utility-types.md` — DTO 조합, DeepPartial, 타입 안전 API 클라이언트