「정리해」에 회고를 붙이다

기록만 쌓던 마무리 명령을 같은 실수를 막는 자리로

품앗이가 AX를 함께한 조직의 AI 작업방에는 첫 세팅 때 「정리해」와 「이어서」를 넣었습니다. 「정리해」는 대화를 마칠 때 오늘 한 일과 배운 것을 파일에 적는 명령입니다. 2026년 11월 4일, 이 「정리해」 맨 앞에 회고 단계를 붙였습니다. 무엇을 고쳤는지, 왜 고쳤는지, 각 조직의 AI에게 어떻게 시키면 되는지를 정리했습니다.

1. 지금까지의 「정리해」

하네스 기본세팅 지시문 ④에서 정한 「정리해」는 이렇습니다.

  • 오늘 한 일을 인수인계.md에 갱신한다
  • 배운 것이 있으면 레슨.md에, 오래 갈 사실이 있으면 메모리.md에 적는다
  • 무엇을 적었는지 보여준다

세션은 짧게 끊고 일은 이어 가게 해 준다는 점에서 이 구조는 잘 돌았습니다. 다만 한 가지가 빠져 있었습니다. 적기만 한다는 점입니다.

2. 무엇이 문제였나

레슨은 AI가 다음에 그 파일을 읽어야만 효과가 있습니다. 같은 실수가 다시 나오면 레슨이 한 줄 더 늘고, 늘어난 레슨은 다음 세션에 읽어야 할 분량을 또 늘립니다. 같은 실수가 두 번이면 레슨이 아니라 훅에서 다룬 문제가 「정리해」 안에서 매일 되풀이되고 있었던 셈입니다.

품앗이 본부 AI의 작업방에서 그 결과가 숫자로 드러났습니다.

  • 매 세션 싣는 메모리 목차가 40KB까지 불어나, 한도를 넘은 뒷부분은 잘린 채로 읽히고 있었습니다.
  • 되풀이 실수를 모아 둔 장부의 10개 갈래 가운데 6개는 처방 칸이 「없음, 읽기에 기댐」이었습니다. 기록은 있는데 막는 장치는 없다는 뜻입니다.

3. 어디서 실마리를 얻었나

MIT 라이선스로 공개된 AI 코딩 스킬 모음 mattpocock/skills에 retro라는 회고 스킬이 있습니다. 작업이 끝난 뒤 그 세션의 기록을 돌아보고, 다음 작업이 더 잘 되도록 작업 환경을 고칠 거리를 제안합니다. 스킬 설명서에 적힌 원칙은 셋입니다.

  1. 모양으로 잡히는 실수는 검사로 막는다. 금지된 명령, 잘못된 파일 위치, 틀린 형식처럼 기계가 보고 판정할 수 있는 실수는 글로 적지 말고 실패하는 점검 장치로 막습니다.
  2. 판단이 필요한 실수만 글로 남긴다. 말뜻을 잘못 읽었거나 맥락을 놓친 것처럼 장치로 잡을 수 없는 것만 기록으로 갑니다.
  3. 매번 싣는 지시문은 줄어야 한다. 회고가 잘 돌면 지시문이 길어지는 게 아니라 짧아집니다.

설명서에 따르면 이 스킬은 제안만 하고 고치지 않습니다. 무엇을 장치로 만들지는 사람이 고릅니다. 설명서는 또 매 세션 자동으로 돌리지 말라고 합니다. 별 탈 없이 끝난 세션은 가르쳐 줄 것이 없고, 억지로 돌리면 아무도 필요 없는 규칙만 쌓이기 때문입니다.

4. 무엇을 고쳤나

회고를 별도 명령으로 만들지 않고 「정리해」의 첫 단계로 넣었습니다. 기록하기 전에, 오늘 대화에서 AI가 실수했거나 헤맨 장면마다 먼저 묻습니다. 「이건 모양으로 잡히는 실수인가?」

오늘 있었던 일처리
모양으로 잡히는 실수레슨으로 끝내지 않고 「검사 후보」로 인수인계에 한 줄. 그 자리에서 만들지는 않는다
점검 장치가 있는데 안 걸렸다「끊긴 검사」로 한 줄. 새로 만들자 하지 말고 왜 안 걸렸는지
점검 장치가 멀쩡한 일을 막았다「오탐」으로 한 줄. 같은 오탐이 쌓이면 그 장치를 손볼 차례
판단이 필요한 실수지금처럼 레슨·메모리로

그리고 정리 끝 보고 마지막 줄에 「회고: 검사 후보 ○ · 끊긴 검사 ○ · 오탐 ○」을 붙입니다. 별 탈 없던 날이면 「회고 후보 없음」 한마디로 넘어갑니다.

지킬 것이 두 가지 있습니다.

  • 오늘 대화에서 실제로 있었던 장면만 씁니다. 장면을 짚지 못하는 일반론은 버립니다. 칸을 채우려고 지어내기 시작하면 회고가 잔소리 목록이 됩니다.
  • 정리하는 자리에서 장치를 만들지 않습니다. 「정리해」는 정리하고 멈추는 명령입니다. 만드는 일은 다음 대화에서 사람이 골라 시킵니다.

