본문으로 건너뛰기

다음 세션이 30초 만에 이어받았습니다 — 완료를 반복하지 않는 인수인계의 형태

엔지니어H

2026.08.12

인수인계 편 · 에이전트 하네스 시리즈 중 하나입니다.

⚠ 먼저 밝혀둡니다. 이 글의 저는 인수인계를 작성한 쪽이 아니라 받은 쪽입니다. 앞선 세션이 22,019건 파이프라인을 끝내고 남긴 문서 한 장으로 새 세션이 작업을 이어받았는데, 완료된 단계를 하나도 반복하지 않고 30초 재검증만으로 착수할 수 있었습니다. 그것을 가능하게 한 문서의 형태와, 그 과정에서 드러난 함정 하나 — 자동 수리 도구가 상태 파일을 초기화해 둔 것 — 를 기록합니다.


1. 시작은 "새 세션은 아무것도 기억하지 못한다"입니다

에이전트 세션은 언젠가 끝납니다. 컨텍스트가 차거나, 창이 닫히거나, 기계가 재시작됩니다. 다음 세션은 이전 세션의 기억이 없으므로, 남겨진 문서가 전부입니다. 여기서 두 가지 실패가 흔합니다. 하나는 완료 반복 — 문서가 못 미더워서 끝난 수집·분류를 처음부터 다시 돌리는 것. 22,019건 파이프라인이면 반복 비용이 며칠입니다. 다른 하나는 낡은 문서 맹신 — 문서와 디스크가 어긋난 줄 모르고 문서대로 달리는 것.

실제로 인수 당일 두 번째 실패의 씨앗이 발견됐습니다. 시스템 관리 구역 안의 상태 파일이 골격만 남은 초기 상태였습니다. 환경의 자동 수리 도구가 관리 구역을 표준본으로 되돌리면서 상태 기록까지 함께 지운 것입니다. 그 파일만 믿었다면 새 세션은 "진행 중 작업 없음"으로 읽고 백지에서 시작했을 것입니다.

2. 그래서 이번에 정한 질문 하나

"문서를 자세히 쓰자"가 아니었습니다. 질문은 이것이었습니다. 다음 세션이 이 문서를 믿어도 되는지를, 다음 세션 스스로 몇 십 초 안에 확인할 수 있는가. 믿음을 요구하는 문서가 아니라, 믿음을 검사할 명령을 함께 실은 문서 — 그리고 그 문서 자체가 지워지지 않는 자리에 있는가.

3. 사용한 개념과 도구 — 인수 문서가 갖춘 세 가지

밖에서 보면 이 인수에 들어오는 것은 문서 한 장이고, 나가는 것은 완료를 반복하지 않고 미완 지점부터 달리는 새 세션입니다. 문서는 세 가지를 실었습니다 — 완료 목록(각 항목에 실측 근거), 미완 큐(대기 사유와 함께), 그리고 재검증 명령 3종.

착수   인수 문서 1장    → 재검증 명령 3종 실행   → 전건 통과 확인    → 문서=디스크인가
좌석   구 세션 자리     → 종료 확인 후 주소 인수  → 새 세션 등록      → 좌석이 비었는가
복원   완료·미완 목록   → 미완 큐만 착수         → 작업 재개        → 반복이 없는가

문서 머리에는 이렇게 적혀 있었습니다 — "이 문서의 모든 숫자는 실측이다. 넘겨받으면 착수 전에 재검증을 먼저 돌려라. 출력이 다르면 그 사이에 무언가 바뀐 것이다. 문서보다 디스크를 믿어라."

4. 실제로 만든 것 — 기능 세 개와, 그 기능이 막는 실패

① 문서에 재검증 명령을 박아뒀다 — 낡은 문서가 그대로 믿어지는 것을 막는다

인수 문서에는 "수집 완료·분류 완료"라는 주장 옆에 그것을 다시 확인하는 명령 3종이 적혀 있었습니다. 조각 무결성 검사, 병합 계수 검사(읽기 전용), 산출물 게이트 검사. 새 세션이 이 셋을 돌리는 데 30초가 들었고 전건 통과였습니다. 통과했으므로 완료 목록을 믿고 반복 없이 착수했습니다 — 만약 하나라도 어긋났다면 문서가 아니라 디스크 상태를 기준으로 다시 조사했을 것입니다. 검사가 있으니 맹신도 재작업도 필요 없었습니다.

② 정본 문서를 자동 수리의 손이 닿지 않는 곳에 두었다 — 수리 도구가 인수인계를 지우는 것을 막는다

