work-retro
Task 종료 시점의 작업 회고 초안을 자동 생성하고 memento-mcp에 적재해 피드백 루프를 만드는 Claude Code plugin.
무엇을, 왜
작업을 끝내고 회고를 쓰지 못하는 흔한 패턴 3가지를 강제로 노출시킨다:
- 왜 이 일을 했는지(근거) 가 정리되지 않음
- 단일안으로 직행하고 여러 대안을 비교하지 않음
- 결과가 나와도 측정·기록하지 않음
/work-retro [주제]를 호출하면 현재 대화 맥락 + 과거 유사 회고(memento recall)를 결합해 회고 md 초안을 만들고, 동일 내용을 memento에 reflect로 적재한다. 다음 회고 호출 시 직전 회고가 자동으로 다시 떠올라(recall) 누락 패턴이 점점 줄어든다.
측정(섹션 3)은 task 직후에 수치가 안 나오는 경우가 많아 의도적으로 보류한다. 회고 md에는 빈 placeholder만 남고, 측정값이 나오면 별도로 /work-retro-measure {파일경로}를 호출해 명시적으로 입력한다. (추측으로 채우는 것을 방지)
설치
상세 절차는 docs/installation.md 참조. 요약:
# 1. memento-mcp 서버 띄우기 (PostgreSQL+pgvector 필요)
# docs/memento-setup.md 참조
# 2. 환경변수
export MEMENTO_URL="http://localhost:57332/mcp"
export MEMENTO_ACCESS_KEY="<your-key>"
# 3. Claude Code 안에서
/plugin marketplace add hungrytech/work-retro
/plugin install work-retro@hungrytech-tools
사용
1) 회고 초안 만들기 (task 종료 직후)
/work-retro "task 주제" # 인자로 주제 지정
/work-retro # 직전 대화에서 추론
저장 위치: ~/.claude/work-retro-logs/YYYY-MM-DD/NN-{slug}.md
2) 나중에 측정값 추가 (수치가 나온 뒤)
/work-retro-measure ~/.claude/work-retro-logs/2026-05-05/03-juje-slug.md
/work-retro-measure "task 주제" # 주제로 가장 최근 회고 자동 매칭
회고 파일의 보류 섹션을 산출물/수치/예상대비/리스크로 채우고, memento도 amend로 갱신한다.
회고 템플릿 구조
- 1. 왜 이 일을 했는가 (근거) — 비어있으면 ⚠️ 미기록
- 2. 어떤 방안들을 고려했는가 — 표 형식, 1개 이하면 ⚠️ 단일안 직행
- 3. 실행 결과 / 측정 —
📊 측정 보류 placeholder만. /work-retro-measure로 채움
- 4. 학습 / 다음 행동
- 5. 관련 과거 회고 (memento recall) — 자동 채움
빈 칸을 강제로 채우지 않는다 (추측 회고는 노이즈가 됨). 누락은 시각적으로만 드러낸다. 측정 섹션은 task 직후 강제하지 않고, 사용자가 명시적으로 입력할 때만 추가된다.
디렉토리
.
├── .claude-plugin/plugin.json # 매니페스트 + mcpServers 등록
├── skills/work-retro/SKILL.md # 워크플로우 정의
├── commands/work-retro.md # /work-retro 슬래시 명령
├── templates/retro-template.md # 회고 템플릿
├── scripts/ # next_log_path.sh, slugify.sh
└── docs/ # memento-setup, installation
라이선스
MIT — LICENSE
hungrytech
