timsquad 2.0.0

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

@@ -0,0 +1,262 @@
+---
+title: "Success Patterns"
+version: 1.0.0
+last_updated: {{TIMESTAMP}}
+---
+
+# 성공 패턴 (Success Patterns)
+
+> 효과적인 작업 패턴을 기록하고 확산합니다.
+> 검증된 패턴은 SKILL.md와 프롬프트에 반영됩니다.
+
+---
+
+## 패턴 분류
+
+### 카테고리
+
+| 카테고리 | 코드 | 설명 |
+|---------|:----:|------|
+| 문서화 | DC | SSOT 활용, 명확한 문서화 |
+| 코드 품질 | CQ | TDD, 클린 코드, 테스트 커버리지 |
+| 협업 | CL | 효과적인 handoff, 명확한 커뮤니케이션 |
+| 프로세스 | PR | 효율적인 워크플로우, Phase 준수 |
+| 학습 | LN | 지식 축적, 패턴 재사용 |
+
+---
+
+## 등록된 패턴
+
+<!--
+패턴 추가 시 아래 템플릿 사용:
+
+### SP-XXX: {패턴명}
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | SP-XXX |
+| **카테고리** | {DC/CQ/CL/PR/LN} |
+| **최초 발견** | {날짜} |
+| **적용 횟수** | {N}회 |
+| **관련 에이전트** | {에이전트 목록} |
+| **검증 상태** | proposed / validated / standard |
+
+**패턴 설명**
+{어떤 패턴인지}
+
+**성공 요인**
+{왜 효과적인지}
+
+**적용 방법**
+1. {단계 1}
+2. {단계 2}
+
+**측정 가능한 효과**
+- {효과 1}
+- {효과 2}
+
+**적용 확대**
+- [ ] {확대 계획}
+-->
+
+### SP-001: SSOT 먼저, 코드 나중
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | SP-001 |
+| **카테고리** | DC (문서화) |
+| **최초 발견** | - |
+| **적용 횟수** | 0회 |
+| **관련 에이전트** | tsq-planner, tsq-developer |
+| **검증 상태** | standard |
+
+**패턴 설명**
+구현 전 반드시 SSOT 문서(service-spec.md, data-design.md)를 완성하고 승인받은 후 코드 작성을 시작한다.
+
+**성공 요인**
+- 명확한 계약서(Contract) 역할
+- 프론트엔드-백엔드 병렬 작업 가능
+- 리뷰 기준 명확
+
+**적용 방법**
+1. PRD 승인 확인
+2. service-spec.md 작성 (API 명세)
+3. data-design.md 작성 (DB 스키마)
+4. error-codes.md 작성
+5. 사용자 승인
+6. Implementation phase 진입
+
+**측정 가능한 효과**
+- API 불일치 피드백 80% 감소
+- 재작업 시간 60% 감소
+- Level 2 피드백 50% 감소
+
+**적용 확대**
+- [x] 모든 프로젝트 타입에 기본 적용
+- [ ] CI/CD에서 SSOT 검증 자동화
+
+---
+
+### SP-002: 구조화된 Handoff
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | SP-002 |
+| **카테고리** | CL (협업) |
+| **최초 발견** | - |
+| **적용 횟수** | 0회 |
+| **관련 에이전트** | 전체 |
+| **검증 상태** | standard |
+
+**패턴 설명**
+에이전트 전환 시 workspace.xml의 handoff 섹션을 완전하게 작성하여 컨텍스트 손실을 방지한다.
+
+**성공 요인**
+- 다음 에이전트가 즉시 작업 시작 가능
+- 컨텍스트 재구성 토큰 절약
+- 결정 사항 추적 가능
+
+**적용 방법**
+1. 작업 완료 시 workspace.xml 업데이트
+2. handoff 섹션에 다음 정보 기록:
+   - from/to 에이전트
+   - 전달 메시지 (특이사항, 주의점)
+   - 참조할 SSOT 문서
+   - action-items (우선순위 포함)
+3. 다음 에이전트 호출 전 검증
+
+**측정 가능한 효과**
+- 컨텍스트 재구성 시간 90% 감소
+- 토큰 사용량 30% 절감
+- 작업 연속성 향상
+
+**적용 확대**
+- [x] handoff 템플릿 표준화
+- [ ] 자동 handoff 검증 스크립트
+
+---
+
+### SP-003: 점진적 검증 (Progressive Validation)
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | SP-003 |
+| **카테고리** | CQ (코드 품질) |
+| **최초 발견** | - |
+| **적용 횟수** | 0회 |
+| **관련 에이전트** | tsq-developer, tsq-qa |
+| **검증 상태** | validated |
+
+**패턴 설명**
+큰 기능을 작은 단위로 나누어 각 단계마다 테스트와 검증을 수행한다.
+
+**성공 요인**
+- 조기 문제 발견
+- 디버깅 범위 축소
+- 롤백 용이
+
+**적용 방법**
+1. 기능을 독립적인 단위로 분해
+2. 각 단위별로:
+   - 테스트 먼저 작성 (TDD)
+   - 구현
+   - 테스트 통과 확인
+   - 커밋
+3. 통합 테스트 실행
+4. QA 리뷰
+
+**측정 가능한 효과**
+- 버그 발견 시간 70% 단축
+- 수정 범위 80% 축소
+- 테스트 커버리지 90%+ 유지
+
+**적용 확대**
+- [ ] CI에서 단위 테스트 필수화
+- [ ] 커밋당 테스트 커버리지 검증
+
+---
+
+### SP-004: ADR 기반 의사결정
+
+| 항목 | 내용 |
+|-----|------|
+| **ID** | SP-004 |
+| **카테고리** | DC (문서화) |
+| **최초 발견** | - |
+| **적용 횟수** | 0회 |
+| **관련 에이전트** | tsq-planner |
+| **검증 상태** | validated |
+
+**패턴 설명**
+주요 아키텍처 결정은 ADR(Architecture Decision Record)로 문서화하여 결정 근거를 추적 가능하게 한다.
+
+**성공 요인**
+- 결정 배경 명확화
+- 나중에 "왜 이렇게 했지?" 방지
+- 대안 검토 기록 보존
+
+**적용 방법**
+1. 결정이 필요한 상황 인식
+2. 대안들 나열
+3. 각 대안의 장단점 분석
+4. 결정 및 근거 기록
+5. ADR 문서 생성 (ADR-XXX-title.md)
+
+**측정 가능한 효과**
+- 기술 부채 추적 가능
+- 온보딩 시간 단축
+- 재논의 방지
+
+**적용 확대**
+- [x] Level 2+ 프로젝트 필수
+- [ ] ADR 템플릿 개선
+
+---
+
+## 패턴 통계
+
+### 카테고리별 분포
+
+```
+카테고리별 성공 패턴 (누적)
+
+DC (문서화)       : ████████░░ 40%
+CQ (코드 품질)    : ████░░░░░░ 20%
+CL (협업)         : ████░░░░░░ 20%
+PR (프로세스)     : ██░░░░░░░░ 10%
+LN (학습)         : ██░░░░░░░░ 10%
+```
+
+### 검증 상태별 분류
+
+| 상태 | 패턴 수 | 설명 |
+|-----|:------:|------|
+| proposed | 0 | 제안됨, 검증 필요 |
+| validated | 2 | 검증됨, 효과 확인 |
+| standard | 2 | 표준화됨, 모든 프로젝트 적용 |
+
+---
+
+## SKILL.md 반영
+
+### 반영된 패턴
+
+| 패턴 | 적용 SKILL | 적용 일자 |
+|------|----------|----------|
+| SP-001 | coding, planning | - |
+| SP-002 | 전체 | - |
+
+### 반영 예정
+
+| 패턴 | 적용 SKILL | 예정 일자 |
+|------|----------|----------|
+| SP-003 | coding, testing | 다음 사이클 |
+| SP-004 | planning, architecture | 다음 사이클 |
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 변경 내용 |
+|------|------|----------|
+| 1.0.0 | {{TIMESTAMP}} | 초기 템플릿 생성 |

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

