Community코딩 & 개발github.com

회고 기본 프레임워크

모든 시간 규모(일간, 주간, 월간, 분기별, 연간)에서 사용할 수 있는 회고 프레임워크입니다. 다음과 같이 실행하세요.

회고 기본 프레임워크란 무엇인가요?

이 기술은 모든 시간 규모(일간, 주간, 월간, 분기별, 연간)에 동일하게 적용 가능한 회고 프레임워크입니다. 핵심은 '무엇이 잘 되었는가?', '무엇이 잘 안 되었는가?', '회고 프로세스 자체를 어떻게 개선할 것인가?'라는 세 가지 질문으로 구성됩니다. 각 규모는 이전 단계의 결과물을 입력으로 받아 압축하는 프랙탈 구조를 따릅니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자와의 대화형 관찰 및 반응을 기반으로 구조화된 회고 문서를 생성합니다. 이는 일일 요약부터 연간 회고까지 일관된 프로세스를 제공하여 팀과 개인의 지속적인 개선을 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZachBeta/claude-as-coach/tree/main/skills/retrospective-base

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

회고 (기본 프레임워크)

핵심 통찰: 모든 시간 규모에서 회고 프로세스는 동일합니다. 달라지는 것은 입력과 기간 프레이밍뿐입니다.

세 가지 질문

모든 회고는 다음 세 가지 질문에 답합니다:

  1. 무엇이 잘 되었는가? → 더 많이 하기
  2. 무엇이 잘 안 되었는가? → 변경 실험하기
  3. 회고 프로세스를 어떻게 개선할까? → 메타 개선 루프

이것이 전부입니다. 나머지는 이 질문들을 지원하기 위한 구조일 뿐입니다.

시간 규모를 파라미터로

규모입력기간결과물
일간원시 관찰1일일간 요약
주간일간 요약7일주간 회고
월간주간 회고4주월간 회고
분기별월간 회고3개월분기별 회고
연간분기별 회고12개월연간 회고

프랙탈 패턴: 각 수준은 이전 수준의 결과물을 압축하여 다음 수준의 입력으로 만듭니다.

프로세스

1. 경계 설정

# 현재 날짜 확인
TZ='America/New_York' date '+%A, %B %d, %Y - %I:%M %p %Z'

검토 중인 기간 확인:

  • 일간: "[날짜]를 검토합니다. 맞습니까?"
  • 주간: "[시작] - [종료]를 검토합니다. 맞습니까?"
  • 월간: "[월 연도]를 검토합니다. 맞습니까?"
  • 분기별: "[연도] [분기]을(를) 검토합니다. 맞습니까?"
  • 연간: "[연도]를 검토합니다. 맞습니까?"

2. 맥락 불러오기

규모에 맞는 입력 불러오기:

  • 일간: 오늘의 노트/로그 불러오기
  • 주간: 해당 주의 일간 요약 불러오기
  • 월간: 해당 월의 주간 회고 불러오기
  • 분기별: 해당 분기의 월간 회고 불러오기
  • 연간: 해당 연도의 분기별 회고 불러오기

또한 불러오기:

  • 이전 기간의 회고 (비교용)
  • 해당 규모의 현재 목표/계획
  • 관련 프로젝트 문서

입력이 없는 경우: 누락된 부분을 기록하고 가용 데이터로 진행합니다.

계획에서 수준 기준 불러오기

검토 중인 기간에 대한 계획 문서가 있는 경우:

  1. 계획에서 수준 0/1/2/3 기준을 그대로 가져옵니다.
  2. 각 기준을 개별적으로 평가합니다 (✓/✗).
  3. 전체 수준 평가로 통합합니다.
  4. 이것이 주요 성공 척도입니다. 성과 척도 표는 세부 정보 역할을 합니다.

3. 일별 검토 (주간+ 기본값)

사용 시기: 일일 요약이 있는 주간 이상의 회고. 주간 회고의 기본 접근 방식입니다. 매번 실행할 가치가 있을 만큼 유용합니다.

목적: 패턴을 종합하기 전에 각 날짜를 간략히 훑어봅니다. 이렇게 하면 놓칠 수 있는 세부 사항이 드러나고 사용자가 전체 주와 다시 연결되는 데 도움이 됩니다.

