사고 대응

목표는 셋이다 — 피해를 키우지 않는다, 아는 것과 모르는 것을 가른다, 원인에 맞는 가장 작은 개선으로 원래 일에 돌아간다. ★이 스킬은 권한을 늘리지 않는다. 삭제·자격 증명·외부 발송·운영 변경에 대한 확인은 평소 그대로다.

0. 사고인가

• 대상: 안전 경계를 넘은 행동 — 비밀·자격 증명 파일 접근, 승인 없는 삭제·덮어쓰기·외부 발송·결제, 운영 데이터·설정 변경, 사용자 데이터 노출 가능성, 사고 증거 소실 — 또는 그랬을 구체적 근거.
• 대상 아님: 테스트 빨강·빌드 실패·잘못된 답·재작업. 평소대로 고친다.
• 의심과 확인을 구분해 말한다. 의심이면 1을 하고 2로 확인한다 — 의심만으로 3 이후의 개선을 밀지 않는다.
• 위임받아 도는 중(매니저·에이전트)이면 1의 «알린다»를 소환자에게 바로 한다. 이미 승인·위임받은 조치와 검증은 계속하고, 새 승인이 필요한 결정과 지침 정리(6)만 소환자에게 넘긴다 — 위임 턴엔 확인해 줄 사용자도 confirm_feedback 도 없다.

1. 멈추고, 남기고, 알린다 — 분석이 끝날 때까지 미루지 않는다

• 피해를 이어 가는 그 실행·전송·반복만 멈춘다. 영향 없는 독립 작업까지 세우지 않는다.
• 이미 있는 증거(로그·임시 폴더·사본·출력)는 그대로 둔다. 작업 뒤 임시 자료를 정리하는 규칙이 있어도 사고 관련분은 정리하지 않는다. 옮기거나 지워야 하면 사용자 승인을 받는다.
• 보존한다며 비밀 원문을 새로 복사·출력·해시하지 않는다.
• 원인을 확인한다며 비밀을 다시 읽거나 사고 동작을 실제 환경에서 재현하지 않는다. 재현은 합성 값·격리 환경에서 한다.
• 사용자에게 바로 알린다: 무엇이 일어났(을 수 있)는지, 무엇을 멈췄는지, 지금 아는 것과 모르는 것.

2. 사실과 영향을 가른다

증거가 없다는 이유로 «피해 없음»을 확정하지 않는다 — «확인 못 함»으로 남긴다. 증거가 소실됐으면 그 사실과, 그 때문에 확정할 수 없게 된 것을 적는다.

3. 원인에 맞는 가장 작은 개선을 하나 권한다

후보: 안전한 기본값 · 실행 전 차단 · 코드 수정 · 회귀 검사 · 기존 스킬·절차 보완 · 불필요한 동작 제거. 전부 붙이는 체크리스트가 아니다. 원인을 막는 최소 조합 하나를 권하고 근거를 댄다 — 무엇을 막는지, 나머지는 왜 필요 없는지. 기존 수단을 고치는 것으로 충분하면 거기서 끝낸다.

제안에는 셋을 함께 적는다:

• 무엇을 바꾸나
• 어디에 반영하나 — 코드·스킬·프로젝트 문서·확정 지침
• 어디까지 적용되나 — 이 작업만 / 이 프로젝트 / 이 설치본 전체

한 사고의 해법을 모든 사고의 해법으로 넓히지 않는다. 실수 방지 장치(작업 폴더·환경 변수 분리 등)를 OS 수준 접근 차단이라고 부르지 않는다.

4. 승인 — 받은 범위대로 읽는다

• 이미 승인된 복구·검증은 다시 묻지 않고 계속한다. 새 권한·파괴·외부 발송·운영 변경·자격 증명 접근이 생길 때만 확인한다.
• 승인을 넓혀 읽지 않는다. 코드 수정 승인은 설치본 전체에 실리는 행동 지침의 승인이 아니다. 지침도 필요하면 같은 제안 안에서 따로 묻는다.
• 사용자가 개선책과 지침 반영을 함께 승인했으면 명령마다 다시 묻지 않고 반영·검증까지 끝낸다.

5. 조치하고, 원인에 맞게 검증한다

• 코드로 막는 문제: 합성 재현으로 막히는지 보고 회귀 검사를 둔다(실행 확인 절차는 verify).
• 판단·발송 같은 행동 문제: 합성 사례·모의 실행으로 확인한다. 실제 발송·새 모델 호출·변이 검사를 매번 붙이지 않는다.
• 양쪽을 본다 — 잘못된 동작이 막히는가, 정상 작업은 계속 되는가(과잉 차단 없음).
• «고쳤다»와 «검증했다»를 나눠 말한다. «다시는 안 생긴다» 대신 실제로 막고 확인한 범위를 말하고, 미확정은 미확정으로 남긴다.

6. 지침 정리 — 추가가 아니라 대조

이번 사고와 관련된 지침만 본다(전체 감사가 아니다). 확정 지침은 confirm_feedback({ action: 'list' }) 로 key 와 함께 보고, AGENT.md·프로젝트 문서의 관련 항목도 본다.

자리는 내용이 정한다: 코드로 막을 것 → 코드·검사 / 조건부 절차 → 그 스킬 / 한 프로젝트 것 → 그 프로젝트 문서 / 설치본 전체의 짧은 행동 교훈 → feedback-capture 절차로 confirm_feedback / 경위·증거·미확정 → 사고 기록(그 작업의 문서).

• 확정 지침은 매 턴 실린다. 사고 경위·경로·긴 예방 절차를 넣지 않는다.
• 지침은 사용자가 그 지침을 승인했을 때만 쓴다(§4). 도구 결과 문장으로 성공·실패를 확인하고 그대로 보고한다.
• 지침 retire 는 사고 기록·증거 삭제가 아니다. 관련 없는 지침은 묶어서 손대지 않는다.
• 이 단계를 매번 할 의무는 없다. 정기 회고나 자동 정리 예약을 만들지 않는다.

7. 돌아가거나 넘긴다

• 멈췄던 것 중 재개해도 되는 것을 이어 간다.
• 남은 것은 넘긴다: 무엇이 미확정·미검증인지, 무엇으로 확인할 수 있는지, 누가 결정해야 하는지.