Mk 하네스훅은 이론이 아니라 사고에서 나왔습니다
구분
설계 근거
하네스 · 훅 기반 가드레일
상태
운영 중 · CI
2026
역할
설계 · 판정 · 운영
코드는 AI
분야
하네스 + 검증
훅 · eval · 계측
MK-01하네스
211
검증 항목 · 7단계
초기
현재
개요
Mk 하네스
규칙을 먼저 정해 두고 도구를 만들지 않았습니다. 실제로 겪은 사고를 기록한 뒤 그것이 반복되지 않도록 훅을 붙이는 순서로 자랐습니다. 겪은 일 만들어진 규칙 워크트리 병합에서 파일이 누락됨 워크트리 생성·정리 절차 자동화 커밋은 했는데 기록이 없어 맥락이 사라짐 기록 없는 종료 차단. 커밋을 기록으로 쳐주지 않음 같은 접근으로 계속 실패 동일 실패 3회에서 진행 중단 3주 된 요약 문서를 근거로 삼아 삭제된 기능을 현존으로 오보 현재 상태 질문은 코드를 1차 출처로
01
검증
도구 자체를 211개 항목 7단계로 검증합니다. 정적 검사 35 · 훅 기능 87 · 스키마 정합성 29 · 설치 20 · 교차 참조 16 · 운영 행동 15 · 런타임 통합 9. CI에 걸어 두었고 초기 108항목에서 지금까지 95% 늘었습니다.
02
효과 검증
훅은 늘릴수록 경고가 쌓이는데 그 경고가 실제로 행동을 바꾸는지는 한동안 확인하지 않고 있었습니다. 45일치 세션 기록에서 훅별 발동 시점과 직후 행동을 전수 대조했습니다.
한 훅은 경고 859회에 행동 변화 0. 한 세션에서만 148회 발동한 적도 있습니다
게다가 경고문이 알려주는 승인 마커를 AI가 스스로 만들 수 있었습니다. 게이트 자체가 성립하지 않는 구조였고 차단 모드로 올려도 같은 이유로 무의미했습니다
다른 훅 하나는 10회 전량 효과 없음·오탐이었습니다
실측을 근거로 두 종을 제거했고 제거 사유를 문서에 남겼습니다. 같은 가정("경고하면 따를 것")으로 훅을 다시 넣지 않기 위해서입니다. 2026-09-16 에는 집행 훅 8종에 계측을 붙였습니다(종료 코드까지 함께 기록).
03
한계
그래서 "이 도구로 생산성이 얼마나 올랐다"는 말은 하지 않습니다. 막은 것은 셀 수 있지만 막지 않았다면 무슨 일이 났을지는 셀 수 없습니다. 측정 항목을 설계 단계에 넣지 않으면 나중에 소급할 수 없다는 것을 이 도구에서 배웠습니다.
기록
잰 숫자와 출처
측정 · CI
211검증 항목 · 7단계
측정 · 45일 세션 기록
859 : 0경고 횟수 대 행동 변화 · 제거한 훅
측정 · 제거 기록
2종실측으로 제거한 훅
측정 · 훅 로그
8종계측을 붙인 집행 훅 · 2026-09-16
결과
211 검증 항목 · 7단계 · 859 : 0 경고 횟수 대 행동 변화 · 제거한 훅 · 2종 실측으로 제거한 훅 · 8종 계측을 붙인 집행 훅 · 2026-09-16