프로세스:

  1. 각 날짜의 요약을 간략히 제시합니다 (날짜당 2-3개 핵심 포인트).
  2. "[요일]에 추가하거나 수정할 사항이 있나요?"라고 묻습니다.
  3. 사용자가 반응하고, 맥락을 추가하거나 "맞습니다"라고 말하도록 합니다.
  4. 다음 날짜로 이동합니다.
  5. 검토 후 빈 프레임워크 문서를 만듭니다.

도움이 되는 이유:

  • 잊혀진 세부 사항을 드러냅니다 ("아, 화요일이 힘들었지").
  • 요약의 누락이나 오류를 잡아냅니다.
  • 종합 전에 기억을 워밍업합니다.
  • 노력이 적습니다 (생성이 아닌 반응).
  • 최종 문서를 위한 간결한 타임라인을 만듭니다.

가볍게 유지하세요: 이것은 분석이 아닌 오리엔테이션입니다. 종합은 주요 섹션에서 처리합니다.

4. 빈 프레임워크 먼저 보여주기

중요: 내용을 채우기 전에 구조만 있는 아티팩트를 생성하고 사용자에게 설명합니다.

프로세스:

  1. 모든 섹션 헤더가 포함된 빈 아티팩트를 생성합니다.
  2. 사용자에게 제시합니다: "함께 채울 구조입니다."
  3. 각 섹션의 목적을 간략히 설명합니다.
  4. 그런 다음 한 번에 한 섹션씩 채우기 시작합니다.

중요한 이유:

  • 사용자가 뛰어들기 전에 전체 그림을 봅니다.
  • 인지 부하를 줄입니다 (무슨 일이 일어날지 압니다).
  • 생성보다 반응을 가능하게 합니다.

파일명 템플릿:

[Scale]-Retro-[Date-Range].md

예시:

  • Daily-Summary-2025-12-05.md
  • Weekly-Retro-2025-12-01-to-07.md
  • Monthly-Retro-2025-12.md
  • Quarterly-Retro-2025-Q4.md
  • Yearly-Retro-2025.md

5. 프레임워크 구조

# [규모] 회고: [테마/제목]

**기간:** [날짜 범위]
**컨텍스트:** [간략한 컨텍스트 줄]

---

## TL;DR - [기간] 요약

**형식: 간편 스캔을 위한 불릿 목록**
- 주요 패턴 1
- 주요 패턴 2
- 핵심 발견
- 주요 과제
- 전반적인 추세

---

## 일별 타임라인 (주간+)

**주간 이상의 회고에 포함. 일별 검토에서 압축된 참조.**

| 요일 | 날짜 | 컨텍스트 태그 | 주요 이벤트 |
|-----|------|--------------|------------|
| 월 | [날짜] | [태그] | [1-2개 주요 이벤트] |
| 화 | [날짜] | [태그] | [1-2개 주요 이벤트] |
| ... | ... | ... | ... |

**컨텍스트 태그:** 도메인별 상태 추적을 위한 선택적 열 (개인 확장에서 정의).

---

## 계획 대 실제 (계획이 있을 때 주간+)

**계획 문서가 있을 때 주간, 월간, 분기별, 연간 회고에 포함.**

### 테마 평가
**계획된 테마:** [계획에서]
**유지되었나요?** [예/부분적으로/아니오 + 증거]

### 성과 척도

| 영역 | 목표 | 실제 | 평가 |
|------|------|------|--------|
| [우선순위 1] | [목표] | [결과] | ✓ 달성 / ◐ 부분 / ✗ 미달 |
| [우선순위 2] | [목표] | [결과] | ✓ 달성 / ◐ 부분 / ✗ 미달 |

### 수준 평가 ([기간] 계획에서)

**수준 0 (기반):** [✓ 달성 / ◐ 부분 / ✗ 미달성]
- [계획의 기준 1] [✓/✗]
- [계획의 기준 2] [✓/✗]

**수준 1 (기본):** [✓ 달성 / ◐ 부분 / ✗ 미달성]
- [계획의 기준 1] [✓/✗]
- [계획의 기준 2] [✓/✗]

**수준 2 (목표):** [✓ 달성 / ◐ 부분 / ✗ 미달성]
- [계획의 기준 1] [✓/✗]

**수준 3 (도전):** [✓ 달성 / ◐ 부분 / ✗ 미달성] (해당하는 경우)
- [계획의 기준 1] [✓/✗]

### 벤 다이어그램

**계획만:**
- [계획했지만 일어나지 않은 일]

**둘 다:**
- [계획한 대로 일어난 일]

**실제만:**
- [계획에 없었지만 일어난 일]