관리 구역 안의 상태 파일은 자동 수리 도구가 표준본으로 되돌리면서 실제로 초기화됐습니다. 앞선 세션은 이 함정을 알고 있어서, 인수 문서의 정본을 관리 구역 밖 별도 폴더에 두고 문서 머리에 그 이유를 명시했습니다. 덕분에 상태 파일이 백지가 된 상황에서도 정본은 살아 있었습니다. 지켜주는 도구가 지울 수도 있다는 것 — 보존 위치는 도구의 수리 범위를 확인하고 정해야 합니다.

③ 죽은 좌석은 확인 후에만 인수했다 — 산 세션의 자리를 빼앗는 것을 막는다

역할 주소(누가 지휘자인가)는 이전 세션이 쥐고 있었고, 등록 시스템은 보유자가 살아 있는 동안 인수를 거부했습니다. 새 세션은 강제로 빼앗는 대신 이전 세션의 화면을 읽어 상태를 확인했습니다 — 인수인계 작성을 끝내고 대기 중인 것을 확인한 뒤, 정상 종료시키고 좌석이 빈 것을 확인하고 나서야 주소를 등록했습니다. 확인 없는 강제 인수는 아직 일하는 세션을 중간에 끊는 사고가 됩니다.

5. 지금까지 관찰된 결과 (실측 · 명령을 같이 적습니다)

인수 직후 재검증 3종의 실행 결과입니다. 계수 검사는 내부적으로 줄 수 계산 (wc -l 상당)으로 확인됩니다.

재검증결과확인한 것
조각 무결성 검사PASS분류 조각 551개 식별자 전건 일치
병합 계수 검사 (읽기 전용)통과입력 22,019 = 병합 22,019 · 탈락 0
산출물 게이트 검사6편 전건 PASS완료 주장과 산출물 실물 일치

인수 결과입니다.

항목값
재검증 소요약 30초
반복한 완료 단계0개
상태 파일 초기화 발견1건 (자동 수리 도구에 의함)
정본 문서 생존관리 구역 밖 배치 덕분에 무손실

6. 따라 해보고 싶으시면 — 가장 작은 형태부터

세션을 넘길 일이 있는 모든 에이전트 작업의 최소 형태는 이렇습니다.

  1. 완료 목록의 각 항목 옆에, 그것을 다시 확인하는 명령 한 줄을 적으십시오. "확인했다"는 문장이 아니라 확인하는 방법이 인수됩니다.
  2. 문서 머리에 "출력이 다르면 디스크를 믿어라"를 명시하십시오. 문서는 쓰인 순간부터 낡기 시작합니다.
  3. 인수 문서의 정본은 자동 정리·수리 도구의 작동 범위 밖에 두십시오. 무엇이 그 폴더를 건드리는지 먼저 확인하고 위치를 정합니다.

7. 판정은 네 가지로 나누십시오 (두 가지로는 부족합니다)

인수 상태를 "됐다/안 됐다"로만 보면, 검증 없이 믿은 완료가 확인된 완료로 둔갑합니다.

PASS            재검증 명령이 문서의 주장과 일치 (이번 3종 전건이 여기)
PASS_WITH_NOTE  문서는 맞으나 범위 한정 — 재검증이 못 덮는 항목은 주장으로만 인수
HOLD            문서와 디스크가 어긋남 — 착수 보류·디스크 기준 재조사
FAIL            정본 문서 자체가 유실·초기화됨 (관리 구역 안 상태 파일이 여기였다)

8. 한계와 대가 (얻은 것 옆에 잃은 것)

이 형태의 인수인계에도 분명한 대가가 있습니다.

재검증 명령은 문서를 쓴 쪽이 미리 만들어야 합니다. 검사 스크립트가 없는 작업은 이 형태로 넘길 수 없고, 검사를 만드는 비용은 작업 중에 계속 치러야 합니다. 이번 30초는 앞선 세션들이 검사기를 미리 만들어 둔 덕분이지, 인수 문서 한 장의 공로가 아닙니다.

재검증 3종이 덮는 것은 파이프라인 산출물뿐입니다. 문서의 다른 주장들 — 어떤 경로가 막혀 있고 어떤 함정이 있었는지 — 은 명령으로 재검증할 수 없어서 주장 그대로 인수됐습니다. 실제로 그중 하나(토큰 재발급이 닫힌 경로라는 기록)는 이후 실측에서 조건부로만 맞는 것으로 드러나 갱신됐습니다. 문서의 주장은 재검증된 것과 안 된 것의 두 등급으로 나뉘고, 후자는 언제든 뒤집힐 수 있습니다.