@@ -0,0 +1,294 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  TimSquad Retrospective Configuration
+
+  이론적 기반:
+  - Agentsway (arXiv:2510.23664): Retrospective Learning, Prompting Agent
+  - ACM TOSEM LMA Survey: Competency Mapping, Performance Evaluation
+  - Self-Refine: Iterative FEEDBACK → REFINE Loop
+  - MAR (Multi-Agent Reflexion): Episodic Memory, Reflection
+-->
+<retrospective-config version="1.0">
+  <metadata>
+    <description>회고 시스템 설정 및 규칙 정의</description>
+    <theoretical-basis>
+      <paper id="agentsway" arxiv="2510.23664">Retrospective Learning</paper>
+      <paper id="tosem" doi="10.1145/3712003">Competency Framework</paper>
+      <paper id="self-refine">Iterative Refinement</paper>
+    </theoretical-basis>
+  </metadata>
+
+  <!-- ============================================================
+       패턴 감지 규칙 (Pattern Detection)
+       Agentsway: "Fine-tuned LLMs leverage outputs and feedback"
+       ============================================================ -->
+  <pattern-detection>
+    <!-- 실패 패턴 자동 감지 임계값 -->
+    <failure-patterns>
+      <threshold
+        min-occurrences="3"
+        time-window="7d"
+        description="3회 이상 반복되면 패턴으로 등록">
+        <action>register_pattern</action>
+        <action>notify_pm</action>
+      </threshold>
+
+      <categories>
+        <category id="CQ" name="코드 품질">
+          <trigger>test_failure</trigger>
+          <trigger>lint_error</trigger>
+          <trigger>type_error</trigger>
+          <trigger>runtime_error</trigger>
+        </category>
+        <category id="DM" name="설계 불일치">
+          <trigger>api_mismatch</trigger>
+          <trigger>schema_mismatch</trigger>
+          <trigger>ssot_violation</trigger>
+        </category>
+        <category id="RQ" name="요구사항">
+          <trigger>requirement_ambiguity</trigger>
+          <trigger>scope_creep</trigger>
+          <trigger>missing_acceptance_criteria</trigger>
+        </category>
+        <category id="PR" name="프로세스">
+          <trigger>phase_violation</trigger>
+          <trigger>missing_documentation</trigger>
+          <trigger>workflow_error</trigger>
+        </category>
+        <category id="CM" name="커뮤니케이션">
+          <trigger>handoff_failure</trigger>
+          <trigger>context_loss</trigger>
+          <trigger>unclear_instruction</trigger>
+        </category>
+      </categories>
+    </failure-patterns>
+
+    <!-- 성공 패턴 자동 감지 -->
+    <success-patterns>
+      <threshold
+        min-occurrences="3"
+        success-rate="90%"
+        description="3회 이상 90% 성공률이면 패턴으로 등록">
+        <action>register_pattern</action>
+        <action>consider_standardization</action>
+      </threshold>
+
+      <categories>
+        <category id="DC" name="문서화">
+          <indicator>ssot_first_implementation</indicator>
+          <indicator>comprehensive_adr</indicator>
+        </category>
+        <category id="CQ" name="코드 품질">
+          <indicator>tdd_approach</indicator>
+          <indicator>high_coverage</indicator>
+        </category>
+        <category id="CL" name="협업">
+          <indicator>complete_handoff</indicator>
+          <indicator>clear_context</indicator>
+        </category>
+      </categories>
+    </success-patterns>
+  </pattern-detection>
+
+  <!-- ============================================================
+       개선 규칙 (Improvement Rules)
+       Self-Refine: "FEEDBACK → REFINE iterative loop"
+       ============================================================ -->
+  <improvement-rules>
+    <!-- 자동 개선 제안 조건 -->
+    <auto-suggestion>
+      <rule id="IMP-AUTO-001">
+        <condition>failure_pattern.occurrences >= 3</condition>
+        <action>generate_prompt_improvement</action>
+        <target>affected_agent.skill_md</target>
+        <requires-approval>true</requires-approval>
+      </rule>
+
+      <rule id="IMP-AUTO-002">
+        <condition>success_pattern.validated == true</condition>
+        <action>propose_standardization</action>
+        <target>skill_md, template</target>
+        <requires-approval>true</requires-approval>
+      </rule>
+
+      <rule id="IMP-AUTO-003">
+        <condition>agent.score &lt; 70</condition>
+        <action>analyze_weakness</action>
+        <action>generate_training_suggestion</action>
+        <requires-approval>true</requires-approval>
+      </rule>
+    </auto-suggestion>
+
+    <!-- 개선 적용 프로세스 (Iterative Refinement) -->
+    <apply-process>
+      <step order="1">
+        <name>Proposal</name>
+        <description>개선안 생성</description>
+        <agent>tsq-retro</agent>
+      </step>
+      <step order="2">
+        <name>Review</name>
+        <description>PM/사용자 검토</description>
+        <requires-approval>true</requires-approval>
+      </step>
+      <step order="3">
+        <name>Apply</name>
+        <description>파일 수정 적용</description>
+        <targets>
+          <target type="skill">.claude/agents/*.md</target>
+          <target type="template">.timsquad/ssot/*.template.md</target>
+          <target type="knowledge">.timsquad/knowledge/lessons.md</target>
+        </targets>
+      </step>
+      <step order="4">
+        <name>Verify</name>
+        <description>다음 사이클에서 효과 측정</description>
+        <metric>pattern_recurrence</metric>
+        <metric>agent_score_change</metric>
+      </step>
+    </apply-process>
+  </improvement-rules>
+
+  <!-- ============================================================
+       메트릭 정의 (Metrics Definition)
+       ACM TOSEM: "Performance Evaluation"
+       ============================================================ -->
+  <metrics-definition>
+    <!-- 에이전트 성과 메트릭 -->
+    <agent-metrics>
+      <metric id="success_rate" weight="0.3">
+        <formula>(successful_tasks / total_tasks) * 100</formula>
+        <target>90%</target>
+      </metric>
+      <metric id="revision_rate" weight="0.2">
+        <formula>1 - (avg_revisions / max_expected_revisions)</formula>
+        <target>&lt; 2 revisions</target>
+      </metric>
+      <metric id="feedback_rate" weight="0.2">
+        <formula>1 - (level2_level3_feedback / total_tasks)</formula>
+        <target>&lt; 10%</target>
+      </metric>
+      <metric id="ssot_compliance" weight="0.15">
+        <formula>compliant_implementations / total_implementations</formula>
+        <target>100%</target>
+      </metric>
+      <metric id="handoff_quality" weight="0.15">
+        <formula>complete_handoffs / total_handoffs</formula>
+        <target>95%</target>
+      </metric>
+    </agent-metrics>
+
+    <!-- 사이클 메트릭 -->
+    <cycle-metrics>
+      <metric id="total_tasks">완료된 작업 수</metric>
+      <metric id="overall_success_rate">전체 성공률</metric>
+      <metric id="avg_cycle_time">평균 작업 시간</metric>
+      <metric id="level3_feedback_count">Level 3 피드백 수</metric>
+      <metric id="pattern_recurrence">반복 패턴 수</metric>
+    </cycle-metrics>
+
+    <!-- 점수 계산 -->
+    <score-calculation>
+      <formula>
+        agent_score =
+          (success_rate * 0.3) +
+          (revision_rate * 0.2) +
+          (feedback_rate * 0.2) +
+          (ssot_compliance * 0.15) +
+          (handoff_quality * 0.15)
+      </formula>
+      <thresholds>
+        <level name="excellent" min="90">우수</level>
+        <level name="good" min="80">양호</level>
+        <level name="needs_improvement" min="70">개선 필요</level>
+        <level name="critical" min="0">심각</level>
+      </thresholds>
+    </score-calculation>
+  </metrics-definition>
+
+  <!-- ============================================================
+       회고 사이클 설정
+       ============================================================ -->
+  <cycle-settings>
+    <!-- 사이클 기간 -->
+    <duration>
+      <default unit="days">14</default>
+      <minimum unit="days">7</minimum>
+      <maximum unit="days">30</maximum>
+    </duration>
+
+    <!-- 사이클 종료 조건 -->
+    <completion-criteria>
+      <criterion type="time">기간 만료</criterion>
+      <criterion type="milestone">주요 마일스톤 완료</criterion>
+      <criterion type="manual">사용자 수동 종료</criterion>
+    </completion-criteria>
+
+    <!-- 자동 회고 트리거 -->
+    <auto-triggers>
+      <trigger condition="phase_transition">Phase 전환 시</trigger>
+      <trigger condition="major_milestone">주요 마일스톤 완료 시</trigger>
+      <trigger condition="critical_feedback_count >= 5">Critical 피드백 5건 이상</trigger>
+    </auto-triggers>
+
+    <!-- 리포트 보존 -->
+    <retention>
+      <cycles-to-keep>10</cycles-to-keep>
+      <archive-after unit="months">6</archive-after>
+    </retention>
+  </cycle-settings>
+
+  <!-- ============================================================
+       에이전트 역할 (회고 관련)
+       ============================================================ -->
+  <agent-roles>
+    <agent id="tsq-retro">
+      <responsibilities>
+        <duty>로그 분석 및 메트릭 계산</duty>
+        <duty>패턴 식별 및 분류</duty>
+        <duty>개선안 생성</duty>
+        <duty>회고 리포트 작성</duty>
+      </responsibilities>
+      <permissions>
+        <permission>read:.timsquad/logs/*</permission>
+        <permission>read:.timsquad/state/*</permission>
+        <permission>write:.timsquad/retrospective/*</permission>
+      </permissions>
+    </agent>
+
+    <agent id="pm">
+      <responsibilities>
+        <duty>개선안 검토 및 승인</duty>
+        <duty>사용자에게 회고 결과 보고</duty>
+        <duty>개선 적용 조율</duty>
+      </responsibilities>
+    </agent>
+  </agent-roles>
+
+  <!-- ============================================================
+       학습 규칙 (Retrospective Learning)
+       Agentsway: "Retrospective learning process"
+       ============================================================ -->
+  <learning-rules>
+    <!-- 지식 축적 -->
+    <knowledge-accumulation>
+      <rule id="LEARN-001">
+        <source>resolved_failure_patterns</source>
+        <destination>.timsquad/knowledge/lessons.md</destination>
+        <format>structured_lesson</format>
+      </rule>
+      <rule id="LEARN-002">
+        <source>validated_success_patterns</source>
+        <destination>.timsquad/knowledge/tribal.md</destination>
+        <format>best_practice</format>
+      </rule>
+    </knowledge-accumulation>
+
+    <!-- 프롬프트 진화 -->
+    <prompt-evolution>
+      <versioning>semantic</versioning>
+      <rollback-enabled>true</rollback-enabled>
+      <a-b-testing>optional</a-b-testing>
+    </prompt-evolution>
+  </learning-rules>
+</retrospective-config>