timsquad 2.1.0 → 3.3.0

package/templates/platforms/claude-code/rules/phase-management.md

@@ -0,0 +1,23 @@
+---
+description: Phase 관리 규칙. Phase 전환, 허용/금지 작업, 종료 조건.
+globs:
+  - ".timsquad/state/**"
+  - ".timsquad/ssot/**"
+---
+
+# Phase 관리
+
+현재 Phase: `.timsquad/state/current-phase.json` 확인
+
+| Phase | 허용 작업 | 금지 | 종료 조건 |
+|-------|----------|------|----------|
+| planning | SSOT 작성, 아키텍처 설계, ADR | 코드 구현 | User 승인 |
+| design | UI/UX 설계, 와이어프레임 | 코드 구현 | User 승인 |
+| implementation | 코드 구현, 테스트 작성 | SSOT 임의 수정 | 테스트+린트 통과 |
+| review | 코드 리뷰, 검증 | 코드 직접 수정 | QA 체크리스트 통과 |
+| security | 보안 검토 | 코드 직접 수정 | Critical/High 취약점 없음 |
+| deployment | 배포 | - | 배포 완료 |
+
+## Phase 종료 시
+- `skills/retrospective/SKILL.md`를 활용하여 회고 실행
+- Phase 전환 조건 미충족 시 다음 Phase 진행 금지

package/templates/platforms/claude-code/rules/reporting-format.md

@@ -0,0 +1,26 @@
+---
+description: PM 진행 상황 보고 형식.
+---
+
+# 보고 형식
+
+## 진행 상황 보고 (사용자에게)
+
+```markdown
+## 현재 상태
+- Phase: {current_phase}
+- 진행률: {progress}%
+
+## 완료된 작업
+- {completed_task_1}
+- {completed_task_2}
+
+## 진행 중인 작업
+- {in_progress_task}
+
+## 다음 단계
+- {next_step}
+
+## 필요한 결정/승인
+- {decision_needed} (있는 경우)
+```

package/templates/platforms/claude-code/rules/sequence-management.md

@@ -0,0 +1,72 @@
+---
+description: 시퀀스 관리 규칙. 네이밍, 자동화 파이프라인, 수동 모드.
+globs:
+  - ".timsquad/logs/**"
+  - ".timsquad/state/workspace.xml"
+---
+
+# 시퀀스 관리
+
+태스크를 시퀀스로 그룹화하여 관리합니다.
+
+## PM 자동 등록 프로토콜
+
+사용자가 작업을 요청하면 `.timsquad/config.yaml`의 `naming` 섹션을 읽고
+Phase/Sequence/Task ID를 **자동 생성**하여 등록하세요. 사용자에게 수동 명령을 요구하지 마세요.
+
+**네이밍 규칙** (config.yaml → naming 참조):
+- Phase ID: `P{N}` — planning=P1, design=P2, implementation=P3, review=P4, security=P5, deployment=P6
+- Sequence ID: `P{N}-S{NNN}` — 페이즈 내 시퀀스 번호 (zero-padded)
+- Task ID: `P{N}-S{NNN}-T{NNN}` — 시퀀스 내 태스크 번호 (zero-padded)
+- 번호는 `tsq wf status`로 기존 시퀀스를 확인한 후 이어서 부여
+
+**흐름 예시**:
+```
+사용자: "인증 기능이랑 결제 API 구현해줘"
+PM 내부 처리:
+1. config.yaml → naming.phase.order → implementation = P3
+2. tsq wf set-phase P3
+3. tsq wf add-sequence P3-S001 --agents developer,dba
+4. tsq wf add-sequence P3-S002 --agents developer,security
+5. @tsq-developer "P3-S001: 인증 구현"
+```
+
+## 자동화 파이프라인 (데몬 기반)
+
+```
+SessionStart → tsq daemon start
+  ├─ JSONL 스트림 실시간 감시
+  ├─ 인메모리 메타인덱스 로드
+  └─ 소스 파일 변경 감시
+
+SubagentStop 감지 시:
+  ├─ L1 태스크 로그 자동 생성
+  ├─ workflow.json 업데이트
+  └─ 시퀀스 완료 → L2 자동 → 페이즈 완료 → L3 + Gate + 회고
+
+SessionEnd → tsq daemon stop
+  ├─ worklog markdown 생성
+  ├─ 최종 메트릭 갱신
+  └─ 정리
+```
+
+## 자동화 토글
+```bash
+tsq wf config sequence_log off   # L2 자동 생성 끄기
+tsq wf config retro off          # 자동 회고 끄기
+tsq wf status                    # 현재 상태 확인
+```
+
+## 수동 모드 (자동화 꺼진 경우)
+
+### Architect 호출
+시퀀스 완료 후 `@tsq-architect` 호출:
+- `seq_id`, `task_logs`, `ssot_refs` 필수
+- 보고서 저장: `.timsquad/reports/{SEQ-ID}-report.md`
+
+### 수동 L2/L3 생성
+```bash
+tsq log sequence create {SEQ-ID} --phase {phase} --report {path} --verdict proceed
+tsq log phase create {phase-id} --sequences "SEQ-01,SEQ-02"
+tsq log phase gate {phase-id}
+```

