---
name: retro
description: "주간 엔지니어링 회고: task-timers.json + git log + 보고서 분석으로 팀 성과와 개선점 도출"
triggers:
  - "retro"
  - "회고"
  - "주간 회고"
  - "엔지니어링 회고"
  - "이번 주 뭐 했지"
usage: "/retro [7d|14d|30d]"
---

# /retro — 주간 엔지니어링 회고

> 출처: gstack `/retro` 스킬 패턴 (MIT 라이선스, https://github.com/garrytan/gstack)
> 우리 시스템에 맞게 커스텀 (task-timers.json + memory/ 기반)

주간 엔지니어링 회고를 생성한다. 작업 히스토리, 팀 성과, 코드 품질 메트릭을 분석하여 개선점을 도출한다.

## User-invocable
사용자가 `/retro`를 입력하면 이 스킬을 실행한다.

## Arguments
- `/retro` — 기본: 최근 7일
- `/retro 14d` — 최근 14일
- `/retro 30d` — 최근 30일

---

## Step 1: 데이터 수집

### 1.1 작업 히스토리 (task-timers.json)
```bash
cat /home/jay/workspace/memory/task-timers.json
```
- 지정 기간 내 완료된 태스크 필터링
- 팀별/봇별 태스크 카운트
- 평균 소요 시간

### 1.2 완료 이벤트 (.done 파일)
```bash
ls -lt /home/jay/workspace/memory/events/*.done
```
- 지정 기간 내 .done 파일 목록
- QC 결과 (qc_result 필드) 통계

### 1.3 보고서 (reports/)
```bash
ls -lt /home/jay/workspace/memory/reports/
```
- 지정 기간 내 보고서 목록
- 보고서 크기 (상세도 지표)

### 1.4 Git 로그 (프로젝트 존재 시)
```bash
# 프로젝트 디렉토리가 있으면 git log 수집
for dir in /home/jay/workspace/projects/*/; do
  if [ -d "$dir/.git" ]; then
    echo "=== $(basename $dir) ==="
    git -C "$dir" log --since="<window>" --format="%H|%aN|%ai|%s" --shortstat
  fi
done
```

### 1.5 Eureka Moment 아카이브
```bash
ls /home/jay/workspace/memory/events/eureka-*.md 2>/dev/null
```

---

## Step 2: 메트릭 산출

### 요약 테이블

- 완료 태스크 수 (전체)
- 팀별 태스크 수 (dev1/dev2/dev3/dev4)
- QC 통과율 (PASS+WARN / 전체)
- QC FAIL 건수
- 평균 태스크 소요시간 (분)
- 활성 일수 (태스크가 1개 이상 완료된 날)
- 배포 연속 기록 (consecutive days with .done)

### 팀별 리더보드

```
팀          완료 태스크   평균 소요시간   QC 통과율
dev1-team        12         45분          92%
dev2-team         8         62분          88%
...
```

---

## Step 3: 테스트 건강도 트렌드

- 총 테스트 파일 수 (projects/ 하위)
- 이번 기간 추가된 테스트 파일 수
- pyright 에러 트렌드 (가능하면)
- TDD 준수율 (tdd_check 결과에서)

---

## Step 4: Top 3 성장 기회

task-timers.json에서 다음 패턴을 찾아 개선 기회 도출:
1. **가장 오래 걸린 태스크 Top 3** — 병목 원인 분석
2. **QC FAIL 반복 태스크** — 품질 이슈 패턴
3. **가장 자주 수정된 파일** — 핫스팟 분석

---

## Step 4.5: 정성적 관점 입력

> pm-a6 방법론(잘된 것/개선점/행동항목) 계승. 정량 데이터만으로 포착할 수 없는 팀 역학을 보완한다.

- 이번 기간 가장 **마찰이 컸던 프로세스** 1가지
- 이번 기간 가장 **효과적이었던 협업 패턴** 1가지
- 팀원들의 **감정/에너지 상태** (높음/보통/낮음 + 사유)
- **프로세스 개선 제안** (자동화 가능하거나 불필요한 절차)

---

## Step 5: Top 3 반복 실수

보고서와 QC 결과에서 반복되는 패턴 식별:
1. 테스트 누락
2. 타입 에러
3. 스타일 위반
등 FAIL/WARN 사유 집계

---

## Step 6: Eureka Moment 아카이브

`memory/events/eureka-*.md` 파일을 읽고 이번 기간의 발견 사항 나열.
없으면 "이번 기간 Eureka Moment 없음" 표시.

---

## Step 7: 회고 보고서 저장

산출물을 `memory/daily/retro-{date}.md` 에 저장:

```bash
mkdir -p /home/jay/workspace/memory/daily
```

파일 형식:
```markdown
# 주간 엔지니어링 회고: {start_date} ~ {end_date}

## 요약
(Tweetable 1줄 요약)

## 메트릭
(Step 2 테이블)

## 테스트 건강도
(Step 3 결과)

## Top 3 성장 기회
(Step 4 결과)

## Top 3 반복 실수
(Step 5 결과)

## Eureka Moments
(Step 6 결과)

## 다음 주 습관 3가지
(구체적, 실천 가능한 개선 제안)
```

---

## 3P 주간보고 자동 생성 (internal-comms 연동)

- 주간 회고 산출물로 `/internal-comms --3p-weekly` 실행하여 3P 주간보고 자동 생성 가능
- Progress(진행), Plan(계획), Problem(문제) 형식의 공식 보고서 산출
- 회고 데이터를 기반으로 팀 내부 커뮤니케이션 문서까지 한 번에 생성
- 참조: `/internal-comms` 스킬 (내부 커뮤니케이션 문서 자동 생성, 한국어 비즈니스 문어체)

## 크로노스(회고분석 센터) 연동

- 크로노스가 이 스킬의 산출물(`memory/daily/retro-{date}.md`)을 읽어 장기 트렌드 추적
- 이전 회고 파일(`memory/daily/retro-*.md`)이 있으면 트렌드 비교 섹션 추가

---

## 톤 & 스타일

- 격려적이되 솔직하게, 아부 금지
- 구체적 데이터에 기반 — "잘했다"가 아니라 "12건 완료, QC 92% 통과"
- 개선점은 비판이 아닌 투자 관점 — "~에 투자하면 ~가 개선된다"
- 총 분량: 1000-2000 단어

---

## Important Rules

- 모든 내러티브 출력은 대화에 직접 표시 (파일은 retro-{date}.md만 저장)
- 이전 회고가 없으면 비교 섹션 생략, "첫 회고 기록 — 다음 주에 트렌드 확인 가능" 표시
- 태스크가 0건이면 "이번 기간 완료된 태스크 없음" 표시 후 종료
- Fantasy Approval 금지: "모든 것이 완벽합니다" 류 표현 사용 불가

---

**스킬 버전**: v1.0
**작성일**: 2026-03-23
**출처**: gstack `/retro` 스킬 (MIT 라이선스) 커스텀