Markdown 핸드오프를 이용해 AI 코딩 세션의 컨텍스트 유지하기

AI 코딩 세션이 작동하는 패치와 함께 끝났더라도, 작업을 이어가기는 여전히 어려울 수 있습니다. 코드만으로는 무엇이 변경되었는지 보여줄 뿐입니다. 대화에는 더 많은 내용이 포함될 수 있습니다. 어떤 접근 방식이 거부되었는지, 어떤 명령어가 실패했는지, 테스트가 실제로 무엇을 검증했는지, 그리고 조사가 어디서 멈췄는지가 포함됩니다.

이러한 컨텍스트는 다른 사람에게 작업을 인계하거나, 새로운 작업을 시작하거나, 도구를 전환할 때 중요합니다.

Session Exporter는 Tor Production에서 만든 오픈 소스 플러그인으로, ChatGPT 또는 Codex 대화의 접근 가능한 컨텍스트를 Markdown 핸드오프로 변환합니다. 이 플러그인은 자체적인 MCP 서버나 계정 연결 없이도 지침을 스킬로 패키징합니다.

기본 범위에는 전체 접근 가능한 기록(transcript), 정리된 컨텍스트, 그리고 무결성 보고서가 포함됩니다. 가장 유용한 부분은 결정 사항을 그 배경이 되는 증거와 연결하여 유지하는 것입니다.

결정과 증거 보존하기

핸드오프는 다음 독자가 네 가지 질문에 답할 수 있도록 해야 합니다:

• 무엇을 하려고 하는가? 목표, 제약 조건 및 현재 상태.
• 왜 이 접근 방식을 선택했는가? 결정 사항과 관련 실패 시도들.
• 무엇이 검증되었는가? 결론을 뒷받침하는 파일, 명령어, 테스트 결과 또는 출처.
• 무엇이 남아 있는가? 미완성된 작업, 누락된 정보 및 다음 유용한 단계.

Session Exporter의 구조는 작업에 맞춰 조정됩니다. 디버깅 세션은 리포지토리 상태와 테스트 출력이 필요할 수 있고, 연구 세션은 출처와 해결되지 않은 질문이 필요할 수 있습니다. 적용 불가능한 섹션은 생략됩니다.

핸드오프가 검토되어야 할 때 기록은 여전히 유용합니다.

목표: 워커의 임대 기간이 만료된 후 완료를 방지합니다.
결정: 쓰기 트랜잭션 내에서 소유권 및 만료일을 확인합니다.
검증됨: 잠금을 기다리는 동안 만료되는 것을 다루는 결정론적 테스트가 있습니다.
...

다음 세션은 이제 재개할 특정 위치를 갖게 되었습니다. 또한 어떤 결론에 아직 증거가 필요한지도 알고 있습니다.

실제 내보내기(export)는 세션에서 사용 가능한 명령어, 결과 및 문구를 보존해야 합니다. 만약 상세 정보를 검색할 수 없다면, 문서에는 그 공백을 표시해야 합니다.

Codex 작업으로 시도해 보기

프로젝트의 설치 가이드를 통해 공개 플러그인 디렉터리(Plugins Directory)를 열고, Session Exporter by Tor Production을 찾아 설치합니다.

설치 후 새로운 Codex 작업을 시작하여 해당 기능이 사용 가능하도록 합니다. 이는 문서화된 플러그인 설치 흐름을 따릅니다.

해당 작업이 핸드오프(handoff) 준비가 되면 다음과 같이 요청합니다:

Use $session-exporter to export this entire conversation
to Markdown for handoff.

기본 파일명은 session_export, 타임스탬프, 그리고 짧은 컨텍스트 접미사를 조합하여 생성됩니다. 파일을 검토한 후, 마크다운을 읽을 수 있는 다음 사람이나 도구에 제공합니다. 작업을 계속하는 데 관련 리포지토리나 파일의 접근이 필요한 경우 포함해야 합니다.

README에는 Git 마켓플레이스 설치 경로와 설치된 기능(skill)을 사용할 수 없는 채팅에 대한 복사-붙여넣기 대체 방법도 문서화되어 있습니다.

파일이 담을 수 있는 것 알기

내보내기는 현재 세션에서 접근할 수 있는 정보만 포함할 수 있습니다. 이전에 존재했지만 더 이상 검색할 수 없는 메시지는, 비록 한때 대화에 존재했더라도 공백으로 남아 있습니다. 무결성 보고서(integrity report)는 사용 불가능한 자료, 누락된 부분, 그리고 검열된 부분을 기록합니다.

공개 스킬 지침(public skill instructions)은 숨겨진 시스템 지침과 비공개 사고 과정(chain-of-thought)을 제외하며, 노출된 비밀 정보는 마스킹(redaction)해야 합니다. 공유하기 전에 생성된 파일을 검토하세요: 이 요구 사항이 완벽한 비밀 탐지를 보장하는 것은 아닙니다.

이 플러그인은 분석 기능, 자동 업로드 또는 동기화 기능을 추가하지 않습니다. 내보낸 데이터는 다른 곳으로 전송하지 않는 한 현재 환경에 머무릅니다. Markdown 핸드오프 또한 권한을 이전하거나 수신 도구에 귀하의 계정에 대한 접근을 부여하지 않습니다.

연속성이 중요한 경우 사용하기

이 방식은 일시 중단된 조사, 다른 에이전트에게 전달되는 검토 작업, 또는 여러 세션에 걸쳐 진행되는 프로젝트에 유용합니다. 작고 독립적인 작업의 경우 간단한 요약만으로 충분할 수 있습니다.

실질적인 점검 사항은 다음과 같습니다: 다음 독자가 무엇이 확인되었는지, 그리고 다음에 무엇을 해야 하는지 식별할 수 있는가? 주장에 증거가 부족하면 출처를 추가하거나 미해결로 표시하세요.

저장소에 구현 내용, 설치 옵션 및 전체 내보내기 지침이 포함되어 있습니다.

AI 고지: 이 기사는 프로젝트 문서를 사용하여 AI가 초안 작성 및 편집했습니다. 디버깅 발췌 내용은 예시적입니다. 측정된 시간, 토큰 또는 할당량 절감은 주장되지 않습니다.