---

## 잘 된 것 (더 원하는 것)

[관찰 → 반응을 대화식으로 채우기]

---

## 잘 안 된 것 (+ 시도할 실험)

**형식: 과제 → 제안된 실험**

### 과제 1: [문제]
**문제가 되는 이유:** [영향]
**시도할 실험:**
- **다음 [짧은 기간]:** [즉시 테스트]
- **다음 [현재 기간]:** [중기 실험]
- **더 긴 시간 프레임:** [연기된 접근법]

---

## 진행 상황 추적

**관련 간격과 비교:**

### 지난 [기간]
**이전:** [요약]
**현재:** [요약]
**추세:** [개선/안정/악화 + 증거]

### 더 긴 시간 프레임 (데이터가 있는 경우)
**그때:** [상태]
**지금:** [상태]
**궤적:** [변화된 점]

---

## [규모]-회고 (이 프로세스 개선)

[회고 자체에 대한 메타 관찰]
- 이 회고 형식에서 잘 작동한 점은?
- 어색하거나 누락된 점은?
- 필요한 기술 업데이트?

---

## 감사

[긍정적인 마무리 앵커 - 절정-끝 법칙]

이 [기간] 동안 감사한 점은 무엇인가요?

6. 한 번에 하나의 질문만 채우기

⚠️ 중요: 하나의 질문을 하고, 응답을 기다리며, 아티팩트를 업데이트한 후 다음으로 이동하세요.

섹션별 패턴:

  1. 입력 데이터에서 관찰합니다.
  2. 그 관찰에 대해 하나의 집중된 질문을 합니다.
  3. 사용자 응답을 기다립니다.
  4. 아티팩트를 실시간으로 업데이트합니다.
  5. 다음 섹션으로 이동하기 전에 확인합니다.

열린 질문이 아닌 관찰로 시작하세요:

  • ✅ "[패턴]을 발견했습니다. 더 원하시나요?"
  • ✅ "[과제]가 계속 나타났습니다. 어떤 실험이 이를 해결할까요?"
  • ❌ "가장 중요한 것은 무엇이었나요?" (처음부터 생성이 필요함)
  • ❌ 한 번에 여러 질문을 하기

섹션별 속도 조절:

  • "잘 된 것" → 빠르게 진행 (관찰 → 동의)
  • "잘 안 된 것" → 깊이 필요 (실험이 대화형으로 발전)
  • "회고-회고" → 프로세스에 대한 한 가지 질문
  • "감사" → 마지막에 저장 (긍정적 앵커)

7. 저장 및 보관

저장 위치: /mnt/user-data/outputs/[파일명]

사용자에게 알림: "영구 저장하려면 '프로젝트에 추가'를 클릭하세요."

이전 수준의 입력 보관:

  • 주간 회고 후 → 일간 요약 보관
  • 월간 회고 후 → 주간 회고 보관
  • 컨텍스트를 가볍게 유지하고 기록을 로컬에 보존합니다.

핵심 원칙

동일한 질문, 모든 규모: 세 가지 질문은 하루를 검토하든 1년을 검토하든 작동합니다.

입력이 출력으로 압축됨: 각 회고는 입력을 요약으로 압축하여 다음 수준의 입력이 됩니다.

관찰 → 반응: 인간은 처음부터 생성하는 것보다 반응하는 것을 더 잘합니다.

판단보다 실험: "무엇이 잘 안 되었는가 + 무엇을 시도할 것인가"가 "무엇이 실패했는가"보다 낫습니다.

절정-끝 법칙: 기간의 어려움에 관계없이 감사로 끝냅니다.

메타 개선: 회고 프로세스 자체가 시간이 지남에 따라 개선되어야 합니다.

엣지 케이스

특정 규모의 첫 번째 회고:

  • 비교 건너뛰기 (이전 데이터 없음)
  • 기준 패턴 설정에 집중

입력 누락:

  • 가용 데이터로 진행
  • 향후 개선을 위해 누락 기록

결합된 규모:

  • 컨텍스트가 허용하면 동일 세션에서 주간 + 월간 가능
  • 자연스러운 흐름: 주간 통찰 → 월간 종합

유연성

구조는 지침이지 규칙이 아닙니다:

  • 관련 없는 섹션 건너뛰기
  • 도메인별 섹션 추가
  • 복잡성에 따라 길이 조정
  • 노이즈보다 신호에 집중

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

관련 스킬