에이전트 세션을 안전하게 재개하는 상태 영속화 설계

Codex CLI에서 페이지네이션 스레드 이력, 효율적 재개, 검색, 이름 영속화, 서브에이전트 이력, 메모리가 실험적으로 함께 제공되면서 세션의 성격도 달라졌다. 창을 닫으면 끝나는 실행이 아니라, 나중에 찾고 이어갈 수 있는 작업 단위가 된 것이다.

문제는 이력을 남기는 일 자체가 아니다. 세션이 사라지면 같은 배경을 다시 설명해야 한다. 반대로 과거 대화를 전부 되살리면 이미 끝난 결정과 폐기한 전제가 다음 작업의 판단에 섞인다. 복원된 이력은 컨텍스트 예산도 차지한다. 세션 영속화는 결국 무엇을 남기고, 무엇을 재개 시점에 불러올지 정하는 설계다.

재개 가능한 세션이 갖춰야 할 경계

스레드에는 자동 생성 식별자와 사람이 읽을 수 있는 이름을 따로 둔다. 이름은 프로젝트와 작업 목적을 기준으로 정하는 편이 낫다. 첫 메시지를 그대로 이름으로 쓰면 안 된다. 실제 작업 성격은 대개 세션 중반에야 분명해진다.

이력은 시간 구간이나 턴 단위의 페이지로 나눠 필요한 부분만 읽을 수 있어야 한다. 긴 세션을 한 번에 불러오는 방식은 로딩 자체가 병목이 된다.

재개할 때는 최근 구간, 결정 사항, 활성 제약, 미해결 항목을 우선 복원 대상으로 둔다. 그 밖의 내용은 필요할 때 과거 페이지에서 찾아온다. 전량 복원을 기본으로 두면 재개 비용이 새 세션을 시작하는 비용보다 커질 수 있다.

요약은 재개 시점에 처음 만들기보다 페이지 경계, 주요 결정 발생 시점, 세션 종료 시점에 스냅샷으로 남겨야 한다. 그래야 재개가 느려지지 않고, 매번 서로 다른 요약이 생성되는 문제도 줄일 수 있다.

⤢✕

검색과 하위 실행 이력을 분리하는 방식

세션을 다시 찾으려면 이름, 요약, 결정 사항, 다룬 파일 경로, 사용 도구를 인덱싱 대상으로 삼는다. 전문 전체를 인덱싱하면 잡음이 많아 원하는 세션이 상위에 오기 어렵다.

서브에이전트 실행 이력은 상위 스레드 식별자에 연결하되, 상위 이력에는 요약만 노출한다. 하위 전문까지 상위 대화에 합치면 상위 이력은 곧바로 감당하기 어려운 크기가 된다. 반대로 결과만 남기면 위임된 판단이 어떤 근거에서 나왔는지 추적할 수 없다.

세션 이력과 장기 메모리도 같은 저장소로 취급하지 않는다. 반복해서 재사용할 사실만 장기 메모리로 승격하고, 일회성 작업 맥락은 세션 이력에 남긴다. 이력을 통째로 메모리로 쓰기 시작하면 일시적 맥락이 장기 기억에 섞이며 오염이 누적된다.

보존 대상과 운영 기준을 먼저 합의한다

영속화 대상은 대화 턴, 도구 호출 결과, 파일 변경, 결정 사항, 메모리 후보처럼 나눠 보존 여부를 정한다. 모두 남기는 방식은 저장 부담과 민감도 차이를 무시하게 된다.

명명 형식은 프로젝트, 작업 유형, 대상을 조합해 정하고 자동 제안과 함께 배포할 수 있다. 검색 품질은 일관된 명명에 크게 좌우되므로 자유 명명에만 맡기기 어렵다.

재개 시 자동으로 가져올 범위를 정한 뒤, 그 밖의 자료는 명시적 요청이 있을 때만 조회하게 한다. 매번 사용자가 복원 대상을 직접 고르게 하면 선택 부담 때문에 전량 복원을 선택하기 쉽다.

검색 요구사항도 실제 사용 장면에서 출발해야 한다. 사람들이 어떤 단서로 세션을 다시 찾는지 조사한 뒤 인덱스 대상을 정한다. 사람은 대개 파일 경로와 날짜를 기준으로 기억한다.

보관은 활성, 아카이브, 삭제 단계로 나누고 각 단계의 기간과 접근 권한을 정한다. 이 기간은 기술 편의만으로 정할 수 없다. 감사 요건이 보존 기간을 규정하는 경우가 있다. 만료 대상 식별, 삭제 실행, 예외 보존 신청은 절차로 자동화하고 담당을 지정해야 한다. 수동 정리에 의존하면 이력은 계속 쌓이고 아무도 삭제하지 않는다.

조직 표준에는 명명 규칙, 복원 기본값, 인덱스 대상, 보관 단계, 메모리 승격 기준을 포함한다. 재개 사용률, 평균 복원 토큰량, 검색 성공률, 만료 처리 이행률도 정기 보고 항목으로 둘 수 있다.

