핵심 요약

• 병합된 PR이 있어도 열린 관련 PR이나 진행 중 세션이 있으면 삭제 후보가 아닙니다.
• worktree는 upstream 추적, outgoing commit, 미반영 변경을 확인할 수 없으면 강제로 지우지 않는 편이 안전합니다.
• 테스트 결과·결정 기록·되돌리기 단서가 필요하다면, 먼저 보관 경로와 책임자를 정해야 합니다.
• 완료 처리와 영구 삭제 사이에는 팀이 정한 유예 또는 hold를 둬야 실수 복구 여지를 남길 수 있습니다.

PR 병합과 안전한 삭제는 같은 결정이 아닙니다

에이전트가 만든 PR이 병합되면 팀은 자연스럽게 “작업이 끝났다”고 느낍니다. 그러나 실제 운영에서는 그 뒤에 확인할 것이 남습니다. 다음 작업이 같은 세션을 이어야 할 수도 있고, CI 결과나 변경 이유를 다시 확인해야 할 수도 있으며, worktree에 아직 커밋되지 않은 파일이 있을 수도 있습니다.

따라서 삭제 판단의 단위는 PR 하나가 아니라 재현 가능한 작업 묶음입니다. 이 묶음에는 PR 상태, Git 상태, 대화 및 artifact의 보관 위치, 보존 보류 사유, 그리고 삭제 후 확인 기록이 함께 들어갑니다. 비용을 아끼기 위해 저장 공간을 비우는 일도 중요하지만, 되돌릴 단서까지 함께 없애는 비용은 훨씬 큽니다.

공식 cleanup 기능이 알려 주는 최소 조건

VS Code의 세션 관리 공식 문서는 병합된 세션의 자동 정리를 preview 기능으로 설명합니다. 두 자동 정리 설정은 기본적으로 비활성이고, 완료 처리와 영구 삭제 사이에는 별도의 유예 기간을 둘 수 있습니다.

문서가 제시하는 적격 조건도 단순하지 않습니다. 세션이 진행 중이 아니고, 마지막 수정 시점이 설정 기간을 넘었으며, 병합된 PR이 하나 이상 있고, 관련 PR이 열려 있지 않아야 합니다. 또한 자동 완료된 세션만 자동 삭제 대상이 되며, 사람이 수동으로 완료 처리한 세션까지 자동으로 지워지는 것은 아닙니다.

특히 worktree는 Git 상태가 불명확하거나 upstream 추적이 없고, outgoing commit 또는 미반영 변경이 있으면 제거하지 않는다고 명시합니다. VS Code 1.138 릴리스 노트와 GitHub Copilot 변경 이력도 이 흐름이 선택적으로 켜는 preview 정리 기능임을 교차로 보여 줍니다.

5칸 세션 보존·삭제 계약

아래 다섯 칸은 제품 설정을 대신하는 규칙이 아니라, 팀이 삭제 결정을 설명할 수 있게 만드는 최소 기록입니다. 한 칸이라도 비어 있으면 “삭제”가 아니라 “보류”가 기본값입니다.

1. 1. PR 상태
   병합 여부만 적지 말고 관련 PR이 모두 닫혔는지, 후속 수정 PR이 열려 있지 않은지 확인합니다. 담당자는 PR 링크와 확인 시각을 남깁니다.
2. 2. Git·worktree 상태
   브랜치의 upstream, outgoing commit, uncommitted change를 확인합니다. 확인할 수 없거나 변경이 남아 있으면 제거하지 않습니다.
3. 3. 재현 artifact
   테스트 결과, 검토 메모, 배포·되돌리기 단서가 필요한지 판단하고, 필요하다면 보관 경로와 접근 권한을 기록합니다.
4. 4. hold·유예
   incident, 감사, 보안 조사, 후속 작업 대기처럼 삭제를 멈추는 사유와 해제 담당자·예정일을 분리해 적습니다.
5. 5. 삭제 검증
   삭제 직전의 확인자와 대상 목록, 삭제 뒤 재접속·재현에 영향이 없는지 확인한 결과를 남깁니다.

완료·보관·삭제를 고르는 결정표

“완료”는 화면에서 작업을 정리하는 상태이고, “보관”은 근거를 남기는 상태이며, “삭제”는 되돌릴 수 없는 실행입니다. 같은 칸이라도 이 세 상태의 기준을 섞지 않는 것이 중요합니다.

표는 좁은 화면에서 좌우로 밀어 전체 내용을 확인하세요.

