ThoughtDAG로 에이전트 변경 근거 추적

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

ThoughtDAG의 새 Why CLI는 데스크톱 캔버스를 열지 않고도 로컬 에이전트 transcript에서 특정 파일과 관련된 대화를 찾습니다. 검색 결과는 원래 질문, 답변, 도구 호출 흐름으로 돌아갈 수 있으며, 실제 도구 호출에 기록된 편집·쓰기 결과는 Δ, 에이전트 답변에서 복원한 검증되지 않은 설명은 ≈로 구분합니다. CLI는 파생 인덱스를 로컬에서 조회하므로 LLM 호출이 필요하지 않고, 선택적 stdio MCP 서버는 why_check, why_file, find, recall_turn 네 가지 읽기 전용 도구를 제공합니다. 다만 지원되지 않는 로그 형식이나 누락된 기록은 결정이 없었다는 증거가 아니며, MCP를 통해 반환된 transcript가 에이전트와 provider에 전달될 수 있어 비공개 작업에서는 데이터 처리 정책을 확인해야 합니다.

실용적 조언

에이전트가 파일을 수정하기 전에 `npx thoughtdag why 파일경로`로 관련 turn과 도구 호출을 확인하고, 답변의 ≈ 표시를 검증된 변경 원인으로 간주하지 않는 편이 안전합니다.
비공개 저장소에서 stdio MCP 서버를 사용할 때는 반환된 transcript가 호출한 에이전트와 provider에 전달될 수 있으므로 provider의 데이터 처리 정책을 먼저 확인해야 합니다.

섹션별 상세

01

ThoughtDAG는 데스크톱 캔버스를 열지 않고 파일을 출발점으로 과거 에이전트 작업을 조회하려는 업데이트를 내놓았습니다. 사용자는 `npx thoughtdag why src/lib/api.ts`처럼 파일 경로를 입력하고, 지원되는 로컬 agent transcript에서 해당 파일과 맞는 turn을 찾을 수 있습니다. 검색 결과가 원래 질문과 답변, 도구 호출 기록으로 이어지므로 에이전트가 어떤 맥락에서 파일을 수정했는지 확인하는 흐름이 만들어집니다.

02

이 도구는 에이전트의 설명과 실제 변경 기록을 같은 종류의 근거로 취급하지 않습니다. 도구 호출에 기록된 편집이나 쓰기는 Δ로 표시하고, 에이전트 답변에서 복원한 후보 설명은 ≈로 표시해 검증되지 않은 이유임을 구분합니다. 따라서 에이전트가 수정이 끝났다고 말해도 기록된 작업이 다른 방향을 가리키면 답변은 에이전트가 그렇게 말했다는 근거일 뿐 변경이 옳았다는 증명이 되지 않습니다.

03

검색 기능은 정확한 구문 검색과 전체 turn 회수를 포함하며, 선택적으로 stdio MCP 서버를 붙일 수 있습니다. 서버는 why_check, why_file, find, recall_turn 네 가지 읽기 전용 도구를 제공하고 캔버스나 원본 소스 세션을 수정하지 않습니다. CLI는 로컬 파생 인덱스를 LLM 호출 없이 조회하지만, MCP 호출 결과의 transcript 내용은 해당 도구를 부른 에이전트가 받을 수 있으므로 비공개 작업에서는 provider의 데이터 처리 방식을 확인해야 합니다.

04

현재 구현은 초기 developer preview로, 지원되는 로그가 실제로 기록한 정보에만 의존합니다. 기록이 빠졌거나 형식이 지원되지 않으면 과거 결정이 없었다고 결론 내릴 수 없으며, 첨부 카드는 예시 조회 화면일 뿐 benchmark가 아닙니다. 이 제한은 검색 결과를 변경 원인의 확정 판정이 아니라 기록에 남은 질문·답변·작업 흐름을 확인하는 보조 근거로 사용해야 함을 뜻합니다.

이미지 분석

Screenshot
화면에는 하나의 파일에 대해 12개 turn과 6개 session이 검색되고, agent session의 EDIT·WRITE 작업이 질문 및 변경 내용과 함께 표시됩니다. Δ 기호가 `storedProviders` 변경이나 검증된 in-memory provider 경로 추가처럼 도구 기록에 남은 작업을 나타내며, 원본 세션은 변경되지 않고 파생 인덱스만 로컬에 남는 구조가 함께 표시됩니다. 본문이 설명한 파일 기반 검색과 읽기 전용 동작을 시각적으로 뒷받침하지만 성능 benchmark 결과는 아닙니다.
ThoughtDAG의 로컬 context history 기능과 `npx thoughtdag why src/lib/api.ts` 조회 화면을 담은 카드입니다.

Screenshot
이 이미지는 `npx thoughtdag why src/lib/api.ts` 명령과 12개 turn, 6개 session이라는 조회 결과를 보여줍니다. EDIT와 WRITE 세션이 질문과 Δ 변경 기록으로 연결되고, 하단에는 source sessions stay unchanged와 derived index stays on this machine이라는 로컬·읽기 전용 특성이 표시됩니다. 기능 사용 예시를 구체화하지만 본문이 밝힌 대로 benchmark 수치를 제공하지는 않습니다.
ThoughtDAG의 로컬 context history 기능과 파일별 에이전트 turn 검색 결과를 보여주는 동일한 예시 카드입니다.

용어 해설

에이전트 기록(Agent Transcript): — 에이전트가 작업 중 남긴 질문, 답변, 도구 호출 기록을 뜻합니다. ThoughtDAG는 이 기록에서 특정 파일과 연결된 대화를 찾아 변경의 근거와 당시 작업 흐름을 되짚습니다.
stdio MCP 서버(stdio MCP Server): — 표준 입출력으로 MCP 도구를 제공하는 서버입니다. ThoughtDAG에서는 에이전트가 로컬 transcript를 읽을 수 있도록 네 가지 읽기 전용 도구를 노출하지만 파일이나 원본 세션을 수정하지 않습니다.
파생 인덱스(Derived Index): — 원본 기록에서 검색을 위해 별도로 만든 색인 데이터입니다. ThoughtDAG의 파생 인덱스는 로컬에 저장되며 CLI 검색은 LLM 호출 없이 이 색인을 조회합니다.
읽기 전용 접근(Read-only Access): — 데이터를 조회할 수 있지만 원본을 변경할 수 없는 접근 방식입니다. 이 프로젝트의 CLI와 MCP 도구는 캔버스와 소스 세션을 수정하지 않아 기록 보존을 우선합니다.

코드 예제

bash

npx thoughtdag why src/lib/api.ts

파일 경로를 입력해 해당 파일과 연결된 로컬 에이전트 세션의 일치하는 대화를 조회합니다.

언급된 도구

ThoughtDAG중립링크

로컬 에이전트 transcript를 파일별로 검색하고 원래 turn과 도구 작업 흐름을 회수하는 오픈소스 도구입니다.

stdio MCP server중립

why_check, why_file, find, recall_turn 네 가지 읽기 전용 도구로 transcript 조회 기능을 에이전트에 노출합니다.

언급된 리소스

GitHubThoughtDAG GitHub 저장소

API DocsThoughtDAG CLI/MCP reference