Product notes ·
Claude로 복기 에이전트를 만드는 계획
기록 구조화, 원문 참조, 검증 기준을 설계하는 방법.
에이전트는 기록에서 시작합니다
ThinkerGain은 매매 기록을 복기하는 개인 AI 에이전트입니다. 메모를 정리하고, 기록한 행동을 자신의 계획과 비교하고, 다음에 살펴볼 질문을 찾는 일을 돕고자 합니다. 초기 프로토타입과 평가에서는 Claude를 우선 활용할 계획입니다. 제품의 중심은 이 작업 흐름이며, 모델 선택은 그 흐름을 구현하기 위한 기술적 결정입니다.
작은 예시 하나
확인 신호를 기다릴 계획이었다. 가격이 빠르게 움직이자 일찍 진입했다.
이 문장에서 확인할 수 있는 것은 기록한 진입이 계획한 확인 신호보다 앞섰다는 점입니다. 계획이 바뀐 이유까지 확정할 수는 없습니다. 에이전트는 그 구분을 유지하고 무엇이 달라졌는지 질문해야 합니다. 기록에 없는 감정을 사용자의 실제 판단인 것처럼 설명해서는 안 됩니다.
설명보다 기록을 먼저 정리합니다
첫 Claude API 작업은 계획, 기록한 행동, 원문 참조, 부족한 맥락을 일관된 형식으로 추출하는 것입니다. Claude의 구조화된 출력은 정해진 스키마에 맞는 응답을 지원합니다. 이를 기록 추출에 활용하고, 원문 식별자와 필드 값은 애플리케이션 코드에서 다시 검증할 계획입니다. 형식이 올바른 응답도 원문과 대조해야 합니다.
{
"plan": "확인 신호를 기다린다",
"recorded_action": "가격이 빠르게 움직이자 일찍 진입했다",
"source_ids": ["note-oct-08"],
"missing_context": ["계획이 바뀐 이유는 무엇인가?"]
}검토하려는 기록 형식입니다.
필요한 기록을 여는 도구
“어떤 진입이 내 계획과 달랐을까?”라는 질문에는 답변보다 관련 메모가 먼저 필요합니다. 에이전트에 범위가 제한된 읽기 전용 기록 검색과 원문 열기 함수를 제공할 계획입니다. Claude의 도구 사용에서는 모델이 함수 호출을 요청하고, 애플리케이션이 실행 결과를 돌려줍니다. 접근 권한 확인과 수치 계산은 애플리케이션이 맡습니다.
같은 기록을 Claude에서도 살펴보기
기록이 쌓이면 한 건보다 여러 기록에 걸친 질문이 중요해집니다. 대화할 때마다 파일을 새로 내보내지 않고 Claude에서 자신의 기록을 조회할 수 있도록, MCP(Model Context Protocol)를 통한 ThinkerGain 연결을 설계하고 있습니다. 어디서 복기를 시작하든 계획, 기록한 행동, 원문이 함께 유지되는 것이 목표입니다.
계획과 다르게 진입한 기록을 찾아줘. 그 차이를 확인할 수 있는 당시 메모도 보여줘.
첫 MCP 인터페이스에는 범위가 작은 읽기 전용 도구 세 개를 제공할 계획입니다.
search_records: 관련 기록을 찾고 기록 식별자를 반환합니다.read_record: 선택한 기록의 계획, 행동, 원문 참조를 조회합니다.read_source: 참조의 근거가 된 원본 메모를 반환합니다.
애플리케이션은 사용자의 접근 권한과 반환된 식별자를 검증합니다. Claude는 조회한 내용을 바탕으로 차이를 설명하거나 부족한 맥락을 질문합니다. 도구로 기록을 찾았다는 사실만으로 계획을 바꾼 이유까지 알 수는 없습니다. 앞의 메모에도 그 이유는 아직 남아 있지 않습니다.
같은 기록, 두 가지 복기 진입점
ThinkerGain 에이전트와 사용자가 쓰는 Claude 대화에서 같은 기록 조회 도구를 활용하려 합니다. Claude의 Messages API MCP 커넥터는 원격 도구 호출을 지원합니다. 현재 베타가 인터랙티브 화면까지 자동으로 제공하는 것은 아닙니다. 이후 단계에서는 MCP Apps를 검토해 지원되는 Claude 환경의 대화 안에 계획, 행동, 원문 화면을 가져오려 합니다.
외부 메모는 별도의 확장입니다. 예를 들어 사용자가 허용한 Notion 연결에서 매매 전에 작성한 계획을 가져올 수 있습니다. 이 경우에도 메모의 출처와 검토한 버전을 유지해야 합니다. 우선은 ThinkerGain의 자체 기록에 안정적으로 연결하는 데 집중합니다.
연결해도 유지해야 하는 기준
로그인한 사용자에게 허용된 기록만 반환하는지, 원문 참조가 정확한 내용을 여는지, 없거나 바뀐 메모를 부족한 정보로 남기는지 검증할 계획입니다. 메모는 읽어야 할 근거로 다루며, 에이전트의 접근 범위를 넓히는 명령으로 해석하지 않습니다. 첫 연결은 읽기 전용으로 설계하고, 복기 초안의 저장에는 사용자 확인을 거치려 합니다.
MCP 연결은 개발 중이며 아직 이용할 수 없습니다. 공개된 Review desk는 현재 페이지 안에서 편집 상태를 유지하며, 배포된 Claude 또는 MCP 백엔드를 호출하지 않습니다. 다음 구현 단계는 인증된 기록 저장소와 세 가지 조회 도구입니다.
추출과 설명은 나눠서 처리합니다
구조화된 추출 단계와 사용자에게 보여줄 설명 단계를 구분할 계획입니다. 문서 기반 답변에는 Claude의 기본 인용 기능도 평가하려 합니다. API는 인용 기능과 엄격한 JSON 출력을 한 요청에서 함께 지원하지 않으므로 별도 단계가 필요합니다. 어느 방식이든 사용자는 관찰의 근거가 된 원문을 열어볼 수 있어야 합니다.
검증하려는 기준
먼저 소규모 샘플 기록과 사람이 검토한 예상 관찰을 준비하려 합니다. 원문 링크가 올바른 기록을 여는지, 요약이 기록의 의미를 보존하는지, 불완전한 기록에서 추가 질문을 하는지 확인할 계획입니다. 수치 비교는 코드로 독립적으로 검증합니다. 이는 앞으로 수행할 테스트이며, 이미 확보한 정확도 결과를 뜻하지 않습니다.
현재 단계
ThinkerGain은 개발 중입니다. 기록에서 복기로 이어지는 흐름의 첫 버전을 만들고 있습니다. 개인 기록 분석과 복기에 집중하며, 종목이나 매수·매도 행동은 추천하지 않습니다. 프로토타입을 진행하면서 확인한 구체적인 내용을 이곳에 남기겠습니다.
API의 기록을 실제 복기로 연결합니다
화면은 에이전트가 만든 결과를 어디에 놓을지 구체적으로 보여줍니다. 추출한 계획과 행동은 비교 영역으로, 검증한 원문 식별자는 원본 메모로 연결됩니다. 부족한 맥락은 빈 정보로 드러내고, 사용자의 생각은 별도의 복기 메모에 남깁니다. 이 연결이 없는 설명문만으로는 우리가 만들려는 작업 흐름을 완성할 수 없습니다.
기록 추출과 근거에 충실한 해석에는 Claude를 우선 활용할 계획입니다. 다만 화면과 기록 형식은 특정 모델 하나에 종속시키지 않으려 합니다. 권한, 기록 조회, 필드 검증, 수치 계산은 애플리케이션이 담당합니다. 첫 평가에서는 선택한 기록이 바뀔 때 근거도 올바르게 바뀌는지, 불완전한 메모를 설명으로 채워 넣는 대신 질문으로 남기는지를 확인하려 합니다.
