timsquad 3.5.0 → 3.7.0

package/templates/base/skills/{ui-design → tsq-ui}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: ui-design
+name: tsq-ui
 description: |
   UI/UX 설계 방법론.
   와이어프레임 표기법, 사용자 플로우 다이어그램, 화면 설계 프로세스.
   Use when: 화면 설계, 와이어프레임, UX 플로우, 프로토타이핑
 version: "1.0.0"
-tags: [ui, ux, design]
+tags: [tsq, ui, ux, design]
 user-invocable: false
 ---
 

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

@@ -0,0 +1,48 @@
+---
+name: tsq-update
+description: |
+  TimSquad 프레임워크 업데이트. 템플릿, 스킬, 에이전트를 최신 버전으로 동기화.
+  Use when: /tsq-update, "업데이트", "업그레이드", "최신화", "sync templates"
+version: "1.0.0"
+tags: [tsq, update, upgrade, sync]
+user-invocable: true
+---
+
+# /tsq-update — Framework Update
+
+## Protocol
+
+### 업데이트 (`/tsq-update`)
+
+1. **현재 상태 확인**: 현재 프레임워크 버전과 설치된 버전 비교
+2. **변경 사항 요약**: 어떤 파일이 동기화되는지 사용자에게 보여주기
+3. **실행**:
+   ```bash
+   tsq update -y
+   ```
+4. **결과 확인**: 업데이트 결과 요약 출력
+5. **후속 안내**: 변경된 스킬/룰이 있으면 재시작 권장
+
+### 롤백 (`/tsq-update rollback`)
+
+1. **백업 확인**: 이전 업데이트 백업 존재 여부 확인
+2. **실행**:
+   ```bash
+   tsq update --rollback -y
+   ```
+3. **결과 확인**: 롤백 완료 확인
+
+### Dry Run (`/tsq-update check`)
+
+1. **변경 사항만 확인** (실제 수정 없음):
+   ```bash
+   tsq update --dry-run
+   ```
+
+## 보존 대상 (업데이트 시 절대 변경 안 됨)
+
+- `.timsquad/config.yaml` — 프로젝트 설정
+- `.timsquad/ssot/` — SSOT 문서
+- `.timsquad/logs/` — 모든 로그
+- `.timsquad/state/` — 워크플로우 상태, 메타인덱스
+- CLAUDE.md 사용자 작성 영역 (`<!-- tsq:end -->` 이후)

package/templates/base/timsquad/constraints/competency-framework.xml

@@ -65,8 +65,8 @@
        에이전트별 역량 정의
        ============================================================ -->
   <agents>
-    <!-- tsq-planner 역량 -->
-    <agent id="tsq-planner">
+    <!-- tsq-architect 역량 -->
+    <agent id="tsq-architect">
       <role>Planning Agent</role>
       <description>PRD, 기획, 아키텍처 설계 담당</description>
 

package/templates/base/timsquad/constraints/ssot-schema.xml

@@ -25,7 +25,7 @@
 title: 서비스 명세서
 version: 1.0.0
 last_updated: 2026-02-03
-author: tsq-planner
+author: tsq-architect
 status: approved
 ---
         ]]>
@@ -41,7 +41,7 @@ status: approved
 
 | 버전 | 날짜 | 작성자 | 변경 내용 |
 |------|------|--------|----------|
-| 1.0.0 | 2026-02-03 | tsq-planner | 초기 작성 |
+| 1.0.0 | 2026-02-03 | tsq-architect | 초기 작성 |
         ]]>
       </template>
     </rule>

package/templates/base/timsquad/process/phase-checklist.yaml

@@ -35,7 +35,7 @@ planning_to_implementation:
       check: "workspace.xml의 handoff 섹션이 작성되었는가?"
       required: true
       validation:
-        - "from: tsq-planner"
+        - "from: tsq-architect"
         - "to: tsq-developer"
         - "message: 인수인계 내용 작성됨"
         - "attachments: 참조할 SSOT 문서 목록"

package/templates/base/timsquad/process/state-machine.xml

@@ -12,7 +12,7 @@
   <states>
     <state id="planning" name="기획/설계">
       <description>요구사항 분석, SSOT 문서 작성, 아키텍처 설계</description>
