timsquad 2.0.0

package/templates/common/timsquad/generators/requirements.xml

@@ -0,0 +1,220 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  TimSquad Requirements Generator v1.0
+  PRD를 기반으로 상세 요구사항을 정의합니다.
+-->
+<generator name="requirements" version="1.0" output=".timsquad/ssot/requirements.md">
+  <metadata>
+    <description>요구사항 정의서 생성기</description>
+    <purpose>PRD의 기능을 상세 요구사항으로 분해</purpose>
+    <depends-on>prd.md</depends-on>
+  </metadata>
+
+  <instructions>
+    <![CDATA[
+    PRD를 먼저 읽고, 각 기능별로 상세 요구사항을 정의합니다.
+
+    1. prd.md에서 기능 목록을 읽어옵니다
+    2. 각 기능별로 유저 스토리와 상세 요구사항을 질문합니다
+    3. 비기능 요구사항(성능, 보안 등)도 정의합니다
+
+    정제 원칙:
+    - 유저 스토리: "~로서, ~하고 싶다, ~하기 위해" 형식
+    - 요구사항: "시스템은 ~해야 한다" 형식
+    - 테스트 가능한 수준으로 구체화
+    ]]>
+  </instructions>
+
+  <!-- ============================================================
+       섹션 1: PRD 참조
+       ============================================================ -->
+  <section id="prd_ref" title="PRD 참조" auto-load="true">
+    <source>.timsquad/ssot/prd.md</source>
+    <extract>
+      <field name="features" from="## 2. 핵심 기능" />
+      <field name="target_user" from="타겟 사용자" />
+    </extract>
+  </section>
+
+  <!-- ============================================================
+       섹션 2: 기능 요구사항 (기능별 반복)
+       ============================================================ -->
+  <section id="functional" title="기능 요구사항" repeatable="true" iterate-from="prd_ref.features">
+    <context>
+      현재 기능: {{current_feature.name}}
+      설명: {{current_feature.description}}
+    </context>
+
+    <field name="user_story" type="text" required="true">
+      <prompt>"{{current_feature.name}}" 기능의 유저 스토리를 말해주세요</prompt>
+      <hint>예: 사용자로서, 실력 맞는 상대를 찾고 싶다</hint>
+      <refinement>
+        "{{prd_ref.target_user}}로서, ~하고 싶다, ~하기 위해" 형식으로 정제
+      </refinement>
+    </field>
+
+    <field name="acceptance_criteria" type="list" required="true">
+      <prompt>이 기능이 완료되었다고 할 수 있는 조건은? (여러 개 입력, 빈 줄로 종료)</prompt>
+      <hint>
+        - 매칭 요청 시 3초 내 결과 표시
+        - 최소 3명의 추천 상대 표시
+      </hint>
+      <refinement>
+        - "~할 수 있다", "~된다" 형식
+        - 측정 가능한 기준 포함
+      </refinement>
+    </field>
+
+    <field name="edge_cases" type="list" required="false">
+      <prompt>예외 상황이나 엣지 케이스가 있나요?</prompt>
+      <hint>
+        - 매칭 상대가 없는 경우
+        - 동시에 여러 요청이 온 경우
+      </hint>
+    </field>
+  </section>
+
+  <!-- ============================================================
+       섹션 3: 비기능 요구사항
+       ============================================================ -->
+  <section id="non_functional" title="비기능 요구사항">
+    <field name="performance" type="text" required="false">
+      <prompt>성능 요구사항이 있나요? (응답 시간, 동시 사용자 등)</prompt>
+      <example>API 응답 시간 500ms 이내, 동시 접속 1,000명 지원</example>
+      <default>API 응답 시간 1초 이내</default>
+    </field>
+
+    <field name="security" type="list" required="false">
+      <prompt>보안 요구사항이 있나요?</prompt>
+      <example>
+        - 개인정보 암호화 저장
+        - JWT 기반 인증
+      </example>
+      <default>
+        - HTTPS 필수
+        - 비밀번호 해시 저장
+        - JWT 인증
+      </default>
+    </field>
+
+    <field name="availability" type="text" required="false">
+      <prompt>가용성 요구사항? (예: 99.9% uptime)</prompt>
+      <default>99% uptime (MVP 기준)</default>
+    </field>
+
+    <field name="scalability" type="text" required="false">
+      <prompt>확장성 요구사항?</prompt>
+      <default>수평 확장 가능한 구조</default>
+    </field>
+  </section>
+
+  <!-- ============================================================
+       섹션 4: 제약사항
+       ============================================================ -->
+  <section id="constraints" title="제약사항">
+    <field name="tech_constraints" type="list" required="false">
+      <prompt>기술적 제약사항이 있나요?</prompt>
+      <example>
+        - iOS/Android 앱 없음 (웹 전용)
+        - 실시간 기능은 Supabase Realtime 사용
+      </example>
+    </field>
+
+    <field name="business_constraints" type="list" required="false">
+      <prompt>비즈니스 제약사항이 있나요?</prompt>
+      <example>
+        - MVP는 싱가폴 지역만
+        - 초기 무료, 추후 프리미엄 모델
+      </example>
+    </field>
+  </section>
+
+  <!-- ============================================================
+       출력 템플릿
+       ============================================================ -->
+  <output-template>
+    <![CDATA[
+# {{project_name}} 요구사항 정의서
+
+**생성일**: {{DATE}}
+**버전**: 1.0
+**PRD 참조**: [prd.md](./prd.md)
+
+---
+
+## 1. 기능 요구사항
+
+{{#each functional}}
+### 1.{{@index + 1}} {{feature_name}}
+
+**유저 스토리:**
+> {{user_story}}
+
+**인수 조건:**
+{{#each acceptance_criteria}}
+- [ ] {{this}}
+{{/each}}
+
+{{#if edge_cases}}
+**엣지 케이스:**
+{{#each edge_cases}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+{{/each}}
+
+## 2. 비기능 요구사항
+
+### 2.1 성능
+{{non_functional.performance}}
+
+### 2.2 보안
+{{#each non_functional.security}}
+- {{this}}
+{{/each}}
+
+### 2.3 가용성
+{{non_functional.availability}}
+
+### 2.4 확장성
+{{non_functional.scalability}}
+
+---
+
+## 3. 제약사항
+
+### 3.1 기술적 제약
+{{#each constraints.tech_constraints}}
+- {{this}}
+{{/each}}
+{{#unless constraints.tech_constraints}}
+- (없음)
+{{/unless}}
+
+### 3.2 비즈니스 제약
+{{#each constraints.business_constraints}}
+- {{this}}
+{{/each}}
+{{#unless constraints.business_constraints}}
+- (없음)
+{{/unless}}
+
+---
+
+## 4. 요구사항 추적 매트릭스
+
+| ID | 기능 | 우선순위 | 상태 |
+|----|-----|:-------:|:----:|
+{{#each functional}}
+| REQ-{{@index + 1 | pad:3}} | {{feature_name}} | {{priority}} | ⬜ |
+{{/each}}
+
+---
+
+*Generated by TimSquad v2.0*
+    ]]>
+  </output-template>
+</generator>

package/templates/common/timsquad/generators/service-spec.xml

@@ -0,0 +1,266 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  TimSquad Service Spec Generator v1.0
+  API 명세서를 생성합니다. 프론트엔드-백엔드 계약서 역할.
+-->
+<generator name="service-spec" version="1.0" output=".timsquad/ssot/service-spec.md">
+  <metadata>
+    <description>서비스 명세서 (API Specification) 생성기</description>
+    <purpose>프론트엔드-백엔드 간 API 계약 정의</purpose>
+    <depends-on>prd.md, requirements.md</depends-on>
+  </metadata>
+
+  <instructions>
+    <![CDATA[
+    PRD의 기능 목록을 기반으로 API 엔드포인트를 정의합니다.
+
+    1. 각 기능별로 필요한 API 엔드포인트를 도출
+    2. HTTP 메서드, URL, Request/Response 스키마 정의
+    3. 에러 코드는 error-codes.md와 연동
+
+    정제 원칙:
+    - RESTful 컨벤션 준수
+    - URL: 소문자, 복수형 명사 (/users, /matches)
+    - 응답: { success, data, error } 통일 형식
+    ]]>
+  </instructions>
+
+  <!-- ============================================================
+       섹션 1: API 그룹 정의
+       ============================================================ -->
+  <section id="api_groups" title="API 그룹" repeatable="true">
+    <instructions>
+      기능 단위로 API를 그룹핑합니다.
+      예: Auth, Users, Matches, Messages
+    </instructions>
+
+    <field name="group_name" type="text" required="true">
+      <prompt>API 그룹 이름? (예: Auth, Users, Matches)</prompt>
+      <refinement>영문 대문자 시작, 단수/복수 일관성</refinement>
+    </field>
+
+    <field name="base_path" type="text" required="true">
+      <prompt>기본 경로? (예: /api/v1/auth)</prompt>
+      <auto-suggest>/api/v1/{{group_name | lowercase}}</auto-suggest>
+      <refinement>소문자, 복수형</refinement>
+    </field>
+
+    <field name="description" type="text" required="false">
+      <prompt>이 그룹의 역할?</prompt>
+    </field>
+  </section>
+
+  <!-- ============================================================
+       섹션 2: 엔드포인트 정의 (그룹별 반복)
+       ============================================================ -->
+  <section id="endpoints" title="엔드포인트" repeatable="true" parent="api_groups">
+    <context>현재 그룹: {{current_group.group_name}}</context>
+
+    <field name="name" type="text" required="true">
+      <prompt>엔드포인트 이름? (예: Login, GetProfile)</prompt>
+    </field>
+
+    <field name="method" type="select" required="true">
+      <prompt>HTTP 메서드?</prompt>
+      <options>
+        <option value="GET">GET - 조회</option>
+        <option value="POST">POST - 생성</option>
+        <option value="PUT">PUT - 전체 수정</option>
+        <option value="PATCH">PATCH - 부분 수정</option>
+        <option value="DELETE">DELETE - 삭제</option>
+      </options>
+    </field>
+
+    <field name="path" type="text" required="true">
+      <prompt>경로? (예: /login, /:id)</prompt>
+      <refinement>
+        - 파라미터는 :id 형식
+        - 소문자, 하이픈 구분
+      </refinement>
+    </field>
+
+    <field name="description" type="text" required="true">
+      <prompt>이 API의 역할?</prompt>
+    </field>
+
+    <field name="auth_required" type="boolean" required="true">
+      <prompt>인증 필요? (y/n)</prompt>
+      <default>true</default>
+    </field>
+
+    <field name="request_body" type="schema" required="false">
+      <prompt>Request Body 필드? (필드명:타입 형식, 여러 줄)</prompt>
+      <hint>
+        email:string
+        password:string
+      </hint>
+      <skip-if method="GET|DELETE" />
+    </field>
+
+    <field name="response_data" type="schema" required="true">
+      <prompt>Response data 필드?</prompt>
+      <hint>
+        user:object
+        token:string
+      </hint>
+    </field>
+
+    <field name="errors" type="list" required="false">
+      <prompt>발생 가능한 에러 코드? (예: AUTH_001, AUTH_002)</prompt>
+      <link-to>error-codes.md</link-to>
+    </field>
+  </section>
+
+  <!-- ============================================================
+       섹션 3: 공통 정의
+       ============================================================ -->
+  <section id="common" title="공통 정의">
+    <field name="base_url" type="text" required="true">
+      <prompt>API Base URL?</prompt>
+      <default>https://api.{{project_name}}.com</default>
+    </field>
+
+    <field name="version" type="text" required="true">
+      <prompt>API 버전?</prompt>
+      <default>v1</default>
+    </field>
+
+    <field name="auth_method" type="select" required="true">
+      <prompt>인증 방식?</prompt>
+      <options>
+        <option value="jwt">JWT Bearer Token</option>
+        <option value="session">Session Cookie</option>
+        <option value="api_key">API Key</option>
+      </options>
+      <default>jwt</default>
+    </field>
+  </section>
+
+  <!-- ============================================================
+       출력 템플릿
+       ============================================================ -->
+  <output-template>
+    <![CDATA[
+# {{project_name}} 서비스 명세서
+
+**생성일**: {{DATE}}
+**버전**: {{common.version}}
+**Base URL**: `{{common.base_url}}/{{common.version}}`
+
+---
+
+## 공통 사항
+
+### 인증
+- 방식: {{common.auth_method | upper}}
+{{#if common.auth_method == "jwt"}}
+- Header: `Authorization: Bearer <token>`
+{{/if}}
+
+### 응답 형식
+```json
+{
+  "success": true,
+  "data": { ... },
+  "error": null
+}
+```
+
+### 에러 응답
+```json
+{
+  "success": false,
+  "data": null,
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "에러 메시지"
+  }
+}
+```
+
+---
+
+{{#each api_groups}}
+## {{@index + 1}}. {{group_name}}
+
+> {{description}}
+
+Base Path: `{{base_path}}`
+
+{{#each endpoints where group=group_name}}
+### {{@index + 1}}.{{@parent_index + 1}} {{name}}
+
+| 항목 | 값 |
+|-----|---|
+| **URL** | `{{method}} {{../base_path}}{{path}}` |
+| **설명** | {{description}} |
+| **인증** | {{#if auth_required}}필요{{else}}불필요{{/if}} |
+
+{{#if request_body}}
+#### Request Body
+
+| Field | Type | Required | Description |
+|-------|------|:--------:|-------------|
+{{#each request_body}}
+| {{name}} | {{type}} | {{#if required}}O{{else}}-{{/if}} | {{description}} |
+{{/each}}
+
+```json
+{
+{{#each request_body}}
+  "{{name}}": {{example}}{{#unless @last}},{{/unless}}
+{{/each}}
+}
+```
+{{/if}}
+
+#### Response
+
+| Field | Type | Description |
+|-------|------|-------------|
+{{#each response_data}}
+| {{name}} | {{type}} | {{description}} |
+{{/each}}
+
+```json
+{
+  "success": true,
+  "data": {
+{{#each response_data}}
+    "{{name}}": {{example}}{{#unless @last}},{{/unless}}
+{{/each}}
+  }
+}
+```
+
+{{#if errors}}
+#### Errors
+
+| Code | Description |
+|------|-------------|
+{{#each errors}}
+| {{this}} | → error-codes.md 참조 |
+{{/each}}
+{{/if}}
+
+---
+
+{{/each}}
+{{/each}}
+
+## API 목록 요약
+
+| Group | Method | Endpoint | Description | Auth |
+|-------|--------|----------|-------------|:----:|
+{{#each api_groups}}
+{{#each endpoints where group=group_name}}
+| {{../group_name}} | {{method}} | {{../base_path}}{{path}} | {{name}} | {{#if auth_required}}🔒{{else}}-{{/if}} |
+{{/each}}
+{{/each}}
+
+---
+
+*Generated by TimSquad v2.0*
+    ]]>
+  </output-template>
+</generator>

package/templates/common/timsquad/logs/_example.md

@@ -0,0 +1,81 @@
+# developer 작업 로그 - 2026-02-02
+
+---
+
+## 15:30 | 소셜 로그인 콜백 처리 구현
+
+### What (작업 내용)
+- Google OAuth 콜백 핸들러 구현
+- Apple OAuth 콜백 핸들러 구현
+- 신규 사용자 자동 생성 로직 추가
+- JWT 토큰 발급 및 쿠키 설정
+
+### Why (작업 이유)
+MVP 인증 시스템 구현. 소셜 로그인만 지원하기로 결정되어 Google/Apple OAuth만 구현.
+
+**관련 결정:** [ADR-001 소셜 로그인만 지원](../ssot/adr/ADR-001-social-login-only.md)
+
+### Reference (근거/참조)
+| 유형 | 링크 | 설명 |
+|-----|------|-----|
+| SSOT | [service-spec.md#auth](../ssot/service-spec.md#auth) | 인증 API 명세 |
+| ADR | [ADR-001](../ssot/adr/ADR-001.md) | 소셜 로그인만 지원 결정 |
+| 외부 | [Google OAuth 문서](https://developers.google.com/identity) | 구현 참고 |
+| 외부 | [Apple Sign-in 문서](https://developer.apple.com/sign-in-with-apple/) | 구현 참고 |
+
+### 변경 파일
+```
+src/routes/auth/callback.ts (신규)
+src/services/oauth.service.ts (신규)
+src/services/user.service.ts (수정 - createFromOAuth 추가)
+src/utils/jwt.ts (수정 - 쿠키 설정 옵션 추가)
+```
+
+### 결과
+- ✅ 성공
+- 테스트: 8/8 통과
+- Google 로그인 E2E 확인 완료
+- Apple은 실기기 테스트 필요
+
+### 후속 작업 / 피드백 요청
+- [ ] @qa Apple 로그인 실기기 테스트 요청
+- [ ] @frontend 콜백 후 리다이렉트 URL 협의 필요
+
+---
+
+## 11:00 | 로그인 모달 컴포넌트 구현
+
+### What (작업 내용)
+- LoginModal 컴포넌트 생성
+- Google/Apple 로그인 버튼 추가
+- 모달 열기/닫기 애니메이션
+
+### Why (작업 이유)
+로그인 UI를 별도 페이지가 아닌 모달로 구현. 페이지 이동 없이 빠른 로그인 경험 제공.
+
+**관련 결정:** [ADR-002 로그인 모달 방식](../ssot/adr/ADR-002-login-modal.md)
+
+### Reference (근거/참조)
+| 유형 | 링크 | 설명 |
+|-----|------|-----|
+| SSOT | [ui-ux-spec.md#login-modal](../ssot/ui-ux-spec.md#login-modal) | 모달 디자인 명세 |
+| ADR | [ADR-002](../ssot/adr/ADR-002.md) | 모달 방식 결정 |
+| 외부 | [Radix Dialog](https://radix-ui.com/docs/primitives/components/dialog) | 컴포넌트 참고 |
+| 논의 | Slack #design 02/01 | 애니메이션 방향 논의 |
+
+### 변경 파일
+```
+src/components/auth/LoginModal.tsx (신규)
+src/components/auth/SocialButton.tsx (신규)
+src/hooks/useLoginModal.ts (신규)
+```
+
+### 결과
+- ✅ 성공
+- Storybook 스토리 추가 완료
+- 디자이너 리뷰 완료
+
+### 후속 작업 / 피드백 요청
+- [ ] @backend OAuth 콜백 URL 연동 대기
+
+---

package/templates/common/timsquad/logs/_template.md

@@ -0,0 +1,46 @@
+# {에이전트} 작업 로그 - {YYYY-MM-DD}
+
+---
+
+## {HH:MM} | {작업 제목}
+
+### What (작업 내용)
+- {수행한 작업 1}
+- {수행한 작업 2}
+- {수행한 작업 3}
+
+### Why (작업 이유)
+> 간단한 경우: 1-2줄로 작성
+> 중요한 결정이 포함된 경우: ADR 링크
+
+{간단한 이유}
+
+**관련 결정:** [ADR-XXX](../ssot/adr/ADR-XXX.md) (있는 경우)
+
+### Reference (근거/참조)
+| 유형 | 링크 | 설명 |
+|-----|------|-----|
+| SSOT | [service-spec.md#xxx](../ssot/service-spec.md#xxx) | API 명세 |
+| SSOT | [ui-ux-spec.md#xxx](../ssot/ui-ux-spec.md#xxx) | 화면 설계 |
+| ADR | [ADR-001](../ssot/adr/ADR-001.md) | 관련 결정 |
+| 외부 | [문서명](URL) | 참고 자료 |
+| 논의 | Slack #channel MM/DD | 팀 논의 |
+
+### 변경 파일
+```
+src/path/to/file.ts (신규/수정/삭제)
+src/path/to/another.ts (수정)
+```
+
+### 결과
+- ✅ 성공 / ⚠️ 부분 성공 / ❌ 실패
+- 테스트: X/Y 통과
+- 비고: {추가 메모}
+
+### 후속 작업 / 피드백 요청
+- [ ] @{담당자} {요청 내용}
+- [ ] @{담당자} {요청 내용}
+
+---
+
+<!-- 다음 작업 로그는 위에 추가 -->