timsquad 2.1.0 → 3.4.0

package/templates/base/config.template.yaml

@@ -0,0 +1,213 @@
+# TimSquad Project Configuration
+# 이 파일을 .timsquad/config.yaml로 복사하여 사용
+
+# ============================================================
+# 프로젝트 기본 정보
+# ============================================================
+project:
+  name: my-project
+  type: web-service      # web-service | web-app | api-backend | platform | fintech | infra
+  level: 2               # 1=MVP | 2=Standard | 3=Enterprise
+  domain: general-web    # general-web | ml-engineering | fintech | mobile | gamedev | systems
+  platform: claude-code  # claude-code | cursor | windsurf | mcp | gemini (auto-detect)
+  stack: []              # react, nextjs, node, prisma 등 (auto-detect, 선택)
+  description: ""
+
+# ============================================================
+# 개발 방법론
+# ============================================================
+methodology:
+  development: tdd       # tdd | bdd | none
+  process: agile         # agile | waterfall | kanban
+  branching: github-flow # gitflow | trunk-based | github-flow
+  review: required       # required | optional | none
+
+# ============================================================
+# 기술 스택
+# ============================================================
+stack:
+  # 공통
+  language: typescript   # typescript | javascript
+
+  # 프론트엔드
+  frontend:
+    enabled: true
+    framework: nextjs    # nextjs | react | vue | svelte | none
+    state: zustand       # zustand | redux | recoil | context | none
+    styling: tailwind    # tailwind | styled-components | css-modules | none
+    testing: vitest      # vitest | jest | none
+
+  # 백엔드
+  backend:
+    enabled: true
+    runtime: node        # node | python | go | java
+    framework: hono      # hono | express | fastify | nest | none
+    testing: vitest      # vitest | jest | pytest | none
+
+  # 데이터베이스
+  database:
+    primary: postgresql  # postgresql | mysql | mongodb | sqlite
+    orm: prisma          # prisma | typeorm | drizzle | none
+    cache: none          # redis | memcached | none
+
+  # 인프라
+  infrastructure:
+    hosting: vercel      # vercel | aws | gcp | self-hosted
+    container: false     # Docker 사용 여부
+    ci_cd: github        # github | gitlab | none
+
+# ============================================================
+# 에이전트 스킬 설정
+# ============================================================
+# 스킬 구조 (Vercel 패턴):
+#   SKILL.md     = 인덱스 (~100줄, 항상 로드)
+#   rules/       = 개별 패턴 파일 (on-demand 로드)
+# 500줄 초과 스킬은 반드시 SKILL.md(인덱스) + rules/(개별 파일)로 분리
+# 새 스킬 생성 시 _template/ 참조
+skills:
+  # 기본 스킬 (항상 로드)
+  base:
+    - coding
+    - testing
+    - security
+
+  # 방법론에 따라 자동 로드
+  methodology:
+    tdd: [methodology/tdd]
+    bdd: [methodology/bdd]
+
+  # 스택에 따라 자동 로드
+  stack:
+    typescript: [typescript]
+    react: [frontend/react]
+    nextjs: [frontend/nextjs, frontend/react]
+    vue: [frontend/vue]
+    node: [backend/node]
+    python: [backend/python]
+    prisma: [database/prisma]
+    typeorm: [database/typeorm]
+
+# ============================================================
+# 에이전트 설정
+# ============================================================
+# 활성 에이전트는 project.type에 따라 AGENT_PRESETS로 자동 결정:
+#   web-service: architect, developer, designer, qa
+#   api-backend: architect, developer, dba, qa
+#   fintech:     architect, developer, dba, security, qa
+#   web-app:     architect, developer, designer, qa
+#   platform:    architect, developer, qa
+#   infra:       architect, developer, security
+agents:
+  architect:
+    model: opus          # opus | sonnet | haiku
+    enabled: true
+
+  developer:
+    model: sonnet
+    enabled: true
+    # 프론트엔드/백엔드 분리 시
+    # variants:
+    #   frontend:
+    #     skills: [frontend/react, frontend/nextjs]
+    #   backend:
+    #     skills: [backend/node, database/prisma]
+
+  qa:
+    model: sonnet
+    enabled: true
+
+  security:
+    model: sonnet
+    enabled: false       # type에 따라 자동 활성화 (fintech, infra)
+
+  dba:
+    model: sonnet
+    enabled: false       # type에 따라 자동 활성화 (api-backend, fintech)
+
+  designer:
+    model: sonnet
+    enabled: true        # type에 따라 자동 활성화 (web-service, web-app)
+
+# ============================================================
+# Knowledge 설정
+# ============================================================
+# knowledge 3계층:
+#   1. Curated (npm): common/ + {type}/ 병합 → 빈 껍데기로 로컬 복사
+#   2. Local: 프로젝트 작업 중 distillation skill로 생성
+#   3. Shared (향후): Retro → GitHub PR → npm 다음 버전 포함
+knowledge:
+  platforms: []          # 예: [supabase, vercel]
+  domains: []            # 예: [fintech, healthcare]
+  checklists:
+    - security           # 기본 보안 체크리스트
+  # local:               # 프로젝트 진행 중 로컬 생성
+  #   - ml/custom-architecture
+
+# ============================================================
+# 품질 기준
+# ============================================================
+quality:
+  test_coverage:
+    minimum: 80
+    recommended: 90
+
+  code_review:
+    required: true
+    approvers: 1
+
+  lint:
+    enabled: true
+    fix_on_save: true
+
+# ============================================================
+# 네이밍 규칙
+# ============================================================
+# Phase/Sequence/Task ID 자동 생성 시 사용하는 숫자 기반 패턴.
+# PM이 이 규칙에 따라 tsq wf set-phase / add-sequence를 자동 호출합니다.
+# 예: P1 = planning, P3-S001 = implementation 1번 시퀀스, P3-S001-T002 = 2번 태스크
+naming:
+  # Phase ID: P{N} — N은 order 배열의 인덱스 (1부터)
+  phase:
+    pattern: "P{N}"
+    order:                         # SSOT 프로세스 순서
+      - planning                   # P1
+      - design                     # P2
+      - implementation             # P3
+      - review                     # P4
+      - security                   # P5
+      - deployment                 # P6
+
+  # Sequence ID: P{N}-S{NNN}
+  sequence:
+    pattern: "P{N}-S{NNN}"
+    counter_pad: 3                 # zero-padding (001, 002, ...)
+
+  # Task ID: P{N}-S{NNN}-T{NNN}
+  task:
+    pattern: "P{N}-S{NNN}-T{NNN}"
+    counter_pad: 3
+
+# ============================================================
+# 자동화 백업 프로세스
+# ============================================================
+# 로그/메트릭/회고를 Hook이 자동으로 처리합니다.
+# 개별 토글로 필요한 항목만 활성화 가능.
+automation:
+  sequence_log: true               # L2 시퀀스 로그 자동 생성
+  phase_log: true                  # L3 페이즈 로그 자동 생성
+  phase_gate: true                 # 페이즈 전환 게이트 자동 체크
+  metrics: true                    # 세션 메트릭 자동 수집
+  retro: true                     # KPT 회고 자동 생성
+
+# ============================================================
+# SSOT 설정
+# ============================================================
+ssot:
+  # 프로젝트 레벨에 따른 필수 문서는 자동 결정
+  # 추가로 필요한 문서 지정
+  additional: []
+
+  # 문서 템플릿 커스터마이징
+  templates:
+    # 기본 템플릿 사용
+    use_default: true

