timsquad 2.0.0

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

@@ -0,0 +1,205 @@
+---
+title: "Cycle {{CYCLE_NUMBER}} Retrospective Report"
+cycle: {{CYCLE_NUMBER}}
+period_start: {{PERIOD_START}}
+period_end: {{PERIOD_END}}
+generated_at: {{TIMESTAMP}}
+status: draft
+---
+
+# Cycle {{CYCLE_NUMBER}} 회고 리포트
+
+## 1. 기간
+
+| 항목 | 값 |
+|-----|-----|
+| 시작일 | {{PERIOD_START}} |
+| 종료일 | {{PERIOD_END}} |
+| 총 작업일 | {{WORKING_DAYS}}일 |
+
+---
+
+## 2. 메트릭 요약
+
+### 2.1 핵심 지표
+
+| 지표 | 이번 사이클 | 이전 사이클 | 변화 |
+|-----|:-----------:|:-----------:|:----:|
+| 총 작업 수 | {{TOTAL_TASKS}} | {{PREV_TOTAL_TASKS}} | {{TASKS_DIFF}} |
+| 전체 성공률 | {{SUCCESS_RATE}}% | {{PREV_SUCCESS_RATE}}% | {{SUCCESS_DIFF}} |
+| 평균 수정 횟수 | {{AVG_REVISIONS}} | {{PREV_AVG_REVISIONS}} | {{REVISIONS_DIFF}} |
+| Level 3 피드백 | {{LEVEL3_COUNT}} | {{PREV_LEVEL3_COUNT}} | {{LEVEL3_DIFF}} |
+
+### 2.2 목표 달성
+
+| 목표 | 목표치 | 달성치 | 상태 |
+|-----|:------:|:------:|:----:|
+| 성공률 | 90%+ | {{SUCCESS_RATE}}% | {{SUCCESS_STATUS}} |
+| 수정 횟수 | < 3 | {{AVG_REVISIONS}} | {{REVISIONS_STATUS}} |
+| Level 3 피드백 | < 5 | {{LEVEL3_COUNT}} | {{LEVEL3_STATUS}} |
+
+---
+
+## 3. 에이전트별 성과
+
+### 3.1 성과 테이블
+
+| 에이전트 | 작업 수 | 성공률 | 평균 수정 | 점수 | 추세 |
+|---------|:-------:|:------:|:--------:|:----:|:----:|
+| tsq-planner | {{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
+- **강점**: {{PLANNER_STRENGTHS}}
+- **개선 필요**: {{PLANNER_IMPROVEMENTS}}
+- **주요 이슈**: {{PLANNER_ISSUES}}
+
+#### tsq-developer
+- **강점**: {{DEVELOPER_STRENGTHS}}
+- **개선 필요**: {{DEVELOPER_IMPROVEMENTS}}
+- **주요 이슈**: {{DEVELOPER_ISSUES}}
+
+#### tsq-qa
+- **강점**: {{QA_STRENGTHS}}
+- **개선 필요**: {{QA_IMPROVEMENTS}}
+- **주요 이슈**: {{QA_ISSUES}}
+
+#### tsq-security
+- **강점**: {{SECURITY_STRENGTHS}}
+- **개선 필요**: {{SECURITY_IMPROVEMENTS}}
+- **주요 이슈**: {{SECURITY_ISSUES}}
+
+---
+
+## 4. 피드백 분석
+
+### 4.1 피드백 분포
+
+| 레벨 | 건수 | 비율 | 평균 해결 시간 |
+|:----:|:----:|:----:|:-------------:|
+| Level 1 (구현) | {{L1_COUNT}} | {{L1_PERCENT}}% | {{L1_RESOLUTION_TIME}} |
+| Level 2 (설계) | {{L2_COUNT}} | {{L2_PERCENT}}% | {{L2_RESOLUTION_TIME}} |
+| Level 3 (기획) | {{L3_COUNT}} | {{L3_PERCENT}}% | {{L3_RESOLUTION_TIME}} |
+
+### 4.2 피드백 유형별 분류
+
+| 유형 | 건수 | 주요 원인 |
+|-----|:----:|---------|
+| 테스트 실패 | {{TEST_FAIL_COUNT}} | {{TEST_FAIL_CAUSE}} |
+| 타입 에러 | {{TYPE_ERROR_COUNT}} | {{TYPE_ERROR_CAUSE}} |
+| API 불일치 | {{API_MISMATCH_COUNT}} | {{API_MISMATCH_CAUSE}} |
+| 요구사항 불명확 | {{REQ_UNCLEAR_COUNT}} | {{REQ_UNCLEAR_CAUSE}} |
+
+---
+
+## 5. 발견된 패턴
+
+### 5.1 실패 패턴
+
+{{#FAILURE_PATTERNS}}
+#### FP-{{PATTERN_NUM}}: {{PATTERN_NAME}}
+
+| 항목 | 내용 |
+|-----|------|
+| **빈도** | {{FREQUENCY}}회 |
+| **영향 에이전트** | {{AFFECTED_AGENTS}} |
+| **원인** | {{CAUSE}} |
+| **제안** | {{SUGGESTION}} |
+
+{{/FAILURE_PATTERNS}}
+
+→ 상세: [failure-patterns.md](../patterns/failure-patterns.md) 참조
+
+### 5.2 성공 패턴
+
+{{#SUCCESS_PATTERNS}}
+#### SP-{{PATTERN_NUM}}: {{PATTERN_NAME}}
+
+| 항목 | 내용 |
+|-----|------|
+| **빈도** | {{FREQUENCY}}회 |
+| **성공 요인** | {{FACTOR}} |
+| **적용 확대** | {{RECOMMENDATION}} |
+
+{{/SUCCESS_PATTERNS}}
+
+→ 상세: [success-patterns.md](../patterns/success-patterns.md) 참조
+
+---
+
+## 6. 개선 조치
+
+### 6.1 적용된 개선
+
+| ID | 유형 | 대상 | 설명 | 상태 |
+|----|------|------|------|:----:|
+{{#IMPROVEMENTS_APPLIED}}
+| {{IMP_ID}} | {{IMP_TYPE}} | {{IMP_TARGET}} | {{IMP_DESC}} | ✅ |
+{{/IMPROVEMENTS_APPLIED}}
+
+### 6.2 제안된 개선 (다음 사이클)
+
+| ID | 유형 | 대상 | 설명 | 우선순위 |
+|----|------|------|------|:--------:|
+{{#IMPROVEMENTS_PROPOSED}}
+| {{IMP_ID}} | {{IMP_TYPE}} | {{IMP_TARGET}} | {{IMP_DESC}} | {{IMP_PRIORITY}} |
+{{/IMPROVEMENTS_PROPOSED}}
+
+---
+
+## 7. 다음 사이클 목표
+
+### 7.1 정량적 목표
+
+| 목표 | 지표 | 목표치 |
+|-----|------|:------:|
+{{#NEXT_GOALS}}
+| {{GOAL}} | {{METRIC}} | {{TARGET}} |
+{{/NEXT_GOALS}}
+
+### 7.2 정성적 목표
+
+{{#NEXT_QUALITATIVE_GOALS}}
+- [ ] {{GOAL}}
+{{/NEXT_QUALITATIVE_GOALS}}
+
+---
+
+## 8. 학습된 교훈 (Lessons Learned)
+
+### 이번 사이클에서 배운 점
+
+{{#LESSONS}}
+#### [{{LESSON_DATE}}] {{LESSON_TITLE}}
+
+- **상황**: {{LESSON_CONTEXT}}
+- **문제**: {{LESSON_PROBLEM}}
+- **해결**: {{LESSON_SOLUTION}}
+- **교훈**: {{LESSON_TAKEAWAY}}
+
+{{/LESSONS}}
+
+→ 전체 교훈: [lessons.md](../../knowledge/lessons.md)에 통합됨
+
+---
+
+## 9. 메트릭 데이터
+
+상세 메트릭 데이터는 JSON 형식으로 저장됩니다:
+- `../metrics/cycle-{{CYCLE_NUMBER}}.json`
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{TIMESTAMP}} | tsq-retro | 초기 생성 |
+
+---
+
+**Generated by TimSquad Retrospective System v1.0**

package/templates/common/timsquad/retrospective/metrics/metrics-schema.json

@@ -0,0 +1,203 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "TimSquad Retrospective Metrics",
+  "description": "회고 시스템 메트릭 스키마 정의",
+  "version": "1.0.0",
+
+  "definitions": {
+    "agentMetrics": {
+      "type": "object",
+      "properties": {
+        "tasks_completed": {
+          "type": "integer",
+          "description": "완료한 작업 수"
+        },
+        "success_rate": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "성공률 (%)"
+        },
+        "avg_revision_count": {
+          "type": "number",
+          "description": "평균 수정 횟수"
+        },
+        "metrics": {
+          "type": "object",
+          "description": "에이전트별 세부 메트릭"
+        },
+        "score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "종합 점수"
+        },
+        "trend": {
+          "type": "string",
+          "pattern": "^[+-]?[0-9]+(\\.[0-9]+)?$",
+          "description": "이전 대비 변화 (예: +2.1, -0.5)"
+        }
+      },
+      "required": ["tasks_completed", "success_rate", "score"]
+    },
+
+    "feedbackStats": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer"
+        },
+        "by_level": {
+          "type": "object",
+          "properties": {
+            "level_1": { "type": "integer" },
+            "level_2": { "type": "integer" },
+            "level_3": { "type": "integer" }
+          }
+        },
+        "by_type": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" }
+        },
+        "resolution_time_avg_minutes": {
+          "type": "number"
+        }
+      }
+    },
+
+    "pattern": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^(FP|SP)-[0-9]{3}$",
+          "description": "패턴 ID (FP=실패, SP=성공)"
+        },
+        "name": {
+          "type": "string"
+        },
+        "frequency": {
+          "type": "integer",
+          "description": "발생 빈도"
+        },
+        "description": {
+          "type": "string"
+        },
+        "cause": {
+          "type": "string",
+          "description": "원인 (실패 패턴)"
+        },
+        "factor": {
+          "type": "string",
+          "description": "성공 요인 (성공 패턴)"
+        },
+        "suggestion": {
+          "type": "string",
+          "description": "개선 제안"
+        },
+        "agents_affected": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "required": ["id", "name", "frequency"]
+    },
+
+    "improvement": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^IMP-[0-9]{3}$"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["prompt", "template", "skill", "process"]
+        },
+        "target": {
+          "type": "string",
+          "description": "수정 대상 파일/에이전트"
+        },
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["proposed", "approved", "applied", "rejected"]
+        },
+        "applied_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "pattern_refs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "관련 패턴 ID들"
+        }
+      },
+      "required": ["id", "type", "target", "status"]
+    }
+  },
+
+  "type": "object",
+  "properties": {
+    "cycle": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "사이클 번호"
+    },
+    "period": {
+      "type": "object",
+      "properties": {
+        "start": { "type": "string", "format": "date" },
+        "end": { "type": "string", "format": "date" }
+      },
+      "required": ["start", "end"]
+    },
+    "summary": {
+      "type": "object",
+      "properties": {
+        "total_tasks": { "type": "integer" },
+        "success_rate": { "type": "number" },
+        "avg_revision_count": { "type": "number" },
+        "level_3_feedback_count": { "type": "integer" }
+      }
+    },
+    "agents": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/agentMetrics" }
+    },
+    "feedback": {
+      "$ref": "#/definitions/feedbackStats"
+    },
+    "patterns": {
+      "type": "object",
+      "properties": {
+        "failure": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/pattern" }
+        },
+        "success": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/pattern" }
+        }
+      }
+    },
+    "improvements": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/improvement" }
+    },
+    "next_cycle_goals": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "goal": { "type": "string" },
+          "metric": { "type": "string" },
+          "target": { "type": "string" }
+        }
+      }
+    }
+  },
+  "required": ["cycle", "period", "summary", "agents"]
+}

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

