timsquad 2.0.0

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

@@ -0,0 +1,210 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  TimSquad Retrospective State
+
+  회고 사이클 상태를 실시간으로 추적합니다.
+  XPath로 특정 노드에 효율적으로 접근 가능합니다.
+
+  주요 XPath:
+  - /retrospective-state/current-cycle/@number
+  - /retrospective-state/current-cycle/status
+  - /retrospective-state/metrics/agents/agent[@id='tsq-developer']/score
+  - /retrospective-state/patterns/failure/pattern[@status='active']
+-->
+<retrospective-state>
+  <metadata>
+    <project>{{PROJECT_NAME}}</project>
+    <created>{{TIMESTAMP}}</created>
+    <last-updated>{{TIMESTAMP}}</last-updated>
+    <version>1.0</version>
+  </metadata>
+
+  <!-- ============================================================
+       현재 회고 사이클
+       ============================================================ -->
+  <current-cycle number="0">
+    <status>inactive</status>
+    <!-- 상태: inactive | collecting | analyzing | reporting | applying | completed -->
+
+    <period>
+      <start></start>
+      <end></end>
+    </period>
+
+    <phase-at-start></phase-at-start>
+    <phase-at-end></phase-at-end>
+
+    <progress>
+      <step id="collect" status="pending">로그/메트릭 수집</step>
+      <step id="analyze" status="pending">패턴 분석</step>
+      <step id="report" status="pending">리포트 작성</step>
+      <step id="review" status="pending">검토/승인</step>
+      <step id="apply" status="pending">개선 적용</step>
+    </progress>
+  </current-cycle>
+
+  <!-- ============================================================
+       수집된 메트릭 (현재 사이클)
+       ============================================================ -->
+  <metrics>
+    <summary>
+      <total-tasks>0</total-tasks>
+      <success-rate>0</success-rate>
+      <avg-revision-count>0</avg-revision-count>
+      <level3-feedback-count>0</level3-feedback-count>
+    </summary>
+
+    <agents>
+      <!--
+      <agent id="tsq-planner">
+        <tasks-completed>0</tasks-completed>
+        <success-rate>0</success-rate>
+        <avg-revisions>0</avg-revisions>
+        <score>0</score>
+        <trend>0</trend>
+        <competency-scores>
+          <competency name="documentation">0</competency>
+          <competency name="architecture">0</competency>
+          <competency name="communication">0</competency>
+        </competency-scores>
+      </agent>
+
+      <agent id="tsq-developer">
+        <tasks-completed>0</tasks-completed>
+        <success-rate>0</success-rate>
+        <avg-revisions>0</avg-revisions>
+        <score>0</score>
+        <trend>0</trend>
+        <competency-scores>
+          <competency name="coding">0</competency>
+          <competency name="testing">0</competency>
+          <competency name="debugging">0</competency>
+        </competency-scores>
+      </agent>
+      -->
+    </agents>
+
+    <feedback>
+      <total>0</total>
+      <by-level>
+        <level-1>0</level-1>
+        <level-2>0</level-2>
+        <level-3>0</level-3>
+      </by-level>
+      <avg-resolution-time unit="minutes">0</avg-resolution-time>
+    </feedback>
+  </metrics>
+
+  <!-- ============================================================
+       식별된 패턴 (현재 사이클)
+       ============================================================ -->
+  <patterns>
+    <failure>
+      <!--
+      <pattern id="FP-001" status="active">
+        <name>SSOT 미참조 구현</name>
+        <category>DM</category>
+        <occurrences>3</occurrences>
+        <first-seen>2026-02-01</first-seen>
+        <last-seen>2026-02-03</last-seen>
+        <affected-agents>
+          <agent>tsq-developer</agent>
+        </affected-agents>
+        <cause>구현 전 SSOT 확인 단계 생략</cause>
+        <suggested-improvement ref="IMP-001"/>
+      </pattern>
+      -->
+    </failure>
+
+    <success>
+      <!--
+      <pattern id="SP-001" status="validated">
+        <name>SSOT 먼저, 코드 나중</name>
+        <category>DC</category>
+        <occurrences>5</occurrences>
+        <success-rate>95</success-rate>
+        <related-agents>
+          <agent>tsq-planner</agent>
+          <agent>tsq-developer</agent>
+        </related-agents>
+        <factor>명확한 계약서 역할</factor>
+        <standardization-status>applied</standardization-status>
+      </pattern>
+      -->
+    </success>
+  </patterns>
+
+  <!-- ============================================================
+       제안된 개선 사항 (현재 사이클)
+       ============================================================ -->
+  <improvements>
+    <!--
+    <improvement id="IMP-001" status="proposed">
+      <type>prompt</type>
+      <target>tsq-developer.md</target>
+      <description>SSOT 참조 체크리스트 추가</description>
+      <related-pattern ref="FP-001"/>
+      <proposed-at>2026-02-03T10:00:00</proposed-at>
+      <proposed-by>tsq-retro</proposed-by>
+      <reviewed-at></reviewed-at>
+      <reviewed-by></reviewed-by>
+      <applied-at></applied-at>
+      <diff>
+        <![CDATA[
+        + ## 작업 전 체크리스트
+        + - [ ] service-spec.md 확인
+        + - [ ] data-design.md 확인
+        + - [ ] error-codes.md 확인
+        ]]>
+      </diff>
+    </improvement>
+    -->
+  </improvements>
+
+  <!-- ============================================================
+       이전 사이클 요약 (최근 5개)
+       ============================================================ -->
+  <history>
+    <!--
+    <cycle number="1" status="completed">
+      <period start="2026-01-15" end="2026-01-28"/>
+      <summary>
+        <total-tasks>45</total-tasks>
+        <success-rate>87.5</success-rate>
+        <patterns-identified>3</patterns-identified>
+        <improvements-applied>2</improvements-applied>
+      </summary>
+      <report-path>.timsquad/retrospective/cycles/cycle-1.md</report-path>
+    </cycle>
+    -->
+  </history>
+
+  <!-- ============================================================
+       다음 사이클 목표
+       ============================================================ -->
+  <next-cycle-goals>
+    <!--
+    <goal id="1">
+      <metric>success_rate</metric>
+      <target>90%</target>
+      <current-baseline>87.5%</current-baseline>
+    </goal>
+    <goal id="2">
+      <metric>level3_feedback_count</metric>
+      <target>&lt; 3</target>
+      <current-baseline>5</current-baseline>
+    </goal>
+    -->
+  </next-cycle-goals>
+
+  <!-- ============================================================
+       세션 노트
+       ============================================================ -->
+  <session-notes>
+    <!--
+    <note timestamp="2026-02-03T10:00:00" agent="tsq-retro">
+      Cycle 1 분석 시작. 로그 45건 수집됨.
+    </note>
+    -->
+  </session-notes>
+</retrospective-state>