package/templates/base/knowledge/checklists/accessibility.md

@@ -0,0 +1,37 @@
+# Accessibility Checklist
+
+Designer 에이전트가 참조하는 접근성 기준.
+
+## WCAG 2.1 기준
+
+| 레벨 | 설명 | 필수 |
+|-----|------|:----:|
+| A | 최소 접근성 | 필수 |
+| AA | 권장 수준 | 필수 |
+| AAA | 최고 수준 | 선택 |
+
+## 필수 체크리스트
+
+| 항목 | 기준 | 검증 방법 |
+|-----|------|----------|
+| 색상 대비 | 4.5:1 이상 | Contrast Checker |
+| 키보드 접근 | 모든 기능 | Tab 테스트 |
+| 스크린 리더 | 의미 전달 | VoiceOver/NVDA |
+| 폼 라벨 | 명확한 연결 | `<label for>` |
+| 이미지 대체 | alt 텍스트 | `<img alt>` |
+| 포커스 표시 | 명확한 표시 | 시각적 확인 |
+
+## ARIA 사용 가이드
+
+```html
+<!-- 버튼 상태 -->
+<button aria-pressed="true">토글</button>
+<button aria-expanded="false">메뉴</button>
+
+<!-- 폼 검증 -->
+<input aria-invalid="true" aria-describedby="error-msg" />
+<span id="error-msg">필수 항목입니다</span>
+
+<!-- 동적 콘텐츠 -->
+<div aria-live="polite">새 메시지가 도착했습니다</div>
+```