바로 지우면 안 되는 다섯 가지 신호

• 열린 관련 PR: 병합된 PR과 연결된 수정·검토 PR이 하나라도 남아 있다면 대화 맥락과 worktree를 유지합니다.
• 미반영 변경: uncommitted change나 outgoing commit이 있다면 먼저 변경의 주인과 처리 경로를 확인합니다.
• 재현 자료 부재: 테스트 로그나 변경 이유가 필요한데 정한 저장 위치가 없다면 삭제를 멈춥니다.
• 해제되지 않은 hold: 인시던트, 감사, 보안 조사가 끝나지 않았거나 해제 담당자가 없으면 삭제하지 않습니다.
• 삭제 후 책임자 부재: 삭제 대상과 확인 결과를 읽고 판단할 사람이 없으면 유예를 연장합니다.

이 체크리스트는 권한 관리에도 도움이 됩니다. artifact는 필요한 사람만 접근할 수 있는 경로에 두고, 세션을 지운다고 해서 다른 저장소의 로그나 백업까지 사라진다고 가정하지 마세요. 대상별로 실제 보존 위치와 접근 권한을 확인하는 편이 안전합니다.

가상의 merged PR로 계약 채우기

가상의 PR-248이 병합됐다고 해보겠습니다. 담당자는 먼저 관련 PR을 확인했는데, 문서 보완용 후속 PR이 열려 있었습니다. Git 상태에서는 worktree에 커밋되지 않은 메모 파일도 발견됐습니다. 이 경우 세션을 완료 목록으로 옮기는 것은 가능할 수 있어도, worktree 삭제는 보류하는 편이 맞습니다.

이 예시의 핵심은 “병합했으니 삭제”가 아니라 “어떤 조건이 남아 있어 보류했는가”를 팀이 나중에도 읽을 수 있게 하는 데 있습니다. 원격 작업을 다른 사람이 이어받아야 한다면 원격 세션 인수 때 먼저 확인할 항목도 함께 정리해 두세요. 병합 전의 인수 기준은 비동기 PR 인수 기록에서 별도로 다룹니다.

팀에 바로 적용하는 최소 운영 순서

1. 병합 직후 삭제하지 말고 5칸 계약을 새로 만듭니다.
2. 보류가 하나라도 있으면 완료 또는 보관으로만 상태를 바꾸고 삭제 예정일을 단정하지 않습니다.
3. 보관 경로에는 필요한 artifact만 두고 접근 권한을 확인합니다.
4. hold가 해제되면 Git·worktree 상태를 다시 확인합니다.
5. 삭제 뒤에는 대상 목록과 확인 결과를 남겨 다음 인수자가 판단할 수 있게 합니다.

자주 묻는 질문

PR이 병합됐으면 대화만 남기고 worktree는 지워도 되나요?

그렇게 단정하기 어렵습니다. worktree의 Git 상태와 필요한 artifact의 보관 여부를 먼저 확인하세요. 미반영 변경이나 재현 단서가 남아 있다면 삭제를 보류해야 합니다.

사람이 완료 처리한 세션도 자동으로 지워지나요?

VS Code 공식 문서의 자동 정리 흐름에서는 자동으로 완료 처리된 세션만 자동 삭제 대상입니다. 수동 완료와 자동 삭제를 같은 동작으로 보면 안 됩니다.

유예 기간은 며칠로 정해야 하나요?

팀의 배포 주기, 인수 방식, 감사·보안 요구에 따라 다릅니다. 제품 문서의 예시 기간을 조직 전체의 정답으로 쓰기보다, hold 해제 담당자와 재확인 시점을 함께 정하세요.

세션을 삭제하면 로그와 백업도 함께 없어지나요?

아닙니다. 세션, worktree, artifact 저장소, CI 로그, 백업은 서로 다른 보존 경로일 수 있습니다. 삭제 전에는 각 대상의 실제 위치와 접근 권한을 따로 확인해야 합니다.

참고 자료

• VS Code — Manage agent sessions: 자동 완료·삭제의 적격 조건, 별도 유예, worktree 제거 제한을 확인할 수 있습니다.
• Visual Studio Code 1.138 release notes: merged session 정리 기능의 preview 성격과 기본 비활성 설정을 설명합니다.
• GitHub Copilot weekly releases — September 14: VS Code 1.138의 선택적 session cleanup 흐름을 교차 확인합니다.

대화 기록 자체를 어느 범위까지 남길지 고민 중이라면 AI 에이전트 대화 기록의 보존 경계도 함께 읽어 보세요.