-      <primary-agent>tsq-planner</primary-agent>
+      <primary-agent>tsq-architect</primary-agent>
       <allowed-actions>
         <action>SSOT 문서 생성/수정</action>
         <action>ADR 작성</action>
@@ -245,7 +245,7 @@
       <trigger>Level 2 피드백 발생</trigger>
 
       <on-transition>
-        <action>피드백 내용 Planner에게 전달</action>
+        <action>피드백 내용 Architect에게 전달</action>
         <action>SSOT 수정 필요 항목 기록</action>
       </on-transition>
     </transition>

package/templates/base/timsquad/process/validation-rules.xml

@@ -62,7 +62,7 @@
           Planning Phase를 먼저 완료하세요.
         </error-message>
         <action-on-fail>block</action-on-fail>
-        <route-to>tsq-planner</route-to>
+        <route-to>tsq-architect</route-to>
       </precondition>
 
       <precondition id="IMPL-PRE-002" severity="critical">
@@ -120,7 +120,7 @@
        에이전트별 Pre-condition
        ============================================================ -->
   <agent-preconditions>
-    <agent id="tsq-planner">
+    <agent id="tsq-architect">
       <precondition id="PLN-PRE-001">
         <name>기존 결정 확인</name>
         <check>.timsquad/ssot/adr/ 디렉토리 확인</check>
@@ -148,7 +148,7 @@
           2. data-design.md의 데이터 모델
           3. error-codes.md의 에러 코드
 
-          SSOT와 다르게 구현하면 즉시 중단하고 tsq-planner에게 보고
+          SSOT와 다르게 구현하면 즉시 중단하고 tsq-architect에게 보고
         </instruction>
       </precondition>
     </agent>
@@ -194,8 +194,8 @@
       <action-on-fail>block-completion</action-on-fail>
     </condition>
 
-    <!-- Planner -->
-    <condition id="POST-PLN-001" applies-to="tsq-planner" severity="critical">
+    <!-- Architect -->
+    <condition id="POST-PLN-001" applies-to="tsq-architect" severity="critical">
       <name>SSOT 문서 생성/수정</name>
       <check>SSOT 파일 생성 또는 수정됨</check>
       <validation>
@@ -204,7 +204,7 @@
       </validation>
     </condition>
 
-    <condition id="POST-PLN-002" applies-to="tsq-planner">
+    <condition id="POST-PLN-002" applies-to="tsq-architect">
       <name>주요 결정 ADR 기록</name>
       <check>아키텍처/설계 결정 시 ADR 생성</check>
       <triggers>
@@ -236,7 +236,7 @@
       </validation>
       <on-mismatch>
         <action>작업 중단</action>
-        <route-to>tsq-planner</route-to>
+        <route-to>tsq-architect</route-to>
         <report>SSOT 불일치 내용 보고</report>
       </on-mismatch>
     </condition>
@@ -285,7 +285,7 @@
       <rule>SSOT 문서와 구현이 항상 일치해야 함</rule>
       <on-violation>
         <action>작업 중단</action>
-        <report>불일치 내용을 tsq-planner에게 보고</report>
+        <report>불일치 내용을 tsq-architect에게 보고</report>
       </on-violation>
     </invariant>
 

package/templates/base/timsquad/process/workflow-base.xml

@@ -8,7 +8,7 @@
   <!-- 공통 Phase 정의 -->
   <phases>
     <phase id="planning" name="기획/설계">
-      <primary-agent>tsq-planner</primary-agent>
+      <primary-agent>tsq-architect</primary-agent>
       <description>요구사항 분석, SSOT 문서 작성, 아키텍처 설계</description>
 
       <tasks>
@@ -58,8 +58,8 @@
       </methodology-tasks>
 
       <escalation-rules>
-        <rule trigger="SSOT 불일치" route="tsq-planner" action="작업 중단">
-          SSOT와 요구사항이 맞지 않으면 즉시 중단하고 Planner에게 보고
+        <rule trigger="SSOT 불일치" route="tsq-architect" action="작업 중단">
+          SSOT와 요구사항이 맞지 않으면 즉시 중단하고 Architect에게 보고
         </rule>
         <rule trigger="요구사항 불명확" route="User" action="질문">
           불명확한 부분은 User에게 직접 질문