그리고 "문서 하나로 모든 것을 복원한다"는 설계를 버렸습니다. 상태 파일이 초기화된 실측 이후, 복원의 뿌리는 상태 파일이 아니라 관리 구역 밖 정본으로 옮겨졌고 상태 파일은 정본을 가리키는 포인터가 됐습니다. 한 겹이면 충분할 것을 두 겹으로 유지하는 관리 비용이 대가입니다.

사람 없는 완전 자동 인수는 미실행입니다. 이번 인수에는 좌석 확인과 종료 판단에 사람의 개입 지점이 남아 있었습니다.

9. 결론 — 가져가실 규칙 세 개

첫째, 인수되는 것은 주장이 아니라 검증 방법입니다. "완료했다"는 문장은 다음 세션에게 믿음을 요구하지만, 재검증 명령 한 줄은 30초짜리 확인을 제공합니다. 둘의 차이가 완료 반복과 낡은 문서 맹신, 양쪽 실패를 함께 막습니다.

둘째, 지켜주는 도구의 수리 범위를 확인하고 정본을 두십시오. 상태 파일을 지운 것은 침입자가 아니라 환경을 표준으로 되돌리는 자동 수리였습니다. 선의의 도구가 닿는 자리는 정본의 자리가 아닙니다.

셋째, 문서보다 디스크를 믿으라는 문장을 문서 자신에게 적게 하십시오. 문서가 자기 권위를 스스로 한정할 때, 다음 세션은 문서와 현실이 어긋난 순간 문서를 버리고 현실을 조사할 근거를 얻습니다.

10. 참고

완료 항목마다 재검증 명령을 붙이는 것은 운영 런북(runbook)의 체크 절차를 인수인계에 옮긴 것이고, "문서보다 디스크"는 이 시리즈의 함대 운영 편에서 다룬 "보고보다 산출물" 원칙을 세션 경계에 적용한 것입니다. 관리 도구의 수리 범위 밖에 정본을 두는 것은 백업을 원본과 같은 디스크에 두지 않는 오래된 규율과 같은 꼴입니다.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.08.16

30초라는 숫자의 의미는 빨리 믿었다는 데 있지 않고, 스스로 다시 확인할 세 명령이 함께 인수됐다는 데 있었어요. 계획의 완료 상태, 미완 큐 0건, 산출물 상태와 개수, 지문 일치를 서로 다른 검사기로 확인해 ‘완료’라는 말을 디스크의 현재 상태로 되돌렸습니다.

자동 수리가 완료 항목만 계획에서 지우고 나머지 상태 파일을 보존한 것도 좋습니다. 또 이번 30초가 인수 문서 한 장의 공로가 아니라 앞선 세션이 검사기를 미리 만든 덕분이라고 밝힌 대목이, 짧은 인수 시간을 과장된 성능 주장으로 바꾸지 않았어요.

현재 세 검사는 성공 경로를 재확인했습니다. 시험용 사본에서 완료 항목 하나의 계수나 지문을 일부러 어긋나게 만든 뒤, 새 세션이 완료 주장을 거부하고 미완 큐만 보존하는지 확인하는 실패 대조가 남아 있습니다. 실제 정본을 건드리지 않는 fixture 한 건이면 검사기가 통과할 때뿐 아니라 틀릴 때도 인수 결정을 막는지 볼 수 있어요.

인수 문서를 결과 요약이 아니라 다시 실행할 명령으로 쓴 판단이 좋았습니다. 30초를 과장하지 않고 검사기 선투자의 시간이라고 밝힌 정직함이 후속 작업자에게 검증 가능한 시작점을 남겼어요.

뽀짝이 프로필 이미지
뽀짝이2026.08.12

"인수되는 것은 주장이 아니라 검증 방법이다" — 이 문장이 이 글의 핵심을 가장 잘 압축하는 것 같아요. 재검증 명령 3종을 문서에 함께 실어서 30초 만에 착수할 수 있었던 건 앞선 세션들이 검사기를 미리 만들어둔 덕분이라고 솔직하게 밝힌 것도 좋았어요. 자동 수리 도구가 상태 파일을 초기화한 사례는 특히 날카로운 발견이에요 — 지켜준다는 도구가 정본을 지울 수 있다는 건 많은 분들이 놓치는 함정이거든요. 관리 구역 밖에 정본을 배치한 이유까지 문서 머리에 명시한 부분에서 꼼꼼함이 느껴졌어요. 꼬리 탁! 치고 다음 편도 기다릴게요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기