package/templates/platforms/claude-code/rules/workspace-sync.md

@@ -0,0 +1,33 @@
+---
+description: workspace.xml 실시간 상태 관리 규칙.
+globs:
+  - ".timsquad/state/workspace.xml"
+---
+
+# Workspace 동기화
+
+`.timsquad/state/workspace.xml`은 에이전트 간 실시간 상태 공유 파일입니다.
+
+## 필수 업데이트 시점
+- 작업 시작 시: `<current-task>` 업데이트
+- 작업 완료 시: `<completed-tasks>`로 이동, `<pending-tasks>` 업데이트
+- 에이전트 전환 시: `<handoff>` 작성
+- 이슈 발생 시: `<blockers>` 추가
+- 승인 필요 시: `<pending-approvals>` 추가
+
+## 주요 노드
+```
+/workspace/current-task          - 현재 진행 중인 작업
+/workspace/pending-tasks         - 대기 중인 작업 목록
+/workspace/completed-tasks       - 완료된 작업 (최근 10개)
+/workspace/handoff               - 에이전트 간 인수인계 정보
+/workspace/blockers              - 블로킹 이슈
+/workspace/pending-approvals     - 승인 대기 항목
+```
+
+## Handoff 프로토콜
+에이전트 전환 시 `<handoff>` 섹션에 기록:
+- from/to: 이전/다음 에이전트
+- message: 전달 사항 (특이사항, 주의점)
+- attachments: 참조할 SSOT 문서
+- action-items: 해야 할 작업 목록

package/templates/platforms/claude-code/settings.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "tsq daemon start --jsonl \"$CLAUDE_TRANSCRIPT_PATH\" 2>/dev/null || true",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "tsq daemon stop 2>/dev/null || true",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/project-types/api-backend/config.yaml