@@ -93,9 +93,9 @@
           <action>Developer에게 수정 요청</action>
           <return-to-phase>implementation</return-to-phase>
         </level>
-        <level id="2" severity="Major" route="tsq-planner">
+        <level id="2" severity="Major" route="tsq-architect">
           <triggers>API 명세 불일치, 데이터 모델 불일치, 설계 문제</triggers>
-          <action>Planner에게 SSOT 수정 요청</action>
+          <action>Architect에게 SSOT 수정 요청</action>
           <return-to-phase>planning</return-to-phase>
         </level>
         <level id="3" severity="Critical" route="User">
@@ -127,7 +127,7 @@
         <level id="1" severity="Low,Medium" route="tsq-developer">
           <triggers>코드 수준 보안 이슈</triggers>
         </level>
-        <level id="2" severity="High" route="tsq-planner">
+        <level id="2" severity="High" route="tsq-architect">
           <triggers>설계 수준 보안 이슈</triggers>
         </level>
         <level id="3" severity="Critical" route="User">
@@ -188,8 +188,8 @@
       </step>
       <step id="2" action="fallback-agent">
         <description>폴백 에이전트로 위임 (workflow에 정의된 fallback)</description>
-        <example>tsq-frontend 실패 → tsq-developer로 폴백</example>
-        <example>tsq-dba 실패 → tsq-planner(architect)로 폴백</example>
+        <example>tsq-developer 실패 → tsq-developer로 폴백</example>
+        <example>tsq-dba 실패 → tsq-architect(architect)로 폴백</example>
       </step>
       <step id="3" action="pm-direct">
         <description>PM(현재 에이전트)이 직접 처리</description>

package/templates/base/timsquad/retrospective/cycle-report.template.md

@@ -46,14 +46,14 @@ status: draft
 
 | 에이전트 | 작업 수 | 성공률 | 평균 수정 | 점수 | 추세 |
 |---------|:-------:|:------:|:--------:|:----:|:----:|
-| tsq-planner | {{PLANNER_TASKS}} | {{PLANNER_SUCCESS}}% | {{PLANNER_REVISIONS}} | {{PLANNER_SCORE}} | {{PLANNER_TREND}} |
+| tsq-architect | {{PLANNER_TASKS}} | {{PLANNER_SUCCESS}}% | {{PLANNER_REVISIONS}} | {{PLANNER_SCORE}} | {{PLANNER_TREND}} |
 | tsq-developer | {{DEVELOPER_TASKS}} | {{DEVELOPER_SUCCESS}}% | {{DEVELOPER_REVISIONS}} | {{DEVELOPER_SCORE}} | {{DEVELOPER_TREND}} |
 | tsq-qa | {{QA_TASKS}} | {{QA_SUCCESS}}% | {{QA_REVISIONS}} | {{QA_SCORE}} | {{QA_TREND}} |
 | tsq-security | {{SECURITY_TASKS}} | {{SECURITY_SUCCESS}}% | {{SECURITY_REVISIONS}} | {{SECURITY_SCORE}} | {{SECURITY_TREND}} |
 
 ### 3.2 에이전트별 세부 분석
 
-#### tsq-planner
+#### tsq-architect
 - **강점**: {{PLANNER_STRENGTHS}}
 - **개선 필요**: {{PLANNER_IMPROVEMENTS}}
 - **주요 이슈**: {{PLANNER_ISSUES}}

package/templates/base/timsquad/retrospective/patterns/failure-patterns.md

@@ -175,7 +175,7 @@ CM (커뮤니케이션)  : ██░░░░░░░░ 10%
 
 | 에이전트 | 연관 패턴 수 | 주요 카테고리 |
 |---------|:-----------:|-------------|
-| tsq-planner | 0 | - |
+| tsq-architect | 0 | - |
 | tsq-developer | 0 | - |
 | tsq-qa | 0 | - |
 | tsq-security | 0 | - |