전체 복원과 요약 복원이 만드는 차이

구분	전체 이력 복원	요약 스냅샷 복원
맥락 충실도	높음	중간
컨텍스트 원가	큼	작음
재개 속도	느림	빠름
낡은 맥락 오염	큼	작음
근거 인용	가능	제한적
구현 부담	작음	큼

전체 이력 복원은 이전 대화의 근거를 그대로 남겨 세부 인용이 가능하고, 요약에서 빠질 수 있는 단서도 보존한다. 구현도 단순하다. 그러나 컨텍스트 예산을 크게 소진하고 종료된 논의나 폐기된 전제가 다음 판단에 들어올 수 있다. 세션이 길어지면 재개 자체가 어려워진다.

요약 스냅샷 복원은 결정 사항을 중심으로 재개하므로 새 작업에 쓸 예산을 남기고, 낡은 논의를 걸러내며 빠르게 시작할 수 있다. 대신 요약에서 빠진 세부가 필요하면 별도 조회가 필요하다. 스냅샷 품질이 낮으면 잘못된 전제에서 재개할 위험도 있고, 생성 로직을 유지해야 한다.

결정과 제약은 원문 그대로 보존하고 서술 맥락만 요약으로 바꾸는 혼합 방식은 두 접근의 충실도와 원가를 함께 다룬다.

검색 가능한 영속 스레드는 과거 작업을 다시 찾아 이어갈 수 있어 재설명 비용을 줄이고, 팀이 작업 맥락을 공유할 수 있게 한다. 반복 작업의 근거도 축적된다. 대신 저장 용량과 인덱스 유지 부담이 생기고, 민감 정보가 장기간 남을 수 있으므로 접근 통제가 필요하다. 이름과 정리가 부실하면 결국 세션을 찾지 못하고 새로 시작하게 된다.

일회성 세션은 저장과 정리 부담이 없고 민감 정보가 남지 않으며 깨끗한 맥락에서 출발한다. 하지만 같은 배경을 반복 설명해야 하고, 어제의 결정 근거나 중단된 작업을 이어받을 방법이 없다. 활성 기간에는 검색 가능한 영속 스레드로 두고 이후 자동 아카이브하는 구성이 재사용성과 부담 사이의 절충점이 된다.

하위 이력을 연결하면 위임된 판단의 근거를 되짚고, 잘못된 결과의 원인을 좁히며, 하위 실행의 비용과 시간을 귀속시키고 재현할 수 있다. 그만큼 저장량이 계층 수만큼 늘고, 상위에서 하위를 탐색하는 구조와 하위 이력의 민감 정보 관리가 복잡해진다. 상위 결과만 보존하면 구조와 저장은 단순하지만, 결과가 틀렸을 때 어느 하위 단계가 원인인지 알기 어렵고 하위 원가도 상위에 뭉뚱그려진다. 하위 요약만 상위에 연결하고 전문은 기간 제한을 둔 별도 저장소에 보관하는 방식이 추적성과 복잡도를 함께 관리한다.

정보 관리 관점에서 본 세션 이력

이력 페이지네이션과 인덱스는 데이터 저장 구조와 접근 성능을 다루는 설계다. 메모리와 이력을 분리하는 일은 데이터 유형별 관리 정책을 세우는 일에 해당한다.

활성, 아카이브, 삭제 단계를 나누는 것은 정보 수명주기와 보존·폐기 정책을 구현하는 방식이다. 요약 스냅샷은 보존 형태를 전환해 저장 효율을 다루는 수단이기도 하다.

검색 가능한 영속 스레드는 업무 맥락을 조직 자산으로 만드는 기반이 된다. 반복 재사용 사실을 메모리로 올리는 기준은 암묵 지식을 형식지로 전환하는 규칙에 대응한다.

2026년에 예상되는 변화

세션 이력은 도구의 로컬 저장에서 팀 공유 저장소로 옮겨가고, 접근 통제가 요건이 되는 방향으로 갈 수 있다. 재개 시 필요한 구간만 골라내는 복원 범위 판정도 자동화될 흐름이다.

서브에이전트 이력 연결은 오케스트레이션 표준에서 추적성 요건으로 다뤄질 수 있다. 세션 메모리와 장기 메모리의 경계 규칙 역시 도구 간 이식 대상으로 논의되는 흐름이다.

세션 영속화에서 남는 질문은 저장할지 여부가 아니다. 어떤 내용을 재개의 기본값으로 삼을지에 있다. 식별과 명명, 페이지 구조, 복원 범위 판정, 요약 스냅샷, 검색 인덱스, 하위 이력 연결, 보관 단계가 함께 갖춰져야 한다. 만료 처리가 절차가 되지 않으면 이력 속 자격 정보와 업무 내용은 보관 기간을 넘긴 채 쌓이게 된다.