TAU-HOME.COM
LOADING

실패 세션 전체를 다른 AI에 분석시켜 AGENTS.md와 훅을 패치하는 재귀 개선 팁

반복 실수나 삽질이 발생했을 때 작업 세션 ID와 딥링크를 새 세션에 전달해 근본 원인을 분석하고 AGENTS.md 및 훅에 재발 방지책을 반영하는 실전 노하우입니다.

tau · 2026년 10월 31일

#AI 에이전트 #Claude Code #Codex #하네스 엔지니어링 #AGENTS.md

실패 세션 전체를 다른 AI에 분석시켜 AGENTS.md와 훅을 패치하는 재귀 개선 팁

루샨(@lucian__03)은 AI 코딩 에이전트가 동일한 문제를 수 시간 동안 반복하거나 잘못된 방향으로 진행할 때, 인터넷에서 가져온 일반 지침 대신 실제 실패한 작업 기록 전체를 다른 AI 세션에 전달해 원인을 분석하고 하네스를 업데이트하는 방식을 사용한다고 소개했습니다.

실패 세션 히스토리와 딥링크를 활용한 재귀적 AI 에이전트 자기 개선 파이프라인 개요

이미지 출처: @lucian__03 (X)

루샨(@lucian__03)이 공유한 이 방법은 코드가 어디서 틀렸는가에 그치지 않고, 에이전트가 어떤 판단 과정에서 오해를 시작했고 왜 같은 시행착오를 반복했는지 사고 경로 전체를 역추적하는 것이 핵심입니다.

딥링크와 세션 ID를 이용한 히스토리 연계

루샨이 소개한 워크플로우에서는 Codex 스레드 딥링크와 Claude Code 세션 ID를 이용해 작업 이력에 접근합니다.

  • Codex 딥링크 활용: 기존 작업 목록에서 우클릭하여 딥링크를 복사한 뒤, 새로운 작업 세션에 그대로 붙여넣습니다. 새 세션은 전용 툴을 통해 이전 스레드 히스토리를 통째로 읽어들입니다.
  • Claude Code 세션 식별: 상태 표시줄(statusline)이나 종료 명령어(/exit 실행 시 출력되는 resume 문자열 등)를 통해 세션 ID를 확보할 수 있습니다.
  • 교차 분석: 루샨은 자신의 환경에서 Codex 딥링크를 Claude Code에 입력하자 Claude가 ~/.codex/sessions 경로의 해당 세션 파일을 찾아 작업이 꼬인 지점을 분석했다고 전했습니다. 이는 공식 Codex–Claude 연동 기능이 아닙니다.

재귀적 자기 개선 프롬프트와 하네스 패치

히스토리가 연결된 새 세션에는 단순한 코드 리뷰를 넘어 에이전트의 인지 오류를 진단하는 프롬프트를 투입합니다.

"codex://threads/1234..." -> 이 세션(thread)에서 두 번 이상 반복한 실수가 있는지 찾아주고, 병목현상은 없었는지 제대로 분석해서 보고해줘. 또 해결방안도 찾아서 알려줘.

루샨은 이 분석에서 얻은 개선 사항을 두 가지 경로로 프로젝트에 반영할 것을 제안합니다.

  1. AGENTS.md 및 CLAUDE.md 업데이트: 업데이트가 필요하면 핵심 내용을 몇 줄로 짧게 요약해 문서에 추가합니다.
  2. 훅(Hook) 신규 생성 및 수정: 하드 블록이 필요하면 새 훅을 만들거나 기존 훅의 업데이트를 제안합니다.

루샨은 자신의 저장소에서 실제로 발생한 실패 기록을 바탕으로 만든 패치가 좋은 효과를 보였다고 평가했습니다.

원문 출처

Impact-Site-Verification: 9b3ebd10-6c45-44cf-a014-5b8c19b7b285