package/templates/base/timsquad/retrospective/patterns/success-patterns.md

@@ -67,7 +67,7 @@ last_updated: {{TIMESTAMP}}
 | **카테고리** | DC (문서화) |
 | **최초 발견** | - |
 | **적용 횟수** | 0회 |
-| **관련 에이전트** | tsq-planner, tsq-developer |
+| **관련 에이전트** | tsq-architect, tsq-developer |
 | **검증 상태** | standard |
 
 **패턴 설명**
@@ -184,7 +184,7 @@ last_updated: {{TIMESTAMP}}
 | **카테고리** | DC (문서화) |
 | **최초 발견** | - |
 | **적용 횟수** | 0회 |
-| **관련 에이전트** | tsq-planner |
+| **관련 에이전트** | tsq-architect |
 | **검증 상태** | validated |
 
 **패턴 설명**

package/templates/base/timsquad/retrospective/retrospective-state.xml

@@ -56,7 +56,7 @@
 
     <agents>
       <!--
-      <agent id="tsq-planner">
+      <agent id="tsq-architect">
         <tasks-completed>0</tasks-completed>
         <success-rate>0</success-rate>
         <avg-revisions>0</avg-revisions>
@@ -124,7 +124,7 @@
         <occurrences>5</occurrences>
         <success-rate>95</success-rate>
         <related-agents>
-          <agent>tsq-planner</agent>
+          <agent>tsq-architect</agent>
           <agent>tsq-developer</agent>
         </related-agents>
         <factor>명확한 계약서 역할</factor>

package/templates/base/timsquad/ssot/audit-trail-spec.template.md