@@ -0,0 +1,199 @@
+---
+title: "Failure Patterns"
+version: 1.0.0
+last_updated: {{TIMESTAMP}}
+---
+
+# 실패 패턴 (Failure Patterns)
+
+> 반복적으로 발생하는 실패 패턴을 기록하고 분석합니다.
+> 3회 이상 발생 시 자동으로 개선 조치가 제안됩니다.
+
+---
+
+## 패턴 분류
+
+### 카테고리
+
+| 카테고리 | 코드 | 설명 |
+|---------|:----:|------|
+| 코드 품질 | CQ | 테스트 실패, 타입 에러, 린트 오류 |
+| 설계 불일치 | DM | API 불일치, 스키마 불일치, 아키텍처 위반 |
+| 요구사항 | RQ | 요구사항 불명확, 스코프 크리프 |
+| 프로세스 | PR | Phase 위반, 문서 누락, 워크플로우 오류 |
+| 커뮤니케이션 | CM | Handoff 실패, 컨텍스트 손실 |
+
+---
+
+## 등록된 패턴
+
+<!--
+패턴 추가 시 아래 템플릿 사용:
+
+### FP-XXX: {패턴명}
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | FP-XXX |
+| **카테고리** | {CQ/DM/RQ/PR/CM} |
+| **최초 발견** | {날짜} |
+| **발생 횟수** | {N}회 |
+| **영향 에이전트** | {에이전트 목록} |
+| **상태** | active / mitigated / resolved |
+
+**증상**
+{어떤 현상이 발생하는지}
+
+**원인 분석**
+{왜 발생하는지}
+
+**영향**
+{프로젝트에 미치는 영향}
+
+**개선 조치**
+- [ ] {조치 1}
+- [ ] {조치 2}
+
+**관련 개선**
+- IMP-XXX: {개선 제목}
+-->
+
+### FP-001: SSOT 미참조 구현
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | FP-001 |
+| **카테고리** | DM (설계 불일치) |
+| **최초 발견** | - |
+| **발생 횟수** | 0회 |
+| **영향 에이전트** | tsq-developer |
+| **상태** | active |
+
+**증상**
+- service-spec.md와 다른 API 응답 형식
+- data-design.md와 다른 테이블 구조
+- error-codes.md에 없는 에러 코드 사용
+
+**원인 분석**
+- 구현 전 SSOT 확인 단계 생략
+- SSOT 문서가 최신 상태가 아님
+- 에이전트 프롬프트에 SSOT 참조 강제 누락
+
+**영향**
+- 프론트엔드-백엔드 불일치
+- 테스트 실패
+- Level 2 피드백 증가
+
+**개선 조치**
+- [ ] validation-rules.xml에 pre-condition 강화
+- [ ] tsq-developer SKILL.md에 SSOT 체크리스트 추가
+- [ ] 구현 전 SSOT 버전 확인 자동화
+
+---
+
+### FP-002: 불완전한 Handoff
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | FP-002 |
+| **카테고리** | CM (커뮤니케이션) |
+| **최초 발견** | - |
+| **발생 횟수** | 0회 |
+| **영향 에이전트** | 전체 |
+| **상태** | active |
+
+**증상**
+- 다음 에이전트가 컨텍스트를 모름
+- 같은 작업 반복 수행
+- 결정 사항 누락
+
+**원인 분석**
+- workspace.xml handoff 섹션 미작성
+- 전달 사항이 너무 간략함
+- 참조할 SSOT 문서 누락
+
+**영향**
+- 작업 지연
+- 토큰 낭비 (컨텍스트 재구성)
+- 품질 저하
+
+**개선 조치**
+- [ ] handoff 필수 필드 검증 강화
+- [ ] handoff 템플릿 개선
+- [ ] 자동 handoff 생성 스크립트
+
+---
+
+### FP-003: Phase 위반
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | FP-003 |
+| **카테고리** | PR (프로세스) |
+| **최초 발견** | - |
+| **발생 횟수** | 0회 |
+| **영향 에이전트** | 전체 |
+| **상태** | active |
+
+**증상**
+- Planning phase에서 코드 작성 시도
+- SSOT 승인 전 Implementation 시작
+- Review 없이 배포 진행
+
+**원인 분석**
+- state-machine.xml 규칙 미준수
+- Phase 상태 확인 누락
+- 급한 마음에 프로세스 생략
+
+**영향**
+- 품질 저하
+- 재작업 필요
+- Level 3 피드백 발생
+
+**개선 조치**
+- [ ] Phase 검증 자동화 강화
+- [ ] 위반 시 명확한 에러 메시지
+- [ ] 위반 로그 기록 및 알림
+
+---
+
+## 패턴 통계
+
+### 카테고리별 분포
+
+```
+카테고리별 실패 패턴 (누적)
+
+CQ (코드 품질)     : ████████░░ 40%
+DM (설계 불일치)   : ████░░░░░░ 20%
+RQ (요구사항)      : ███░░░░░░░ 15%
+PR (프로세스)      : ███░░░░░░░ 15%
+CM (커뮤니케이션)  : ██░░░░░░░░ 10%
+```
+
+### 에이전트별 분포
+
+| 에이전트 | 연관 패턴 수 | 주요 카테고리 |
+|---------|:-----------:|-------------|
+| tsq-planner | 0 | - |
+| tsq-developer | 0 | - |
+| tsq-qa | 0 | - |
+| tsq-security | 0 | - |
+
+---
+
+## 개선 연결
+
+| 패턴 | 관련 개선 | 상태 |
+|------|----------|:----:|
+| FP-001 | IMP-001 | 제안됨 |
+| FP-002 | IMP-002 | 제안됨 |
+| FP-003 | IMP-003 | 제안됨 |
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 변경 내용 |
+|------|------|----------|
+| 1.0.0 | {{TIMESTAMP}} | 초기 템플릿 생성 |