package/templates/base/knowledge/checklists/architecture-review.md

@@ -0,0 +1,28 @@
+# Architecture Review Checklist
+
+Architect 3축 분석 시 참조하는 상세 체크 항목.
+
+## Axis 1: 시퀀스 내 태스크 일관성
+
+- 에러 핸들링 패턴이 태스크 간 동일한가
+- 네이밍 컨벤션이 통일되어 있는가
+- 의존성 방향이 일관된가 (레이어 분리)
+- 공통 유틸/헬퍼의 중복 구현이 없는가
+- QA 태스크가 developer 태스크의 변경 사항을 실제로 테스트했는가
+
+## Axis 2: SSOT 적합성
+
+- API 엔드포인트의 경로, 메서드, 파라미터가 service-spec과 일치
+- 데이터 모델의 필드, 타입, 관계가 data-design과 일치
+- 비즈니스 로직이 requirements의 규칙을 충족
+- 누락된 엔드포인트/필드/검증이 없는가
+- SSOT에 없는 임의 구현이 추가되지 않았는가
+
+## Axis 3: 크로스시퀀스 연속성
+
+- 이전 보고서의 "다음 시퀀스 준비 상태" 조건이 충족되었는가
+- 이전 시퀀스에서 확립된 아키텍처 패턴을 따르는가
+- 이전 시퀀스의 발견 이슈가 해결되었는가 (해당 시퀀스인 경우)
+- 결정 사항 간 모순이 없는가
+
+> 이전 보고서가 없으면 (첫 시퀀스) Axis 3은 건너뜁니다.

package/templates/base/knowledge/checklists/database-standards.md

@@ -0,0 +1,84 @@
+# Database Standards
+
+DBA 에이전트가 참조하는 데이터베이스 설계 기준.
+
+## 네이밍 컨벤션
+
+| 대상 | 규칙 | 예시 |
+|-----|------|------|
+| 테이블 | snake_case, 복수형 | `users`, `order_items` |
+| 컬럼 | snake_case | `created_at`, `user_id` |
+| PK | `id` 또는 `{table}_id` | `id`, `user_id` |
+| FK | `{참조테이블단수}_id` | `user_id`, `order_id` |
+| 인덱스 | `idx_{table}_{columns}` | `idx_users_email` |
+| 제약조건 | `{type}_{table}_{column}` | `uk_users_email` |
+
+## 필수 컬럼
+
+모든 테이블에 포함:
+
+```sql
+id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+created_at  TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
+updated_at  TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW()
+```
+
+Soft Delete 사용 시: `deleted_at TIMESTAMP WITH TIME ZONE NULL`
+
+## 데이터 타입 선택
+
+| 용도 | 권장 타입 | 비권장 | 이유 |
+|-----|---------|-------|------|
+| PK | UUID | AUTO_INCREMENT | 분산 환경, 보안 |
+| 금액 | DECIMAL(19,4) | FLOAT | 정밀도 |
+| 날짜시간 | TIMESTAMPTZ | TIMESTAMP | 시간대 |
+| 상태 | VARCHAR(20) | ENUM | 유연성 |
+| JSON | JSONB | JSON | 인덱싱 |
+| 텍스트 | TEXT | VARCHAR(MAX) | 가독성 |
+
+## 인덱스 전략
+
+| 상황 | 인덱스 유형 | 예시 |
+|-----|-----------|------|
+| 동등 검색 | B-Tree | `WHERE email = ?` |
+| 범위 검색 | B-Tree | `WHERE created_at > ?` |
+| 전문 검색 | GIN/GiST | `WHERE name @@ ?` |
+| 배열/JSON | GIN | `WHERE tags @> ?` |
+| 정렬 | B-Tree (순서 포함) | `ORDER BY created_at DESC` |
+
+## 성능 기준 (NFR)
+
+| 쿼리 유형 | 목표 | 경고 | 위험 |
+|---------|:----:|:----:|:----:|
+| 단순 조회 (PK) | < 10ms | > 50ms | > 100ms |
+| 복합 조회 | < 100ms | > 200ms | > 500ms |
+| 집계 쿼리 | < 500ms | > 1s | > 3s |
+| 리포트 | < 5s | > 10s | > 30s |
+
+## 커넥션 관리
+
+| 환경 | 최소 | 최대 |
+|-----|:----:|:----:|
+| Development | 5 | 10 |
+| Staging | 10 | 20 |
+| Production | 20 | 100 (인스턴스당) |
+
+## 출력 형식: ERD (Mermaid)
+
+```mermaid
+erDiagram
+    users ||--o{ orders : places
+    users {
+        uuid id PK
+        string email UK
+        string name
+        timestamp created_at
+    }
+```
+
+## 출력 형식: 테이블 정의
+
+| 컬럼 | 타입 | 제약조건 | 설명 |
+|-----|------|---------|------|
+| id | UUID | PK | 고유 식별자 |
+| email | VARCHAR(255) | NOT NULL, UNIQUE | 이메일 |