@@ -0,0 +1,155 @@
+---
+title: "감사 추적 명세서 (Audit Trail Specification)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-security
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 감사 추적 명세서 (Audit Trail Specification)
+
+> 시스템 내 모든 주요 활동의 감사 추적(Audit Trail)을 설계합니다.
+> 보안 사고 대응, 분쟁 해결, 규제 준수를 위한 추적성을 보장합니다.
+
+---
+
+## 1. 감사 대상
+
+### 1.1 이벤트 분류
+
+| 분류 | 이벤트 | 보존 기간 | 필수 |
+|-----|--------|:--------:|:----:|
+| 인증 | 로그인, 로그아웃, MFA | 5년 | ✅ |
+| 인가 | 권한 변경, 역할 부여/회수 | 영구 | ✅ |
+| 데이터 접근 | 민감 데이터 조회 | 5년 | ✅ |
+| 데이터 변경 | 생성, 수정, 삭제 | 영구 | ✅ |
+| 거래 | 주문, 결제, 환불, 정산 | 5년 | ✅ |
+| 시스템 | 배포, 설정 변경, 장애 | 3년 | ✅ |
+| 관리자 | 관리자 패널 모든 작업 | 영구 | ✅ |
+
+### 1.2 감사 레벨
+
+| 레벨 | 설명 | 적용 |
+|-----|------|------|
+| L1 | 이벤트 발생 기록 (who, when, what) | 모든 이벤트 |
+| L2 | 변경 전/후 데이터 (before/after) | 데이터 변경 |
+| L3 | 전체 요청/응답 페이로드 | 금융 거래 |
+
+---
+
+## 2. 감사 로그 스키마
+
+### 2.1 기본 필드
+
+```json
+{
+  "id": "audit_abc123",
+  "timestamp": "2026-01-01T00:00:00.000Z",
+  "event_type": "ORDER_CREATED",
+  "category": "transaction",
+  "level": "L2",
+  "actor": {
+    "user_id": "user_123",
+    "ip_address": "1.2.3.4",
+    "user_agent": "Mozilla/5.0...",
+    "session_id": "sess_456"
+  },
+  "target": {
+    "entity_type": "order",
+    "entity_id": "order_789",
+    "path": "/api/orders"
+  },
+  "changes": {
+    "before": null,
+    "after": { "status": "created", "amount": 50000 }
+  },
+  "metadata": {
+    "trace_id": "trace_xyz",
+    "service": "order-service",
+    "version": "1.2.3"
+  },
+  "result": "success"
+}
+```
+
+### 2.2 이벤트 타입
+
+| 카테고리 | 이벤트 타입 | 레벨 | 설명 |
+|---------|-----------|:----:|------|
+| auth | `LOGIN_SUCCESS` | L1 | 로그인 성공 |
+| auth | `LOGIN_FAILURE` | L1 | 로그인 실패 (사유 포함) |
+| auth | `TOKEN_REFRESH` | L1 | 토큰 갱신 |
+| auth | `MFA_VERIFIED` | L1 | MFA 인증 |
+| authz | `ROLE_ASSIGNED` | L2 | 역할 부여 |
+| authz | `PERMISSION_CHANGED` | L2 | 권한 변경 |
+| data | `RECORD_CREATED` | L2 | 데이터 생성 |
+| data | `RECORD_UPDATED` | L2 | 데이터 수정 (before/after) |
+| data | `RECORD_DELETED` | L2 | 데이터 삭제 (before 포함) |
+| data | `SENSITIVE_DATA_ACCESS` | L1 | 민감 데이터 조회 |
+| txn | `ORDER_CREATED` | L3 | 주문 생성 |
+| txn | `PAYMENT_PROCESSED` | L3 | 결제 처리 |
+| txn | `REFUND_ISSUED` | L3 | 환불 처리 |
+| system | `CONFIG_CHANGED` | L2 | 시스템 설정 변경 |
+| system | `DEPLOYMENT` | L1 | 서비스 배포 |
+
+---
+
+## 3. 저장 아키텍처
+
+### 3.1 저장소 구성
+
+| 저장소 | 용도 | 보존 | 접근 |
+|-------|------|------|------|
+| Hot (DB) | 최근 로그 조회 | 30일 | 실시간 검색 |
+| Warm (Object Storage) | 중기 보관 | 1년 | 일괄 검색 |
+| Cold (Archive) | 장기 보관 | 5년+ | 복원 후 검색 |
+
+### 3.2 무결성 보장
+
+| 방법 | 설명 |
+|-----|------|
+| 쓰기 전용 | 감사 로그는 수정/삭제 불가 (append-only) |
+| 해시 체인 | 각 로그에 이전 해시 포함 → 변조 감지 |
+| 타임스탬프 | 신뢰할 수 있는 시간 소스 (NTP) |
+| 접근 제어 | 쓰기: 시스템만 / 읽기: 감사 권한 필요 |
+
+---
+
+## 4. 검색 및 조회
+
+### 4.1 검색 필드
+
+| 필드 | 인덱스 | 검색 예시 |
+|-----|:------:|----------|
+| actor.user_id | ✅ | 특정 사용자의 모든 활동 |
+| event_type | ✅ | 모든 로그인 실패 |
+| target.entity_id | ✅ | 특정 주문의 모든 변경 |
+| timestamp | ✅ | 기간별 조회 |
+| result | ✅ | 실패한 작업만 |
+
+### 4.2 조회 API
+
+| 엔드포인트 | 용도 | 권한 |
+|-----------|------|------|
+| `GET /api/audit/search` | 조건부 검색 | AUDITOR+ |
+| `GET /api/audit/:id` | 단건 상세 | AUDITOR+ |
+| `GET /api/audit/entity/:type/:id` | 엔티티 이력 | AUDITOR+ |
+| `GET /api/audit/user/:id` | 사용자 활동 | AUDITOR+ |
+| `POST /api/audit/export` | CSV/JSON 내보내기 | ADMIN |
+
+---
+
+## 5. 관련 문서
+
+- [컴플라이언스 매트릭스](./compliance-matrix.md) — 규제 요구사항
+- [보안 명세](./security-spec.md) — 접근 제어 정책
+- [데이터 설계](./data-design.md) — 감사 테이블 스키마
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-security | 초기 작성 |

package/templates/base/timsquad/ssot/compliance-matrix.template.md

