■ handoff 패키지

넘기는 것 = 운영 능력 : 아래를 넘긴다 업계 일반 목록은 공식 문서 없음 [6.4]

• 증상별 런북
• 런북에 묶인 알림
• 지정된 담당자
• 결정 근거
• eval 셋
• 버전 목록
• 되돌리기 절차
• on-call

코드 + 자격증명 · 데모 영상 + 슬라이드 · 빌드 채팅 로그 · 담당자 없는 런북 초안만으로는 미완이다 업계 일반

팀이 여럿이면 서비스 전체를 책임지는 담당자 한 명, 같이 보는 지표, 심각도·에스컬레이션 규칙을 둔다. 부품별 소유권만으로는 장애가 길어진다 업계 일반

eval 셋 : 살아 있는 산출물이다. 명확한 소유권이 있어야 쓸모가 있다. 전담 팀이 인프라를 맡고, 도메인 전문가·제품팀이 과제를 기여하고 직접 돌린다

누가 맡나는 ■ lifecycle 루프 · 규칙 ④ 에 있다

버전 목록 : 에이전트 시스템은 프롬프트·도구·실행 로직이 얽힌 stateful 시스템이다

그래서 모델만이 아니라 프롬프트 버전 · 도구 정의 · 데이터·정책 버전도 적는다 (넓힌 것은 해석이다)

모델은 ID 로 적는다. 모델 ID 는 고정 버전이라 같은 ID 면 가중치·구성이 안 바뀐다. 이 보장은 ID 에만 있고, 4.6 이전 일부 모델의 alias 에는 없다

ID 마다 지원 중단·종료 일정이 있다. 자세한 것은 ■ lifecycle 루프 · 규칙 ⑤ 에 있다

되돌리기 : 정상이 확인된 버전(프롬프트·모델 ID)으로 돌아가는 절차와 누가 실행하는지 적는다 업계 일반. 구버전·신버전을 함께 돌리며 트래픽을 조금씩 옮기는 배포는 ■ 에이전트 상태·실패·배포 에 있다

런북은 증상별 : 컴포넌트별 장이 아니라 보이는 증상마다 한 줄을 쓴다. 한 줄에는 증상, 확인할 것, 조치, 안 풀리면 부를 사람을 적는다 업계 일반 공식 문서에 런북 없음 [6.4]

새벽 on-call 은 어느 부품이 문제인지 모른 채 증상에서 시작한다. 그래서 부품마다 붙인 트러블슈팅 장으로는 복구 시간을 못 맞춘다 업계 일반

알림마다 런북 링크와 지정된 담당자를 붙인다 업계 일반. 알림 한 행의 구조(신호, 트리거, 담당자, 행동)는 ■ feedback loop 책임 표 에 있다. 무엇부터 볼지는 ■ observability 세 신호 에 있다

짓는 팀용 런북 한 줄(알아보는 법 · 확인할 것 · 복구 방법)은 ■ 구현 가이드 · 규칙 ⑤ 에 있다. 여기는 그것을 증상 기준으로 운영 팀에 넘기는 모양이다

완료 판정은 받는 팀이 : 문서 발송 · 아키텍트 사인오프 · "나중에 읽어 볼게요" 는 완료가 아니다. 아래 셋을 마치면 완료다 업계 일반 [6.4] [6.5①]

• 워크스루
• 런북 따라 하기
• 일부러 심은 장애를 on-call 이 혼자 복구하기

합격 기준은 아키텍트 없이 복구하는 것이다 업계 일반 ■ 구현 가이드 의 "아키텍트 없이 빌드·복구" 와 같은 기준

공식 근거 : 같은 명세를 읽은 엔지니어 둘이 엣지 케이스를 다르게 읽는다. 문서만으로는 기대가 안 전해진다 (명세 문맥이다. handoff 로 넓힌 것은 해석이다)

도메인 전문가·제품팀이 eval 을 직접 돌린다

그래서 받는 팀이 eval 을 스스로 돌릴 수 있어야 넘긴 것이다

넘긴 뒤 같은 장애로 아키텍트가 또 호출되면 지식 이전 실패다. 그 경로를 런북에 넣고 다음에는 팀이 직접 한다. 아키텍트가 더 빨리 고치는 스크립트를 짜 주면 의존이 굳는다 업계 일반

반대 쪽 : 받는 팀이 혼자 복구한다고 아키텍트가 모니터링·반복에서 빠지는 것은 아니다. 자세한 것은 ■ lifecycle 루프 · 규칙 ② 에 있다

기록과 실제가 어긋났으면 목록부터 : 기록 없는 프롬프트 수정이 쌓였으면 실제 돌고 있는 것(모델 ID · 프롬프트 버전 · 도구)을 먼저 목록·버전화한다. 런북·브리핑·되돌릴 버전 결정은 그 뒤에 한다 업계 일반 [6.4]

공식 근거 : 모델 사용 감사로 아직 옛 모델을 쓰는 곳을 찾는다. Console Usage 에서 Export 하면 API 키·모델별 CSV 가 나온다 (모델 폐기 문맥이다. 인벤토리로 넓힌 것은 해석이다)

문서도 낡는다. CLAUDE.md 는 주기적으로 검토해 낡거나 충돌하는 지시를 뺀다 (Claude 가 읽는 문서 기준)

그래서 런북에도 갱신 담당자와 갱신 계기(배포 · 장애 뒤)를 적는다 (넓힌 것은 해석이다)

독자 셋 : 독자마다 필요한 것이 다르다. 한 독자용으로만 두꺼운 문서는 미완이다 업계 일반 [6.4]

• 물려받는 엔지니어 : 증상별 런북 · 흐름 그림
• 감사관 : 의무마다 통제 · 담당자 · 지금 보여 줄 수 있는 증거
• 나중에 돌아온 설계자 : ADR

보여 줄 수 없는 통제는 없는 통제다 업계 일반

증거 장치 예 : 최종 사용자 신원을 붙이면 Claude Code 의 도구 결정·결과 이벤트가 사용자별 감사 기록이 된다. 이 기록은 SIEM 으로 간다 (감사 증거로 넓힌 것은 해석이다)

자세한 것은 ■ 텔레메트리 기록 범위 에 있다

말로 브리핑할 때 청중별 깊이는 ■ 청중별 브리핑 에 있다