38장. 도구 장애 Runbook을 만든다

증상별로 PATH 불일치, task exit code, debugger attach, index corruption 의심, plugin crash, agent permission, remote connection을 분류한다. 첫 확인 명령, 기대 출력, 안전한 완화, 보존할 log, escalation과 되돌리기를 적는다. private repository path와 token을 support bundle에 넣지 않는다.

“IDE 재설치”는 마지막 단계다. CLI build가 통과하면 제품 작업을 계속할 fallback이 있다. 반대로 CLI도 실패하면 IDE 문제로 단정하지 않는다. 동료가 runbook만으로 같은 fixture를 복구해야 한다.