Retro-Bot은(는) 무엇을 하나요?
Claude 협업 세션에 대해 가벼운 애자일 회고를 실행하는 스킬입니다. 시간이 지남에 따라 Claude와 함께 작업하는 프로세스를 점진적으로 개선합니다.
핵심 루프: 사용자와 Claude가 작업을 마친 후, 함께 세 가지 질문에 답하는 데 몇 분을 투자합니다.
- 잘된 점은 무엇인가요? (계속 유지)
- 아쉬운 점은 무엇인가요? (마찰, 재작업, 혼란, 낭비된 토큰)
- 무엇을 변경해야 하나요? (스킬, 프롬프트 또는 프로세스에 대한 구체적인 개선 사항)
변경 사항은 즉시 적용되며, 모든 회고는 영구 아카이브에 스냅샷으로 저장됩니다. 시간이 지나면서 Claude 워크플로우가 어떻게 발전해왔는지에 대한 실행 감사 추적이 구축되며, 각 세션이 진행될수록 의미 있게 빨라지는 설정으로 이어집니다.
0단계 — 아카이브 디렉토리 설정 (최초 실행 시)
회고를 시작하기 전에 회고 아카이브 디렉토리가 설정되어 있는지 확인하세요. Claude.md에서 다음과 같은 블록을 찾습니다.
## Retro-Bot
archive_dir: [경로]
이미 설정된 경우: 바로 1단계로 진행합니다. 다시 물을 필요 없습니다.
설정되지 않은 경우: 사용자에게 한 번 명확하게 물어봅니다.
"시작하기 전에 — 회고 스냅샷을 어디에 저장할까요? 이는 일회성 설정입니다. 폴더 경로를 알려주세요 (예:
H:\내 드라이브\회고또는~/Documents/retros). 앞으로 모든 회고를 자동으로 그곳에 저장하겠습니다."
사용자가 경로를 제공하면:
- Claude.md에 다음 블록을 추가합니다 (파일이 없으면 생성).
## Retro-Bot archive_dir: [사용자가 제공한 경로] - 디렉토리가 없으면 생성합니다.
- 해당 디렉토리에 빈
retro-log.md파일을 생성합니다 (6단계의 형식 참조). - 확인합니다: "설정 완료 — 회고 아카이브가
[경로]로 설정되었습니다. 앞으로 모든 회고가 그곳에 저장됩니다."
그런 다음 1단계로 진행합니다.
1단계 — 세션 컨텍스트 읽기
세션 기록을 읽어 실제로 어떤 일이 일어났는지 파악합니다. 환경에서 세션 기록이나 기록 도구를 제공하는 경우,
지금 사용하여 발생한 전체 기록을 가져옵니다. (Cowork에서는 자동으로 제공됩니다. Claude Code에서는
/transcript 또는 이와 동등한 기능을 사용할 수 있으면 사용합니다.) 전체 기록이 없더라도,
알고 있는 정보(사용된 스킬, 생성된 파일, 세션 중 사용자가 제공한 피드백, 재작업이 필요했던 부분)를 활용합니다.
사용자가 세션 직후 이 스킬을 호출하면 이미 컨텍스트를 가지고 있습니다. 나중에 설명과 함께 호출하면 그 설명을 바탕으로 작업합니다.
회고할 세션/작업이 명확하지 않은 경우 사용자에게 확인을 요청합니다.
2단계 — Claude가 관찰 내용으로 시작
먼저 시작합니다. 사용자가 불만 사항을 나열할 때까지 기다리지 말고, 사용자가 알아차린 것을 공유합니다. 이는 좋은 회고 행동을 보여주고, 주의를 기울이고 있었음을 나타내며, 사용자가 의식적으로 인지하지 못했지만 즉시 알아차릴 수 있는 것들을 자주 표면화합니다.
관찰 내용을 솔직하고 구체적으로 구성합니다.
- "SOW를 두 번 렌더링해야 했는데, 첫 번째 테이블 형식이 Word에서 깔끔하게 열리지 않았기 때문입니다 — 제가 고칠 수 있는 스킬 구성 문제입니다."
- "고객 브리프를 한 번에 보내지 않고 세 개의 개별 메시지로 보내셨습니다 — 작업 속도를 늦추는 워크플로우 패턴으로 기록할 가치가 있습니다."
- "범위 빌더와 SOW 빌더 스킬이 일관된 숫자를 생성했습니다 — 매끄러웠습니다."
- "중간에 알려주실 때까지 어떤 내보내기 형식이 필요한지 확신할 수 없었습니다 — 초기에 간단한 질문 하나로 왕복을 줄일 수 있었을 것입니다."
3~5개의 관찰 내용으로 유지합니다. 직설적으로 말하고 방어적으로 굴지 마세요. 당신은 증인이 아닌 참가자입니다.
3단계 — 사용자 입력 요청
시작 발언 후, 사용자에게 추가, 수정 또는 반박을 요청합니다.
"이것이 제 관찰 내용입니다. 사용자분의 목록은 무엇인가요? — 제가 놓친 점, 다르게 구성하고 싶은 점, 또는 꼭 기록하고 싶은 점이 있나요?"
사용자의 마찰 지점은 종종 여러분의 것과 다릅니다. 사용자는 혼란스러웠던 점, 그 순간에는 언급하지 않은 출력 품질 문제, 프로세스 상의 불편함, 또는 훌륭해서 유지해야 할 점들을 지적할 수 있습니다. 모든 것을 기록합니다.
4단계 — 회고 보드 작성
양측이 기여한 후, 전체 보드를 제시합니다. 구체적으로 작성하세요 — 모호한 항목은 유용한 실행 항목을 생성하지 않습니다.
## ✅ 잘된 점
- [순조로웠던 구체적인 사항]
- ...
## ❌ 아쉬운 점
- [구체적인 마찰 지점, 알려진 경우 근본 원인]
- ...
## 🔧 변경 아이디어
- ["아쉬운 점" 항목과 연결된 구체적인 제안]
- ...
계속 진행하기 전에 사용자에게 확인을 요청합니다.
"이게 잘 담겼나요? 실행할 항목을 정하기 전에 추가하거나 조정할 내용이 있나요?"
5단계 — 실행 항목으로 매핑
각 변경 아이디어에 대해 유형과 우선순위를 결정합니다.
| 유형 | 사용 시기 |
|---|---|
| 🔧 스킬 업데이트 | 문제가 스킬의 지침, 출력 형식 또는 기본 동작에서 발생한 경우 |
| 📋 프로젝트/세션 업데이트 | 특정 프로젝트, 클라이언트 또는 세션 유형에 국한된 컨텍스트 또는 지침 — 전역이 아님 |
| 📝 Claude.md 업데이트 | 모든 프로젝트와 세션에 걸쳐 항상 적용되어야 하는 누락된 컨텍스트 |
| 💡 프로세스 노트 | 행동 변화 — 파일 편집 불필요, 다른 작업 방식만 필요 |
| 🆕 신규 스킬 | 격차가 반복적이고 충분히 커서 자체 스킬을 가질 만한 경우 |
프로젝트/세션 업데이트와 Claude.md 업데이트의 주요 차이점은 범위입니다. 컨텍스트가 특정 프로젝트, 클라이언트 또는 특정 세션 유형에서 작업할 때만 적용되어야 한다면 프로젝트/세션 계층에 속합니다. 항상, 모든 곳에서, 사용자의 모든 작업에 적용되어야 한다면 Claude.md에 속합니다. 이것을 잘못 판단하는 것은 양방향으로 비용이 많이 듭니다: Claude.md에 너무 많은 내용이 있으면 클라이언트 간 노이즈와 컨텍스트 혼선이 발생하고, 프로젝트 파일에 너무 많은 내용이 있으면 프로젝트를 전환할 때마다 컨텍스트를 다시 설정해야 합니다.
각 실행 항목에 대해 무엇이, 어디서 변경되는지, 왜 중요한지, 그리고 지금 실행할지 나중을 위해 기록할지 명시합니다. 무엇이든 적용하기 전에 확인합니다.
"제가 제안하는 변경 사항입니다. 진행할까요?"
각 유형에 대한 자세한 지침은 references/action-item-types.md를 참조하세요.
6단계 — 버전 관리와 함께 변경 사항 적용
각 확인된 실행 항목을 복사-우선 버전 관리 패턴을 사용하여 적용합니다 — 소스 파일을 직접 덮어쓰지 마십시오.
규칙: 현재 파일 읽기 → 메모리에서 편집 적용 → 새 버전 파일명으로 쓰기 (예: SKILL-v1.1.md) →
이전 파일을 archive/에 보관합니다. 이렇게 하면 별도의 버전 관리 도구 없이도 복구 가능한 기록이 생성됩니다.
스킬 업데이트: 현재 파일 읽기 → 메모리에서 적용 → 새 버전 파일명으로 쓰기 → 이전 파일 아카이브 → 변경 로그 항목 추가. 사소한 수정은 패치를, 의미 있는 추가는 마이너를, 아키텍처 변경은 메이저를 올립니다.
프로젝트/세션 업데이트: 변경 범위에 맞는 올바른 지침 파일을 식별합니다 —
이는 프로젝트 수준의 CLAUDE.md (Claude Code), Cowork 세션 구성,
반복되는 클라이언트 작업을 위한 상설 브리프 파일, 또는 세션 유형에 범위가 지정된 사용자 지정 지침이 될 수 있습니다.
파일이 없으면 생성합니다. 다른 파일 변경과 동일한 복사-우선 패턴을 적용합니다.
일반적인 대상:
[프로젝트-폴더]/CLAUDE.md— 해당 프로젝트의 모든 Claude Code 세션에서 자동으로 로드됨[클라이언트-이름]-brief.md또는[프로젝트-이름]-context.md상설 참조 파일- Cowork 세션 수준 구성 또는 시스템 프롬프트
- Claude.ai 사용자 지정 지침 (계정 설정 → "Claude가 알아야 할 사항")
Claude.md 업데이트: 현재 파일 읽기 → 올바른 섹션에 새 컨텍스트 추가 → 새 버전 쓰기 → 이전 파일 아카이브. Claude.md가 없으면 생성합니다.
프로세스 노트: 회고 스냅샷에 문서화합니다 (별도 파일 불필요).
적용 후, 무엇이 변경되었는지 확인합니다.
"완료 — [스킬 이름]을 v1.1로 업데이트하고 Claude.md에 [주제]에 대한 노트를 추가했습니다."
7단계 — 회고 스냅샷 저장 및 감사 로그 업데이트
이 단계는 필수입니다 — 모든 회고 실행은 적용된 실행 항목 수와 관계없이 저장된 스냅샷을 생성해야 합니다. 스냅샷은 기록이고, 감사 로그는 피드입니다.
1단계: 회고 스냅샷 저장
전체 회고 스냅샷을 설정된 archive_dir에 저장합니다. 파일명 형식:
[archive_dir]/YYYY-MM-DD-[짧은-설명자]-retro.md
예: H:\내 드라이브\회고\2026-05-15-문서-제작-retro.md
설명자는 짧게 유지합니다 (3~5단어, 하이픈으로 연결): dashboard-build, content-draft, data-analysis-q2.
스냅샷 템플릿
# 회고 스냅샷: [세션 설명자]
**날짜:** YYYY-MM-DD
**세션 유형:** [SOW 빌드 / 데이터 분석 / 콘텐츠 / 코드 / 기타]
**사용된 스킬:** [쉼표로 구분된 목록]
**회고 형식:** [WWW / 시작-중지-계속 / 4Ls / 기타]
---
## ✅ 잘된 점
- [항목]
## ❌ 아쉬운 점
- [항목]
## 🔧 논의된 변경 아이디어
- [항목]
---
## 실행 항목 및 결과
| # | 변경 사항 | 유형 | 대상 | 상태 |
|---|---|---|---|---|
| 1 | [설명] | 스킬 업데이트 | [스킬] v1.0 → v1.1 | ✅ 적용됨 |
| 2 | [설명] | 프로젝트/세션 업데이트 | [프로젝트 CLAUDE.md / 클라이언트 브리프 / 세션 구성] | ✅ 적용됨 |
| 3 | [설명] | Claude.md 업데이트 | Claude.md | ✅ 적용됨 |
| 4 | [설명] | 프로세스 노트 | — | 📝 기록됨 |
| 5 | [설명] | 신규 스킬 | [이름] | 🔜 백로그 |
---
## 프로세스 합의 사항
[이번 회고에서 이루어진 행동 합의 사항 — 양측이 다음 번에 다르게 하기로 동의했지만,
파일 변경으로 이어지지 않는 사항]
## 미해결 질문 / 백로그
[나중을 위해 기록된 항목, 재검토할 사항, 또는 이번 회고의 후속 조치]
## 참고 사항
[보존할 가치가 있는 추가 컨텍스트]
2단계: 감사 로그 업데이트
스냅샷을 저장한 후, 아카이브 디렉토리의 retro-log.md에 한 줄을 추가합니다.
이 파일은 실행 중인 피드입니다 — 지금까지 실행된 모든 회고에 대한 한 눈에 볼 수 있는 기록입니다.
retro-log.md 형식 (최초 실행 시 이 헤더로 생성):
# 회고 로그
모든 Retro-Bot 세션의 실행 기록.
| 날짜 | 세션 | 적용됨 | 기록됨 | 백로그 | 스냅샷 |
|---|---|---|---|---|---|
각 새 회고를 하나의 행으로 추가합니다:
| 2026-05-15 | 문서 빌드 – 장문 제안서 | 2 | 1 | 0 | [링크](2026-05-15-제안서-문서-retro.md) |
- 적용됨: 상태가 ✅ 적용됨인 실행 항목 수
- 기록됨: 프로세스 노트 수 (📝 기록됨)
- 백로그: 🔜 백로그로 표시된 항목 수
두 파일을 저장한 후 확인합니다:
"회고 스냅샷이
[archive_dir]/[파일명]에 저장되었고 감사 로그가 업데이트되었습니다. 현재까지 [N]개의 회고가 기록되었습니다."
어조와 정신
- Claude가 먼저 시작합니다 — 사용자의 의견을 묻기 전에 자신의 관찰 내용을 공유하세요.
- 구체적으로 작성하세요 — "열 너비가 하드코딩되어 있어서
.docx테이블이 렌더링되지 않았습니다"가 "파일 형식이 잘못되었습니다"보다 훨씬 유용합니다. - 작은 변화가 누적됩니다 — 세션당 10분을 절약하는 3줄 수정은 빠르게 합산됩니다.
- 모든 것을 고칠 필요는 없습니다 — 잘 선택된 두 가지 변경 사항이 여덟 개의 성의 없는 변경 사항보다 낫습니다.
- 빠르게 진행하세요 — 10~15분을 목표로 하세요. 시간이 오래 걸리면 회고에서 문제를 식별하는 대신 해결하고 있는 것입니다. 해결은 6단계를 위해 남겨두세요.
참조 파일
references/retro-formats.md— 대체 형식: 4Ls, 시작/중지/계속, Mad/Sad/Glad, Sailboat. 사용자가 다른 형식을 요청하거나 기본 WWW보다 다양한 형식이 세션에 더 나을 때 읽으세요.references/action-item-types.md— 스킬 업데이트 대 Claude.md 대 프로세스 노트 대 신규 스킬에 대한 자세한 지침. 실행 항목의 유형이 모호할 때 읽으세요.
변경 로그
| 버전 | 날짜 | 변경 사항 |
|---|---|---|
| v1.0 | 2026-05-26 | 초기 버전 — 전체 회고 워크플로우, 6단계 구조, 복사-우선 버전 관리, 회고 보고서 템플릿 |
| v1.1 | 2026-05-26 | 0단계 아카이브 디렉토리 설정 추가 (Claude.md에 저장되는 일회성 구성), 필수 회고 스냅샷 저장, 실행 감사 로그(retro-log.md) 추가 (회고별 결과 추적) |
| v1.2 | 2026-05-26 | 프로젝트/세션 업데이트를 별도의 실행 항목 유형으로 추가 — 프로젝트 CLAUDE.md, Cowork 세션 구성, 클라이언트 브리프 파일, Claude.ai 사용자 지정 지침 포함; 사용자 수준 Claude.md와의 범위 구분 명확화 |
| v1.3 | 2026-05-29 | 플러그인 구조(skills/retro-bot/SKILL.md)로 마이그레이션, Claude Code 호환성을 위해 .claude-plugin/plugin.json 추가 |