package/templates/base/knowledge/checklists/design-reference.md

@@ -0,0 +1,97 @@
+# Design Reference
+
+Designer 에이전트가 참조하는 UI/UX 설계 기준 데이터.
+
+## 레이아웃 그리드
+
+| 디바이스 | 컬럼 | 거터 | 마진 |
+|---------|:----:|:----:|:----:|
+| Desktop (1200px+) | 12 | 24px | 32px |
+| Tablet (768-1199px) | 8 | 16px | 24px |
+| Mobile (< 768px) | 4 | 16px | 16px |
+
+## 반응형 브레이크포인트
+
+```css
+/* Mobile First */
+@media (min-width: 640px) { /* sm */ }
+@media (min-width: 768px) { /* md */ }
+@media (min-width: 1024px) { /* lg */ }
+@media (min-width: 1280px) { /* xl */ }
+@media (min-width: 1536px) { /* 2xl */ }
+```
+
+## 인터랙션 상태
+
+| 상태 | 설명 | 표현 |
+|-----|------|------|
+| Default | 기본 상태 | 일반 스타일 |
+| Hover | 마우스 오버 | 색상 변화 |
+| Active | 클릭/탭 중 | 눌린 효과 |
+| Focus | 키보드 포커스 | 아웃라인 |
+| Disabled | 비활성화 | 흐릿함 |
+| Loading | 로딩 중 | 스피너 |
+| Error | 오류 상태 | 빨간색 강조 |
+| Success | 성공 상태 | 초록색 강조 |
+
+## 마이크로카피 가이드
+
+| 상황 | Bad | Good |
+|-----|-----|------|
+| 버튼 | "확인" | "저장하기" |
+| 에러 | "오류 발생" | "이메일 형식이 올바르지 않습니다" |
+| 빈 상태 | "데이터 없음" | "아직 등록된 항목이 없습니다" |
+| 로딩 | "로딩 중..." | "데이터를 불러오는 중입니다" |
+| 성공 | "완료" | "저장되었습니다" |
+
+## 디자인 토큰 (기본)
+
+```yaml
+colors:
+  primary: { 50: '#f0f9ff', 500: '#3b82f6', 900: '#1e3a8a' }
+  gray: { 50: '#f9fafb', 500: '#6b7280', 900: '#111827' }
+  semantic: { success: '#10b981', warning: '#f59e0b', error: '#ef4444', info: '#3b82f6' }
+
+spacing: { xs: '4px', sm: '8px', md: '16px', lg: '24px', xl: '32px' }
+
+typography:
+  fontSize: { xs: '12px', sm: '14px', base: '16px', lg: '18px', xl: '20px', 2xl: '24px' }
+  fontWeight: { normal: 400, medium: 500, semibold: 600, bold: 700 }
+```
+
+## 컴포넌트 체크리스트
+
+| 컴포넌트 | 변형 | 크기 | 상태 |
+|---------|------|------|------|
+| Button | primary, secondary, ghost | sm, md, lg | 8가지 |
+| Input | text, email, password, search | sm, md, lg | 5가지 |
+| Select | single, multi | sm, md, lg | 4가지 |
+| Card | default, outline, elevated | - | 2가지 |
+| Modal | sm, md, lg, fullscreen | - | 3가지 |
+| Toast | success, warning, error, info | - | - |
+
+## 화면 설계 문서 형식
+
+```markdown
+## SCR-XXX: [화면명]
+
+### 기본 정보
+| 항목 | 값 |
+|-----|---|
+| 화면 ID | SCR-XXX |
+| URL | /path/to/page |
+| 접근 권한 | [역할] |
+| 관련 기능 | REQ-XXX |
+
+### 와이어프레임
+(ASCII 와이어프레임)
+
+### 컴포넌트 목록
+| ID | 컴포넌트 | 설명 | 상태 |
+
+### 인터랙션
+| 액션 | 결과 |
+
+### 반응형 처리
+| 브레이크포인트 | 변경사항 |
+```

