안전 게이트 운영법

[!CAUTION] 이 스킬은 운영법만 담는다. 게이트 항목·확인자·배포 기록이라는 데이터는 저장소의 docs/SAFETY_GATE.md 에 있고, 그것이 그 프로젝트의 유일한 안전망이다.

이 스킬도, 어떤 훅도, 안전 판단을 대신하지 않는다. 훅은 에이전트가 실행하는 경로만 막을 수 있다 - 사람이 HMI·IDE·장비 콘솔에서 직접 하는 동작은 아무것도 막지 못한다.

사내 검증이 코드(가상모드)까지만 가능하고 그다음이 바로 실장비인 프로젝트에서, 정위치 오판·인터락 누락·잘못된 장비 제어는 곧 충돌·사고다. 아래 규칙에 예외를 두지 않는다.

1. 실장비 게이트

docs/SAFETY_GATE.md 의 OPEN 항목이 남아 있는 동안 실장비에서 모션 명령(원점복귀·이동· 자동 테스트)을 실행하거나 실행을 안내하지 않는다.

[!CAUTION] 게이트 항목은 사람 확인자만 닫을 수 있다. 에이전트는 확인자 칸을 채우지 않는다. 실장비 검증을 대신할 수 없기 때문이다. 이 규칙에는 어떤 예외도 없다.

2. 검증 수준 3단계

코드대조  <  가상모드  <  실장비

현황판 상태 요약의 COMPLETED 배지는 "코드 완성"만 의미한다. 가상모드 통과를 실장비 검증으로 기록하지 않는다 - 검증 수준 열을 따로 채운다.

3. 게이트 항목 표

상태

등급 - 위험의 크기가 아니라 순서다. 축은 "무엇을 하기 전에 닫아야 하는가".

항목을 닫을 때: 상태 배지를 CLOSED 로 바꾸고 확인자·날짜를 채운다. 새 위험이 발견되면 행을 추가하고 현황판 활성 위험 표에서 항목 번호로 인용한다 - 내용을 두 곳에 재서술하지 않는다.

4. 코드 마커 규칙

grep 한 번으로 전수 탐색되는 게 목적이라 표기를 변형하지 않는다(대소문자·하이픈 고정).

안전 판정 스텁은 fail-safe 방향이 기본이다. 정위치·인터락·리밋 판정의 임시 구현은 차단(false) 쪽으로 둔다.

알람·인터락·비상정지 경로를 주석 처리하거나 조건 우회로 무력화한 채 커밋하지 않는다. 부득이하면 마커 부착 + 현황판 활성 위험 표 등재가 조건이다.

5. 배포 기록

실장비에 배포할 때마다 SAFETY_GATE.md 의 배포 기록 표에 한 행을 추가한다 - "그때 실장비에 돌던 코드가 뭐였는지" 를 되짚을 유일한 수단이다.

6. 병행 작업 중의 예외

병행 기간에도 이 문서만은 개인 폴더가 아닌 메인에 즉시 반영한다. 수정 즉시 커밋하고 상대방에게 공유한다 - 안전 정보는 병합을 기다리지 않는다.

같은 이유로 안전 파일 변경이 섞인 병합은 자동 병합 대상에서 제외된다. 사람이 diff 를 리뷰한다.

7. 아카이브 이관 시

서사를 아카이브로 옮길 때 그 안의 미해결 확인 항목은 전부 현황판 또는 이 게이트로 승격한 뒤 동결한다. 동결 문서에만 남은 확인 항목은 영영 갱신되지 않는다 - 실제 누락 사례가 이 게이트 도입의 근거다.