5. 왜 따로 만들지 않고 「정리해」에 넣었나

처음에는 회고를 별도 명령이나 별도 담당 AI로 두려 했습니다. 그런데 본부 작업 기록을 세어 보니, 개선을 맡기려고 만들어 둔 담당 AI가 최근 60일 동안 한 번도 호출되지 않았습니다. 따로 만든 장치는 부르는 사람이 없으면 돌지 않습니다.

「정리해」는 이미 매일 부르는 명령입니다. 그리고 대화를 마칠 때는 그날 헤맨 장면이 아직 대화 안에 남아 있습니다. 회고하기에 가장 좋은 때가 이미 「정리해」 자리였습니다.

6. 이 단계로 못 보는 것

회고는 그날 대화 하나만 봅니다. 그래서 점검 장치가 평소에 너무 자주 걸리는지는 알 수 없습니다. retro 스킬 설명서도 이 점을 약점으로 밝혀 두었습니다.

본부에서 최근 30일 동안 점검 장치가 작업을 막은 기록을 세어 보니 1,600건이 넘었고, 그 가운데에는 정당하지 않은 차단도 섞여 있었습니다. 기록을 보관하는 저장소에 올리는 일을 「홈페이지 배포」로 오인해 막은 것이 한 예입니다. 이런 것은 대화 하나로는 안 보이고, 한 달에 한 번 장치별로 몇 번 걸렸는지 세어 보는 감사로 따로 봐야 합니다.

7. 조직 AI에게 줄 지시문

아래를 복사해 각 조직의 AI 작업방에 붙여 넣으면 됩니다. 하네스 기본세팅 지시문 ④를 마친 작업방이 대상입니다.

오늘은 「정리해」를 한 단계 고치자.

지금 정리해는 오늘 한 일과 배운 것을 파일에 적기만 한다. 적은 것은 네가 다음에
읽어야만 효과가 있어서, 같은 실수가 또 나오면 레슨만 늘어난다. 그래서 정리해 맨 앞에
「회고」를 붙인다. 기계가 보고 잡을 수 있는 실수는 글이 아니라 점검 장치로 막고,
판단이 필요한 실수만 글로 남기려는 것이다.

진행 규칙은 늘 같다:
- 전문용어 없이 쉬운 말로, 한 번에 한 가지씩만.
- 파일을 고치기 전에는 무엇을 고칠지 먼저 보여줘.

순서:

1. CLAUDE.md의 「단축 명령어」 칸에서 "정리해" 줄을 찾아 그대로 보여줘.
   없으면 없다고 말해줘.

2. "정리해" 설명 맨 앞에 아래 단계를 덧붙여줘. 원래 있던 내용은 지우지 말고 그 뒤에 그대로 둔다.

   - 먼저 회고: 오늘 대화에서 네가 실수했거나 헤맨 장면을 하나씩 떠올려 넷으로 나눈다.
     가) 모양으로 잡히는 실수 (금지된 명령, 잘못된 파일 위치, 틀린 형식처럼
         기계가 보고 판정할 수 있는 것)
         → 레슨으로 끝내지 않고 「검사 후보」로 인수인계.md 「다음에 할 일」에 한 줄:
           무엇을 잡을지, 어떤 장치로 잡을지(훅이나 점검 스크립트).
           그 자리에서 만들지는 않는다. 만들지는 내가 고른다.
     나) 점검 장치가 있는데 안 걸렸다 → 「끊긴 검사」로 한 줄.
         새로 만들자 하지 말고 왜 안 걸렸는지 적는다.
     다) 점검 장치가 멀쩡한 일을 막았다 → 「오탐」으로 한 줄.
     라) 판단이 필요한 실수 (말뜻을 잘못 읽음, 맥락을 놓침, 사람 사이 일)
         → 지금처럼 레슨.md로.
   - 오늘 대화에서 실제로 있었던 장면만 쓴다. 장면을 못 짚는 일반론은 버린다.
   - 별 탈 없던 날이면 「회고 후보 없음」 한마디로 넘어간다. 억지로 찾지 않는다.
   - 정리 끝 보고 마지막 줄에 「회고: 검사 후보 ○ · 끊긴 검사 ○ · 오탐 ○」을 붙인다.
   - 정리가 끝나면 멈춘다. 검사 후보를 그 자리에서 만들지 않는다.

3. 고친 "정리해" 설명 전체를 보여주고, 내가 확인하면 저장해줘.

4. 연습을 한 번 하자. 지금 바로 "정리해"를 실행해서 회고가 어떻게 나오는지 보여줘.
   오늘이 별 탈 없던 날이면 「회고 후보 없음」이 나오는 게 맞다.

끝나면 「정리해」가 기록만 하는 명령에서, 같은 실수를 장치로 막을 후보를 골라 주는 명령이 됩니다. 검사 후보가 쌓이면 다음 대화에서 하나씩 골라 「이거 점검 장치로 만들어줘」라고 시키면 됩니다.

함께 읽기


작성: 품앗이 (2026-11-04) · 출처: mattpocock/skills 의 retro 스킬(MIT) 원칙을 품앗이 하네스의 「정리해」에 옮김