package/templates/base/knowledge/checklists/security.md

@@ -0,0 +1,50 @@
+# Security Checklist
+
+> 스택별 보안 체크리스트. 에이전트가 보안 검토 시 참조합니다.
+
+## 공통 (모든 프로젝트)
+
+### 인증/인가
+- [ ] 비밀번호 해싱 (bcrypt/argon2, cost factor 적절)
+- [ ] JWT 검증 (서명, 만료, audience)
+- [ ] 세션 관리 (만료, 갱신, 무효화)
+- [ ] 권한 검사 (모든 엔드포인트)
+- [ ] Rate Limiting (로그인, API)
+
+### 입력 검증
+- [ ] 서버 사이드 검증 (클라이언트 검증만 의존 금지)
+- [ ] SQL Injection 방지 (파라미터화 쿼리)
+- [ ] XSS 방지 (출력 인코딩)
+- [ ] CSRF 방지 (토큰 또는 SameSite Cookie)
+- [ ] 파일 업로드 검증 (타입, 크기, 경로)
+
+### 데이터 보호
+- [ ] HTTPS 강제
+- [ ] 민감 데이터 암호화 (저장 시)
+- [ ] PII 마스킹 (로그, 에러 메시지)
+- [ ] .env 파일 .gitignore 포함
+- [ ] 하드코딩된 시크릿 없음
+
+### 의존성
+- [ ] npm audit / yarn audit 통과
+- [ ] 알려진 취약점 없는 버전 사용
+- [ ] lock 파일 커밋
+
+## Supabase 특화
+- [ ] RLS (Row Level Security) 활성화 (모든 테이블)
+- [ ] Service Role Key 서버 사이드만 사용
+- [ ] Anon Key 권한 최소화
+- [ ] Storage 접근 정책 설정
+- [ ] Edge Functions 환경변수로 시크릿 관리
+
+## Vercel 특화
+- [ ] 환경변수 Preview/Production 분리
+- [ ] CORS 설정 적절성
+- [ ] Edge Middleware 인증 체크
+- [ ] 빌드 시 시크릿 노출 없음
+
+## Fintech 추가
+- [ ] 서버사이드 금액 검증 (클라이언트 값 신뢰 금지)
+- [ ] 감사 로그 (모든 금전 관련 작업)
+- [ ] 거래 멱등성 (중복 처리 방지)
+- [ ] PCI-DSS 관련 (카드 정보 미저장)

package/templates/base/knowledge/checklists/ssot-validation.md

