문서에만 적는 규칙으로는 지킬 수 없다: 5가지 위치 중 효과를 본 것은 1곳, 공개 직전 체크에서 2개의 결함을 발견하다
요약
AI 모델(Claude Code)에게 지켜야 할 규칙을 5가지 위치(입구 문서, 절차서, 훅, 기억, 정본)에 적용해 본 결과를 분석한 글입니다. 단순히 문서를 작성하는 것보다 '실행을 멈추게 하는 스크립트' 형태로 규율을 구현했을 때 더 효과적으로 결함을 발견할 수 있음을 보여줍니다.
핵심 포인트
- 규칙은 문서가 아닌 실행 가능한 스크립트로 만드는 것이 중요합니다.
- 판단 기여를 기록으로 확인할 수 있는 곳은 '기억(memory)' 한 줄뿐이었습니다.
- 공개 직전 체크(gate)는 멈추게 하는 단어와 세는 단어를 구분하여 활용할 수 있습니다.
AI (Claude Code)에게 지키게 하고 싶은 규율을 같은 내용으로 5가지 위치에 작성했습니다. 입구 문서・절차서・훅(hook)・기억(memory)・정본(master copy). 판단 기여를 기록으로 확인할 수 있었던 것은 1곳(기억)뿐이었습니다. 반대로, 규율을 '읽는 문서'가 아니라 '실행을 멈출 수 있는 스크립트'에 두었더니, 그날 바로 2개의 결함을 발견했습니다.
n=1의 운영 기록입니다. '문서를 작성하지 말라'거나 '모든 것을 기계로 하라'는 것이 아니라, 위치를 나누어 판단하는 표로 정리합니다.
이 글의 위치(2026-09-26 추가)
- 이 글에서 새로 제시할 것: 같은 규율을 5가지 위치에 작성하고, 판단 기여를 기록으로 확인할 수 있었던 것은 기억의 1줄뿐이었다는 점. 위치 판별표.
- 적용 범위: n=1 운영 (Claude Code)이며, 다른 환경에서는 확인하지 못했습니다.
- 용어: 본문의 '문(門)' = 공개나 commit 전에 조건을 충족하지 않으면 진행할 수 없도록 자동적으로 멈추게 하는 체크를 의미합니다.
숫자의 원본 데이터와 재현 절차는 검증 기록(Lab)에 정리되어 있습니다.
규율은 '작업 전에 정본을 인용하라'. 배치한 위치와 실제로 일어난 일.
| 위치 | 작성된 내용 | 발생한 일 | :--- |
| 입구 문서 (매번 로드됨) | '정본을 인용한 후에 시작할 것' | 읽히기는 했으나, 인용 스크립트의 이름만 지적했을 뿐 본문은 제시하지 않음 |
| ... | 효과가 있는 것처럼 보임 = '인용했습니다'라고 보고됨 | :--- |
| 기억 (매 턴 참조되는 요약) | 같은 규율의 1줄 | 판단을 바꾼 기록이 있는 것은 이것뿐 |
| 정본 | 규율의 본문 | 한 번도 열리지 않음 |
import re
def gate(slug: str, body: str) -> None:
"""공개 직전 처리에 호출됩니다. 멈추는 단어는 멈추고, 세는 단어는 줄을 인쇄합니다. 코드 내부(````…```` 및 `` `…` ``)는 보지 않습니다."""
prose = re.sub(r"```.*?```", "", body, flags=re.S)
prose = re.sub(r"`[^`\n]*`", "", prose)
for bad in (r"裁定待ち", r"TO-MEASURE", r"\bTBD\b"):
assert not re.search(bad, prose), f"{slug}: 본문에 「아직」의 표시 {bad}=닫고 쌓기
"
...
일부러 망가뜨린 입력 5건(裁定待ち
→ 멈춤/TBD
→ 멈춤/TBDX
→ 통과/코드 스팬 내부의 TBD
→ 통과/未裁定
→ 인쇄)로 확인한 후 사용하고 있습니다.
인쇄는 '보면 알 수 있다'라는 약속으로 하지 않습니다. 인쇄가 문=나오면 읽는다,가 스크립트 측의 전제입니다. ⚠ 이 문을 작성할 때, \b
이 backspace 문자가 되어 정규 표현식이 죽고 있었습니다(별 기사). 이 체크는 코드 내부(…
와 …
)를 보지 않는 처리를 하고 있습니다. 문을 만든 순간에, 일부러 망가뜨린 입력으로 문을 시험하는 것까지가 1세트입니다.
- '문서를 쓰지 말라'고는 하지 않습니다. 판단이 필요한 규율은 문서에만 둘 수 있
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기