Retrospective Loop

한눈에 보기

Retrospective Loop는 작업이 끝난 뒤 쓰는 감상문이 아니라, 실패와 지연을 다음 자동화 후보로 분류하는 운영 장치입니다. 한 번의 사건은 note로 남기고, 반복되는 패턴은 rule, skill, hook, eval로 승격합니다.

• 핵심 질문: 이번 실패를 다음 작업에서 어떻게 반복하지 않게 만들 것인가?
• 읽는 대상: 회고를 실행 가능한 개선으로 연결하려는 운영자와 reviewer
• 연결 문서: Memory & Knowledge Pipeline, Self-Improving Knowledge Loop, Policy to Harness Lifecycle

이 문서에서 확인할 것

• 오류, 실패, 실수, 원인, 재발방지를 나누는 기준
• guide, skill, hook, eval, doctor로 승격하는 경로
• 공개 가능한 회고를 작성하는 템플릿

회고는 기록이 아니라 승격 판단이다

Retrospective Loop는 작업 종료 후 남기는 감상문이 아닙니다. 실패, 지연, 충돌, 잘못된 전제를 다음 세션에서 반복하지 않도록 어디로 승격할지 정하는 과정입니다.

flowchart TD
  A["사건<br/>실패 / 지연 / 충돌 / 오판"]
  B["분류<br/>오류 / 실패 / 실수 / 원인"]
  C["판단<br/>한 번인가 반복인가"]
  D["Note<br/>PKB / decision"]
  E["Rule<br/>ai-rules"]
  F["Hook / Doctor / Eval<br/>keystone-hub"]
  G["Guide<br/>portfolio docs"]

  A --> B --> C
  C -->|한 번| D
  C -->|반복| E
  E --> F
  E --> G

분류 기준

분류	의미	다음 조치
오류	도구, 명령, hook, parser 실패	복구 방법과 재현 조건 기록
실패	시도했지만 목표 달성 실패	원인과 대안 정리
실수	에이전트 절차나 판단 위반	rule 또는 hook 후보
원인	왜 발생했는지	검증/추론 라벨로 분리
재발방지	다음에 무엇으로 막을지	docs, test, doctor, hook, skill 중 선택

승격 경로

반복 패턴	승격 위치
설명하면 충분한 운영 원칙	guide 문서
작업 중 자주 잊는 절차	checklist 또는 skill
반복되는 금지 패턴	hook
품질 회귀	eval 또는 replay fixture
도구 설정 drift	doctor
공개 가능한 구조적 교훈	portfolio 문서

Self-Improve와의 연결

sequenceDiagram
  participant Work as 작업 세션
  participant Memory as Memory Bank
  participant Retro as Retrospective
  participant Rules as ai-rules
  participant Hub as keystone-hub

  Work->>Memory: 대화와 fact 축적
  Memory->>Retro: 반복 패턴 검색
  Retro->>Rules: policy / skill 후보
  Retro->>Hub: hook / doctor / eval 후보
  Hub-->>Work: 다음 세션에서 자동 검증

회고 작성 템플릿

## 사건
무슨 일이 있었는가?

## 검증
확인된 사실은 무엇인가?

## 원인
추론이면 추론이라고 표시한다.

## 복구
이번에는 어떻게 해결했는가?

## 재발방지
docs, rule, skill, hook, eval 중 어디로 승격할 것인가?

공개 문서화 기준

공개 회고는 개인의 raw session transcript가 아니라 구조화된 학습입니다. 사람 이름, 회사 맥락, 로컬 경로, 구체적 토큰이나 비밀값은 제거하고, 판단 구조와 재발방지만 남깁니다.