@@ -0,0 +1,19 @@
+# SSOT Validation Checklist
+
+QA 에이전트가 SSOT 교차 검증 시 참조.
+
+## 교차 검증 항목
+
+- API 엔드포인트 일치 (service-spec.md <-> 구현 코드)
+- Request/Response 형식 일치
+- 에러 코드 일치 (error-codes.md <-> 구현 코드)
+- 데이터 모델 일치 (data-design.md <-> 마이그레이션/스키마)
+- FR-XXX ID 추적성 (requirements.md -> functional-spec.md -> test-spec.md)
+- 용어 일관성 (glossary.md 기준)
+
+## 성능 체크
+
+- N+1 쿼리 없음
+- 불필요한 데이터 로딩 없음
+- 적절한 인덱스 사용
+- 메모리 누수 가능성 없음

package/templates/base/knowledge/domains/_template.md

@@ -0,0 +1,16 @@
+# {도메인명} Knowledge
+
+> 이 파일은 프로젝트 경험에서 추출하여 채우는 도메인 참조 지식입니다.
+> 처음부터 완성하지 않고, 실제 프로젝트에서 발견한 핵심 정보만 기록합니다.
+
+## 도메인 규칙
+- {비즈니스 로직의 핵심 규칙}
+
+## 일반적인 구현 패턴
+- {이 도메인에서 자주 쓰는 패턴}
+
+## 검증 규칙
+- {입력 검증, 비즈니스 검증 규칙}
+
+## 주의사항
+- {이 도메인에서 실수하기 쉬운 부분}

package/templates/base/knowledge/platforms/_template.md

@@ -0,0 +1,16 @@
+# {플랫폼명} Knowledge
+
+> 이 파일은 프로젝트 경험에서 추출하여 채우는 참조 지식입니다.
+> 처음부터 완성하지 않고, 실제 프로젝트에서 발견한 핵심 정보만 기록합니다.
+
+## 핵심 개념
+- {이 플랫폼의 핵심 특징/제약}
+
+## 자주 쓰는 패턴
+- {검증된 패턴 + 코드 예시}
+
+## 주의사항 / 함정
+- {실수하기 쉬운 부분, 문서에 없는 제약}
+
+## 프로젝트 적용 시 체크리스트
+- [ ] {확인해야 할 항목}

package/templates/base/knowledge/templates/sequence-report.md

@@ -0,0 +1,44 @@
+# Sequence Report Template
+
+Architect가 시퀀스 분석 완료 후 PM에 리턴하는 보고서 형식.
+
+---
+
+# {SEQ-ID} 시퀀스 보고서
+
+## 개요
+| 항목 | 값 |
+|------|-----|
+| 시퀀스 | {SEQ-ID} ({시퀀스 설명}) |
+| 태스크 | {참여 태스크 목록} |
+| 에이전트 | {참여 에이전트 목록} |
+| 변경 파일 | {n}개 생성, {m}개 수정, {k}개 삭제 |
+
+## Axis 1: 시퀀스 내 태스크 일관성
+| 검증 항목 | 상태 | 파일:라인 | 비고 |
+|----------|:----:|----------|------|
+| 에러 핸들링 패턴 통일 | pass/warn/fail | {참조} | {설명} |
+| 네이밍 컨벤션 | pass/warn/fail | {참조} | {설명} |
+| 레이어 분리/의존성 방향 | pass/warn/fail | {참조} | {설명} |
+| 중복 구현 없음 | pass/warn/fail | {참조} | {설명} |
+| QA 커버리지 | pass/warn/fail | {참조} | {설명} |
+
+## Axis 2: SSOT 적합성
+| SSOT 문서 | 섹션 | 구현 상태 | 비고 |
+|-----------|------|:--------:|------|
+| {문서} | {섹션} | pass/warn/fail | {설명} |
+
+## Axis 3: 크로스시퀀스 연속성
+| 이전 시퀀스 | 관련 결정/패턴 | 현재 시퀀스 상태 | 비고 |
+|------------|--------------|:--------------:|------|
+| {SEQ-XX} | {결정/패턴} | 준수/변경/충돌 | {설명} |
+
+## 발견 이슈
+| # | Level | 파일:라인 | 설명 | 대응 |
+|---|:-----:|----------|------|------|
+| 1 | {1/2/3} | {파일:라인} | {설명} | {권장 대응} |
+
+## 다음 시퀀스 준비 상태
+- **진행 판단**: 진행 권장 / 보류 권장
+- **근거**: {판단 근거}
+- **선행 조건** (보류 시): {해결해야 할 사항}