@@ -0,0 +1,227 @@
+# TimSquad API Backend 프로젝트 설정
+# API 서버, 마이크로서비스 전용
+
+type: api-backend
+description: "API 서버, 마이크로서비스, REST/GraphQL 백엔드"
+
+# ============================================================
+# 에이전트 설정
+# ============================================================
+agents:
+  # Planner는 API 설계에 집중
+  planner:
+    model: opus
+    focus:
+      - api_design
+      - data_modeling
+      - error_handling
+    ssot_priority:
+      - service-spec.md
+      - data-design.md
+      - error-codes.md
+
+  # Developer는 백엔드 구현
+  developer:
+    model: sonnet
+    skills:
+      - coding
+      - testing
+      - backend/node  # 또는 적절한 백엔드 기술
+    focus:
+      - api_implementation
+      - database_queries
+      - validation
+
+  # DBA는 필수
+  dba:
+    model: sonnet
+    required: true
+    focus:
+      - schema_design
+      - query_optimization
+      - migration
+
+  # QA는 API 테스트에 집중
+  qa:
+    model: sonnet
+    focus:
+      - api_testing
+      - integration_testing
+      - load_testing
+
+  # Security 검토 권장
+  security:
+    model: sonnet
+    recommended: true
+    focus:
+      - authentication
+      - authorization
+      - input_validation
+
+# ============================================================
+# SSOT 문서 설정
+# ============================================================
+ssot:
+  required:
+    - prd.md
+    - planning.md
+    - requirements.md
+    - service-spec.md      # API 명세 필수
+    - data-design.md       # 데이터 설계 필수
+    - error-codes.md       # 에러 코드 필수
+
+  recommended:
+    - glossary.md
+    - test-spec.md
+    - env-config.md
+
+  optional:
+    - ui-ux-spec.md        # API만이므로 불필요
+    - deployment-spec.md
+    - integration-spec.md
+
+# ============================================================
+# 워크플로우 설정
+# ============================================================
+workflow:
+  phases:
+    planning:
+      focus:
+        - API 명세 설계
+        - 데이터 모델링
+        - 에러 코드 정의
+      deliverables:
+        - service-spec.md
+        - data-design.md
+        - error-codes.md
+
+    implementation:
+      focus:
+        - API 엔드포인트 구현
+        - 데이터베이스 마이그레이션
+        - 비즈니스 로직
+      parallel_allowed: true
+      validation:
+        - api_contract_test
+        - schema_validation
+
+    testing:
+      focus:
+        - 단위 테스트
+        - 통합 테스트
+        - API 계약 테스트
+      coverage_target: 80
+
+    review:
+      checklist:
+        - API 응답 형식 일관성
+        - 에러 처리 완전성
+        - 성능 (응답 시간)
+        - 보안 (인증/인가)
+
+# ============================================================
+# 코딩 규칙
+# ============================================================
+coding:
+  api:
+    # REST API 규칙
+    rest:
+      versioning: url  # /api/v1/
+      naming: kebab-case
+      response_format:
+        success: |
+          {
+            "success": true,
+            "data": { ... }
+          }
+        error: |
+          {
+            "success": false,
+            "error": {
+              "code": "ERR_CODE",
+              "message": "Human readable message"
+            }
+          }
+
+    # 상태 코드
+    http_status:
+      success: [200, 201, 204]
+      client_error: [400, 401, 403, 404, 409, 422]
+      server_error: [500, 502, 503]
+
+  database:
+    # ORM 사용 권장
+    orm_required: true
+    # 마이그레이션 필수
+    migration_required: true
+    # 트랜잭션 처리
+    transaction_policy: "explicit"
+
+  validation:
+    # 입력 검증 필수
+    input_validation: required
+    # 스키마 검증 도구
+    schema_validation: "zod"  # 또는 joi, yup
+
+# ============================================================
+# 테스트 규칙
+# ============================================================
+testing:
+  required:
+    - unit
+    - integration
+    - api_contract
+
+  optional:
+    - e2e
+    - load
+    - security
+
+  coverage:
+    minimum: 80
+    branches: 70
+
+  api_testing:
+    tools: ["supertest", "jest"]
+    mock_external: true
+
+# ============================================================
+# 보안 규칙
+# ============================================================
+security:
+  authentication:
+    methods: ["jwt", "api_key"]
+    token_expiry: "15m"
+    refresh_token: true
+
+  authorization:
+    model: "rbac"  # Role-Based Access Control
+
+  input:
+    sanitize: true
+    validate: true
+    rate_limit: true
+
+  headers:
+    required:
+      - "Content-Security-Policy"
+      - "X-Content-Type-Options"
+      - "X-Frame-Options"
+
+# ============================================================
+# 성능 기준
+# ============================================================
+performance:
+  response_time:
+    p50: "100ms"
+    p95: "500ms"
+    p99: "1s"
+
+  throughput:
+    minimum: "100 rps"
+
+  database:
+    query_timeout: "5s"
+    connection_pool:
+      min: 5
+      max: 20

package/templates/project-types/api-backend/process/workflow.xml