package/templates/common/timsquad/ssot/adr/ADR-000-template.md

@@ -0,0 +1,121 @@
+# ADR-{번호}: {결정 제목}
+
+## 메타데이터
+| 항목 | 내용 |
+|-----|------|
+| **상태** | 제안됨 / 승인됨 / 폐기됨 / 대체됨 |
+| **작성자** | @{작성자} |
+| **작성일** | YYYY-MM-DD |
+| **승인일** | YYYY-MM-DD |
+| **대체** | (이 ADR이 대체하는 이전 ADR, 있으면) |
+| **태그** | #auth #frontend #architecture 등 |
+
+---
+
+## 맥락 (Context)
+> 이 결정이 필요한 배경. 어떤 문제/상황에 직면했는가?
+
+{배경 설명}
+
+**관련 요구사항:**
+- [requirements.md#기능명](../requirements.md#기능명)
+- [service-spec.md#API명](../service-spec.md#API명)
+
+---
+
+## 결정 (Decision)
+> 무엇을 결정했는가? 명확하고 간결하게.
+
+**{결정 내용 한 줄 요약}**
+
+{상세 설명 (필요시)}
+
+---
+
+## 이유 (Rationale)
+> 왜 이 결정을 내렸는가? 가장 중요한 섹션.
+
+### 핵심 이유
+1. **{이유 1 제목}**: {설명}
+2. **{이유 2 제목}**: {설명}
+3. **{이유 3 제목}**: {설명}
+
+### 근거 자료
+| 유형 | 링크/출처 | 요약 |
+|-----|----------|-----|
+| UX 리서치 | [Figma](링크) | 사용자 테스트 결과 A안 선호 |
+| 기술 문서 | [공식문서](링크) | 권장 패턴 |
+| 팀 논의 | Slack #channel MM/DD | 합의 내용 |
+| 벤치마크 | [블로그](링크) | 성능 비교 |
+| 경쟁사 분석 | 내부 문서 | A사, B사 동일 방식 |
+
+---
+
+## 대안 검토 (Alternatives Considered)
+> 어떤 대안들을 검토했고, 왜 선택하지 않았는가?
+
+### 대안 1: {대안명}
+- **설명**: {대안 설명}
+- **장점**: {장점}
+- **단점**: {단점}
+- **탈락 이유**: {왜 선택 안 했는지}
+
+### 대안 2: {대안명}
+- **설명**: {대안 설명}
+- **장점**: {장점}
+- **단점**: {단점}
+- **탈락 이유**: {왜 선택 안 했는지}
+
+### 비교 요약
+| 기준 | 선택안 ✅ | 대안 1 | 대안 2 |
+|-----|---------|-------|-------|
+| 성능 | ⭐⭐⭐ | ⭐⭐ | ⭐ |
+| 구현 복잡도 | ⭐⭐ | ⭐⭐⭐ | ⭐ |
+| 유지보수 | ⭐⭐⭐ | ⭐ | ⭐⭐ |
+| 확장성 | ⭐⭐⭐ | ⭐⭐ | ⭐ |
+
+---
+
+## 결과 (Consequences)
+> 이 결정으로 인한 영향. 좋은 점과 주의할 점 모두.
+
+### 긍정적 결과
+- {좋은 점 1}
+- {좋은 점 2}
+
+### 부정적 결과 / 트레이드오프
+- {주의할 점 1}
+- {주의할 점 2}
+
+### 영향받는 영역
+- **코드**: `src/path/to/affected`
+- **문서**: [service-spec.md](../service-spec.md)
+- **팀**: Frontend, Backend
+
+---
+
+## 구현 가이드 (Implementation Notes)
+> 이 결정을 구현할 때 참고할 사항 (선택적)
+
+```typescript
+// 예시 코드 또는 패턴
+```
+
+**주의사항:**
+- {구현 시 주의할 점}
+
+---
+
+## 관련 문서 (Related)
+- **SSOT**: [관련 문서](링크)
+- **이전 ADR**: [ADR-XXX](링크)
+- **이슈/티켓**: [JIRA-123](링크)
+- **PR**: [#456](링크)
+
+---
+
+## 변경 이력
+| 날짜 | 변경 내용 | 작성자 |
+|-----|---------|-------|
+| YYYY-MM-DD | 최초 작성 | @작성자 |
+| YYYY-MM-DD | 상태 변경: 제안됨 → 승인됨 | @승인자 |

package/templates/common/timsquad/ssot/adr/ADR-001-example.md

@@ -0,0 +1,115 @@
+# ADR-001: 소셜 로그인만 지원 (이메일/비밀번호 로그인 제외)
+
+## 메타데이터
+| 항목 | 내용 |
+|-----|------|
+| **상태** | 승인됨 |
+| **작성자** | @planner |
+| **작성일** | 2026-01-15 |
+| **승인일** | 2026-01-16 |
+| **태그** | #auth #ux #security |
+
+---
+
+## 맥락 (Context)
+MVP 출시를 위한 인증 방식 결정 필요. 개발 리소스 제한(2주)과 보안 요구사항 고려.
+
+**관련 요구사항:**
+- [requirements.md#auth](../requirements.md#auth)
+- [security-spec.md#인증](../security-spec.md#인증)
+
+---
+
+## 결정 (Decision)
+**MVP에서는 소셜 로그인(Google, Apple)만 지원. 이메일/비밀번호 로그인은 v1.1에서 검토.**
+
+---
+
+## 이유 (Rationale)
+
+### 핵심 이유
+1. **보안 부담 감소**: 비밀번호 저장/해싱/재설정 로직 불필요. 보안 사고 리스크 ↓
+2. **개발 속도**: 인증 구현 2주 → 3일로 단축
+3. **사용자 경험**: 원클릭 로그인. 가입 전환율 높음 (업계 평균 +40%)
+4. **타겟 사용자**: 20-30대 테크 친화적 사용자. 소셜 로그인 거부감 낮음
+
+### 근거 자료
+| 유형 | 링크/출처 | 요약 |
+|-----|----------|-----|
+| 사용자 조사 | [설문 결과](notion.so/xxx) | 응답자 87% 소셜 로그인 선호 |
+| 경쟁사 분석 | 내부 문서 | Notion, Linear 초기 소셜만 지원 |
+| 보안 가이드 | OWASP | 비밀번호 관리 복잡성 경고 |
+| 팀 논의 | Slack #product 01/14 | CEO, CTO 합의 |
+
+---
+
+## 대안 검토 (Alternatives Considered)
+
+### 대안 1: 이메일/비밀번호만
+- **장점**: 소셜 계정 없는 사용자 커버
+- **단점**: 보안 구현 복잡, 비밀번호 재설정 필요
+- **탈락 이유**: MVP 일정 초과, 보안 리스크
+
+### 대안 2: 소셜 + 이메일 둘 다
+- **장점**: 모든 사용자 커버
+- **단점**: 개발 기간 2배, 계정 연동 이슈
+- **탈락 이유**: MVP 범위 초과
+
+### 비교 요약
+| 기준 | 소셜만 ✅ | 이메일만 | 둘 다 |
+|-----|---------|--------|------|
+| 개발 기간 | ⭐⭐⭐ (3일) | ⭐⭐ (2주) | ⭐ (3주) |
+| 보안 | ⭐⭐⭐ | ⭐ | ⭐⭐ |
+| 사용자 커버리지 | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ |
+| UX | ⭐⭐⭐ | ⭐ | ⭐⭐ |
+
+---
+
+## 결과 (Consequences)
+
+### 긍정적 결과
+- 인증 구현 3일 완료
+- 비밀번호 관련 보안 이슈 원천 차단
+- 가입 전환율 예상치 상회
+
+### 부정적 결과 / 트레이드오프
+- 소셜 계정 없는 사용자 이탈 (예상 3-5%)
+- Google/Apple 장애 시 로그인 불가
+- B2B 확장 시 기업 SSO 추가 필요
+
+### 영향받는 영역
+- **코드**: `src/auth/`, `src/middleware/`
+- **문서**: [service-spec.md#auth](../service-spec.md#auth)
+- **팀**: Backend, Frontend
+
+---
+
+## 구현 가이드 (Implementation Notes)
+
+```typescript
+// OAuth 프로바이더 설정
+const authProviders = ['google', 'apple'] as const;
+
+// 이메일/비밀번호 엔드포인트는 구현하지 않음
+// POST /auth/register ❌
+// POST /auth/login ❌
+// POST /auth/forgot-password ❌
+```
+
+**v1.1 고려사항:**
+- 이메일 로그인 추가 시 기존 소셜 계정과 연동 로직 필요
+- Magic Link 방식 검토 (비밀번호 없는 이메일 로그인)
+
+---
+
+## 관련 문서 (Related)
+- **SSOT**: [service-spec.md#auth](../service-spec.md#auth)
+- **이슈**: [JIRA-AUTH-001](링크)
+
+---
+
+## 변경 이력
+| 날짜 | 변경 내용 | 작성자 |
+|-----|---------|-------|
+| 2026-01-15 | 최초 작성 | @planner |
+| 2026-01-16 | 승인 | @leader |

package/templates/common/timsquad/ssot/data-design.template.md

@@ -0,0 +1,132 @@
+# {PROJECT_NAME} 데이터 설계서
+
+**Version**: 1.0
+**Created**: {DATE}
+**Database**: PostgreSQL / MySQL / MongoDB
+
+---
+
+## 1. ERD
+
+```
+┌─────────────────┐       ┌─────────────────┐
+│     users       │       │     posts       │
+├─────────────────┤       ├─────────────────┤
+│ id (PK)         │───┐   │ id (PK)         │
+│ email           │   │   │ user_id (FK)    │──┐
+│ name            │   └──▶│ title           │  │
+│ password_hash   │       │ content         │  │
+│ created_at      │       │ created_at      │  │
+│ updated_at      │       │ updated_at      │  │
+└─────────────────┘       └─────────────────┘  │
+                                               │
+                          ┌─────────────────┐  │
+                          │    comments     │  │
+                          ├─────────────────┤  │
+                          │ id (PK)         │  │
+                          │ post_id (FK)    │◀─┘
+                          │ user_id (FK)    │
+                          │ content         │
+                          │ created_at      │
+                          └─────────────────┘
+```
+
+---
+
+## 2. 테이블 정의
+
+### 2.1 users
+
+사용자 정보를 저장하는 테이블.
+
+| Column | Type | Nullable | Default | Description |
+|--------|------|:--------:|---------|-------------|
+| id | UUID | NO | gen_random_uuid() | PK |
+| email | VARCHAR(255) | NO | | 이메일 (UNIQUE) |
+| name | VARCHAR(100) | NO | | 이름 |
+| password_hash | VARCHAR(255) | NO | | 암호화된 비밀번호 |
+| status | VARCHAR(20) | NO | 'active' | active, inactive, suspended |
+| created_at | TIMESTAMP | NO | now() | 생성일 |
+| updated_at | TIMESTAMP | NO | now() | 수정일 |
+
+**Indexes:**
+| Name | Columns | Type | Description |
+|------|---------|------|-------------|
+| users_pkey | id | PK | |
+| users_email_unique | email | UNIQUE | 이메일 중복 방지 |
+| users_status_idx | status | INDEX | 상태 조회용 |
+
+---
+
+### 2.2 [table_name]
+
+[테이블 설명]
+
+| Column | Type | Nullable | Default | Description |
+|--------|------|:--------:|---------|-------------|
+| | | | | |
+
+**Indexes:**
+| Name | Columns | Type | Description |
+|------|---------|------|-------------|
+| | | | |
+
+**Foreign Keys:**
+| Column | References | On Delete | On Update |
+|--------|------------|-----------|-----------|
+| | | | |
+
+---
+
+## 3. ENUM 정의
+
+### 3.1 user_status
+
+| Value | Description |
+|-------|-------------|
+| active | 활성 |
+| inactive | 비활성 |
+| suspended | 정지 |
+
+---
+
+## 4. 데이터 마이그레이션
+
+### 4.1 초기 데이터
+
+```sql
+-- Admin 사용자
+INSERT INTO users (email, name, password_hash, status)
+VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
+```
+
+### 4.2 마이그레이션 이력
+
+| Version | Date | Description |
+|---------|------|-------------|
+| 001 | {DATE} | 초기 스키마 생성 |
+
+---
+
+## 5. 백업 및 복구
+
+### 5.1 백업 정책
+
+| 유형 | 주기 | 보존 기간 |
+|-----|-----|----------|
+| Full Backup | 일 1회 | 30일 |
+| Incremental | 시간 1회 | 7일 |
+
+### 5.2 복구 절차
+
+1.
+2.
+3.
+
+---
+
+## 6. 변경 이력
+
+| 버전 | 날짜 | 변경 내용 | 작성자 |
+|-----|-----|----------|-------|
+| 1.0 | {DATE} | 최초 작성 | |