@@ -0,0 +1,105 @@
+---
+title: "컴플라이언스 매트릭스 (Compliance Matrix)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-security
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 컴플라이언스 매트릭스 (Compliance Matrix)
+
+> 프로젝트에 적용되는 법규, 산업 표준, 내부 정책의 준수 현황을 추적합니다.
+> 프로젝트 특성에 맞는 규제 항목을 선택하여 사용하세요.
+
+---
+
+## 1. 적용 규제
+
+### 1.1 법률/규정
+
+| 규제 | 관할 | 적용 범위 | 필수 여부 | 상태 |
+|-----|------|----------|:--------:|:----:|
+| 개인정보보호법 | 대한민국 | 개인정보 처리 | ✅ | ⏳ |
+| 정보통신망법 | 대한민국 | 정보통신 서비스 | 조건부 | - |
+| GDPR | EU | EU 사용자 대상 | 조건부 | - |
+<!-- 금융: 전자금융거래법, 신용정보법 → fintech override 참조 -->
+<!-- 의료: 의료법, 개인정보보호법 특례 → 해당 시 추가 -->
+
+### 1.2 산업 표준
+
+| 표준 | 적용 범위 | 인증 필요 | 상태 |
+|-----|----------|:--------:|:----:|
+| ISO 27001 | 정보보안 관리 | 권장 | - |
+| SOC 2 Type II | 서비스 신뢰성 | 권장 | - |
+<!-- 금융: PCI DSS, ISMS-P → fintech override 참조 -->
+
+---
+
+## 2. 요구사항 매트릭스
+
+### 2.1 데이터 보호
+
+| 요구사항 | 근거 규제 | 구현 방법 | 담당 | 상태 |
+|---------|----------|----------|------|:----:|
+| 개인정보 암호화 (저장) | 개인정보보호법 §29 | AES-256 | 개발팀 | ⏳ |
+| 개인정보 암호화 (전송) | 개인정보보호법 §29 | TLS 1.3 | 인프라 | ⏳ |
+| 개인정보 수집 동의 | 개인정보보호법 §15 | 동의 UI + 로그 | 개발팀 | ⏳ |
+| 개인정보 파기 | 개인정보보호법 §21 | 자동 파기 배치 | 개발팀 | ⏳ |
+| 접근 권한 관리 | 개인정보보호법 §29 | RBAC | 개발팀 | ⏳ |
+
+### 2.2 인프라/보안
+
+| 요구사항 | 근거 규제 | 구현 방법 | 담당 | 상태 |
+|---------|----------|----------|------|:----:|
+| 취약점 점검 | ISO 27001 | 정기 스캔 | 보안팀 | ⏳ |
+| 접근 로그 보관 | 개인정보보호법 | 중앙 로그 시스템 | 인프라 | ⏳ |
+| 네트워크 분리 | 보안 기준 | VPC 분리 | 인프라 | ⏳ |
+<!-- 금융 특화(FDS, PCI DSS 등)는 fintech override에서 추가 -->
+
+---
+
+## 3. 인증/심사 일정
+
+| 인증 | 심사 유형 | 예정일 | 담당 | 상태 |
+|-----|---------|-------|------|:----:|
+| ISO 27001 | 최초 인증 | TBD | 보안팀 | 계획 |
+<!-- 금융: PCI DSS, ISMS-P → fintech override 참조 -->
+
+---
+
+## 4. 준수 체크리스트
+
+### 4.1 출시 전 필수
+
+- [ ] 개인정보 처리방침 작성 및 게시
+- [ ] 이용약관 법률 검토 완료
+- [ ] 개인정보 영향평가 (해당 시)
+- [ ] 보안 취약점 점검 완료
+- [ ] 암호화 적용 확인 (저장 + 전송)
+- [ ] 접근 로그 보관 정책 적용
+
+### 4.2 운영 중 정기
+
+| 주기 | 점검 항목 |
+|-----|----------|
+| 월간 | 접근 권한 리뷰 |
+| 분기 | 취약점 점검 |
+| 반기 | 개인정보 처리 현황 점검 |
+| 연간 | 침투 테스트, 인증 갱신 |
+
+---
+
+## 5. 관련 문서
+
+- [보안 명세](./security-spec.md) — 보안 정책 상세
+- [감사 추적 명세](./audit-trail-spec.md) — 감사 로그 설계
+- [데이터 설계](./data-design.md) — 암호화 필드
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-security | 초기 작성 |