agent-trace — 에이전트의 블랙박스를 읽어
교본에 한 줄 적어 넣는 도구

그림 1전체 그림 — 기록에서 교본까지

왼쪽에서 오른쪽으로 한 번 흐르고, 마지막에 다시 왼쪽으로 돌아옵니다.

그림 2어디서 읽나 — 미들웨어가 아닙니다

에이전트는 agent-trace가 있는지도 모릅니다. 원래 남기던 파일을 나중에 읽을 뿐입니다.

그림 3번역 — 세 가지 모양을 하나로

도구마다 기록 형식이 다릅니다. 도구별 통역사(파서)가 같은 모양으로 바꿔 줍니다.

그림 4저장과 화면 — 정본 하나, 뷰어 하나

SQLite가 정본입니다. Phoenix는 그것을 보여 주는 별도 프로그램(Docker 컨테이너)입니다.

그림 5문제 턴 — 룰 7개가 후보를 찍습니다

"확실히 나쁜 턴"이 아니라 "볼 가치가 있는 턴"을 넓게 잡습니다. 진짜 판정은 다음 단계에서.

그림 6판정과 환류 — 교본에 한 줄이 들어가기까지

네 명령이 이어지고, 마지막은 반드시 사람이 승인합니다.

그림 7서브에이전트 — 부모 턴 안에 자식 턴

에이전트가 다른 에이전트를 부르면, 그 대화도 따로 기록되고 부모 턴 아래에 붙습니다.

오늘숫자로 한눈에 — 2026-09-18

SQLite 254MB · watch가 launchd로 상시 실행 중 · 이 문서를 만든 대화도 이미 들어가 있음

관련 문서

• agent-trace 실행 가이드 — 설치·명령·환경변수·한계. 이 그림 설명의 본문
• Phoenix 트레이스 대시보드 사용법 — 그림 4의 화면을 실제로 쓰는 법
• 개발 에이전트 관측성 + Judge LLM 적용 설계 — 왜 로컬에 두었는지(아동 실명 개인정보 게이트)
• LiveKit 워커 열화 현상 쉬운 설명 — 같은 eli5 형식의 다른 문서