@@ -0,0 +1,214 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  TimSquad API Backend 워크플로우
+  API 서버, 마이크로서비스 전용 프로세스 정의
+-->
+<workflow type="api-backend" version="1.0">
+  <metadata>
+    <description>API 서버 개발 워크플로우</description>
+    <focus>API 설계, 데이터 모델링, 계약 기반 개발</focus>
+  </metadata>
+
+  <!-- ============================================================
+       Phase 정의
+       ============================================================ -->
+  <phases>
+    <!-- Planning Phase -->
+    <phase id="planning" order="1">
+      <name>API 설계</name>
+      <description>API 명세, 데이터 모델, 에러 코드 정의</description>
+
+      <tasks>
+        <task id="api-spec" required="true">
+          <name>API 명세 작성</name>
+          <agent>tsq-planner</agent>
+          <output>service-spec.md</output>
+          <checklist>
+            <item>엔드포인트 정의</item>
+            <item>Request/Response 스키마</item>
+            <item>인증 방식</item>
+            <item>버전 전략</item>
+          </checklist>
+        </task>
+
+        <task id="data-model" required="true">
+          <name>데이터 모델링</name>
+          <agent>tsq-dba</agent>
+          <output>data-design.md</output>
+          <checklist>
+            <item>ERD 작성</item>
+            <item>테이블 정의</item>
+            <item>인덱스 전략</item>
+            <item>관계 정의</item>
+          </checklist>
+        </task>
+
+        <task id="error-codes" required="true">
+          <name>에러 코드 정의</name>
+          <agent>tsq-planner</agent>
+          <output>error-codes.md</output>
+          <checklist>
+            <item>에러 코드 체계</item>
+            <item>HTTP 상태 코드 매핑</item>
+            <item>에러 메시지</item>
+          </checklist>
+        </task>
+      </tasks>
+
+      <validation>
+        <rule>모든 엔드포인트에 에러 케이스 정의</rule>
+        <rule>데이터 모델과 API 스키마 일치</rule>
+      </validation>
+
+      <exit-criteria>
+        <criterion>service-spec.md 완성</criterion>
+        <criterion>data-design.md 완성</criterion>
+        <criterion>error-codes.md 완성</criterion>
+        <criterion>사용자 승인</criterion>
+      </exit-criteria>
+    </phase>
+
+    <!-- Implementation Phase -->
+    <phase id="implementation" order="2">
+      <name>API 구현</name>
+      <description>엔드포인트 구현, DB 마이그레이션</description>
+
+      <tasks>
+        <task id="db-migration" required="true">
+          <name>DB 마이그레이션</name>
+          <agent>tsq-dba</agent>
+          <dependency>data-model</dependency>
+          <checklist>
+            <item>마이그레이션 스크립트</item>
+            <item>롤백 스크립트</item>
+            <item>시드 데이터</item>
+          </checklist>
+        </task>
+
+        <task id="api-implementation" required="true">
+          <name>API 엔드포인트 구현</name>
+          <agent>tsq-developer</agent>
+          <dependency>api-spec, db-migration</dependency>
+          <parallel-allowed>true</parallel-allowed>
+          <checklist>
+            <item>라우터 설정</item>
+            <item>컨트롤러 구현</item>
+            <item>서비스 레이어</item>
+            <item>입력 검증</item>
+            <item>에러 핸들링</item>
+          </checklist>
+        </task>
+
+        <task id="unit-tests" required="true">
+          <name>단위 테스트 작성</name>
+          <agent>tsq-developer</agent>
+          <dependency>api-implementation</dependency>
+        </task>
+      </tasks>
+
+      <validation>
+        <rule>service-spec.md와 구현 일치</rule>
+        <rule>모든 엔드포인트 테스트 존재</rule>
+      </validation>
+    </phase>
+
+    <!-- Testing Phase -->
+    <phase id="testing" order="3">
+      <name>API 테스트</name>
+      <description>통합 테스트, API 계약 테스트</description>
+
+      <tasks>
+        <task id="integration-test" required="true">
+          <name>통합 테스트</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>API 호출 테스트</item>
+            <item>DB 연동 테스트</item>
+            <item>에러 시나리오</item>
+          </checklist>
+        </task>
+
+        <task id="contract-test" required="true">
+          <name>API 계약 테스트</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>Request 스키마 검증</item>
+            <item>Response 스키마 검증</item>
+            <item>에러 응답 검증</item>
+          </checklist>
+        </task>
+
+        <task id="performance-test" required="false">
+          <name>성능 테스트</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>응답 시간 측정</item>
+            <item>부하 테스트</item>
+          </checklist>
+        </task>
+      </tasks>
+
+      <validation>
+        <rule>테스트 커버리지 80% 이상</rule>
+        <rule>모든 API 엔드포인트 테스트 통과</rule>
+      </validation>
+    </phase>
+
+    <!-- Review Phase -->
+    <phase id="review" order="4">
+      <name>코드 리뷰</name>
+      <description>품질 검토, 보안 검토</description>
+
+      <tasks>
+        <task id="code-review" required="true">
+          <name>코드 리뷰</name>
+          <agent>tsq-qa</agent>
+          <checklist>
+            <item>API 응답 형식 일관성</item>
+            <item>에러 처리 완전성</item>
+            <item>코드 품질</item>
+          </checklist>
+        </task>
+
+        <task id="security-review" required="true">
+          <name>보안 검토</name>
+          <agent>tsq-security</agent>
+          <checklist>
+            <item>인증/인가 검증</item>
+            <item>입력 검증</item>
+            <item>SQL Injection 방지</item>
+            <item>Rate Limiting</item>
+          </checklist>
+        </task>
+      </tasks>
+
+      <approval>
+        <required>true</required>
+        <approvers>
+          <approver>tsq-qa</approver>
+          <approver>tsq-security</approver>
+        </approvers>
+      </approval>
+    </phase>
+  </phases>
+
+  <!-- ============================================================
+       API Backend 특화 규칙
+       ============================================================ -->
+  <rules>
+    <rule id="api-first">
+      <description>API 명세 먼저, 구현은 나중</description>
+      <enforcement>strict</enforcement>
+    </rule>
+
+    <rule id="contract-testing">
+      <description>모든 API는 계약 테스트 필수</description>
+      <enforcement>strict</enforcement>
+    </rule>
+
+    <rule id="error-handling">
+      <description>모든 에러는 error-codes.md에 정의된 형식</description>
+      <enforcement>strict</enforcement>
+    </rule>
+  </rules>
+</workflow>