처음엔 기록을 모으기만 했습니다. 지금은 모은 기록에서 교훈을 뽑아 다음 작업 전에 건넵니다. 8단계에 걸쳐 무엇이 생겼는지, 지금 무엇이 되고 무엇이 아직 안 되는지 그림 6장으로 정리합니다.
2026-09-23저장소 ~/git-projects/agent-tracev0.6.0 (61024fe) + 심각도 기준테스트 373개 통과
한 장 요약. agent-trace는 코딩 에이전트의 일기장을 읽는 선생님입니다. ① 일기장 네 종류를 한 가지 모양으로 옮겨 적고 ② 이상한 날에 빨간 펜으로 표시하고 ③ 왜 이상했는지 따져 보고 ④ "다음엔 이렇게"라는 한 줄로 줄여 ⑤ 다음 날 아침 가방에 넣어 줍니다. ①~⑤가 모두 이어졌고, v0.6.0부터는 ③도 사람 없이 하루 20건까지 돕니다. 선생님이 "이건 외워 둬"라고 직접 말하면 판정 없이 바로 가방에 들어갑니다.
887세션
6,125턴
258룰이 표시한 턴
10LLM 판정 (자동 4)
4교훈 (자동 생성 2)
26대화창 주입
2026-09-23 18시 로컬 DB 기준 · 세션은 Codex 518 · Claude Code 354 · Hermes 15
그림 18단계로 자란 과정
왼쪽은 "모으기", 가운데는 "고르기", 오른쪽은 "되돌려 주기"입니다.
그림 2지금 도는 고리 — 저절로 도는 것과 사람이 하는 것
위 줄은 watch를 켜 두기만 하면 돕니다. 아래 줄은 사람이 말하거나 명령을 칠 때만 돕니다.
그림 3에이전트별로 되는 것
"읽기"와 "건네기"가 둘 다 돼야 고리가 닫힙니다.
OpenCode는 말은 건네지만 듣지는 못합니다 — 파서가 없어 그 세션은 DB에 쌓이지 않고, 그래서 OpenCode에서 한 실수는 교훈이 되지 못합니다.
그림 4깔때기 — 어디가 가는가
6천 턴이 들어와 교훈 4개가 나옵니다. 막대 길이는 로그 눈금입니다.
v0.5.0까지는 고리는 이어졌지만 물이 거의 안 흘렀습니다(판정 6건, 사람이 돌려야 함). v0.6.0에서 watch가 표시된 최근 턴을 하루 20건까지 스스로 판정하고, 켜자마자 판정 4건 중 2건이 교훈이 됐습니다. 판정 1건은 실측 약 14초입니다.
그림 5심각도 — 2가 문턱이다
판정은 0~3으로 매깁니다. 2 이상이면 교훈으로 저장되고, 승인 없이 주입됩니다.
원래 판정 프롬프트에는 0(문제없음) ~ 3(심각) 한 줄뿐이라 1과 2를 LLM이 감으로 갈랐습니다. 지금은 위 기준을 프롬프트에 넣었고, 2의 기준을 "사용자가 정정했는가"로 두어 다음 턴 프롬프트로 확인할 수 있게 했습니다. 이 기준은 그 뒤의 판정부터 적용되고, 기존 판정은 옛 기준 그대로입니다.
그림 6아직 비어 있는 칸
OpenCode · OpenClaw 읽기
파서가 없습니다. OpenCode는 주입만 되고, OpenClaw는 아무것도 없습니다.
수집 범위
자동 교훈이 먼저 퍼짐
심각도 2 이상 자동 교훈은 사람이 보기 전에 주입됩니다. 판정이 틀리면 reject로 막아야 합니다.
안전
교훈 본문 180자 잘림
판정 문장을 180자에서 잘라 저장해 뒷부분이 주입되지 않습니다. lessons show도 잘린 글을 보여 줍니다.
정확도
룰 오탐
slow_turn은 툴 실행·사용자 대기도 "느림"으로 셉니다. aborted는 Claude Code에서 사실상 항상 거짓.
정확도
멈춤 감지 · 효과 측정
stall 룰은 계획만 있습니다. 주입 뒤 같은 실수가 줄었는지 재는 명령도 없습니다.
계획
팀 공유 · 홈 경로
교훈은 내 DB에만 있습니다. 훅은 CODEX_HOME 같은 경로 변수를 읽지 않습니다. Windows는 서비스 없음.
uv tool install "git+ssh://git@github.com/Dobraindev/agent-trace.git@v0.6.0"
agent-trace setup # 모으기 시작 + 상시 실행(자동 판정 하루 20건 포함)
agent-trace hook install # 네 도구에 건네기 연결
hermes plugins enable agent-trace # Hermes만 한 줄 더 · Codex는 codex 한 번 띄워 승인
agent-trace lessons list # 쌓인 교훈 보기 (source: judge / manual)
agent-trace lessons reject <id> # 아니다 싶은 자동 교훈 막기
agent-trace lessons add "배포 전에 tsc 돌릴 것" # 직접 넣기(대화 중 "교훈으로 저장해"와 같음)
AGENT_TRACE_AUTO_JUDGE_DAILY=0 # 자동 판정 끄기(~/.config/agent-trace/.env)