Imported from cih0802/snowflake_files (.snowflake/cortex/skills/init_ihcho/SKILL.md). Install upstream with npx skills add cih0802/snowflake_files --skill init_ihcho. Copyright stays with the author.

init_ihcho — 세션 초기화

이 워크스페이스에서 세션 최초로 작업을 시작할 때 반드시 실행한다. 목적: 작업 지침 로드 → 미해결 이슈 파악 → 셸 안전 규칙·문서 읽기/쓰기 가드 활성화.

Step 0: 셸 안전 규칙 선적용 (즉시)

이 스킬 이후 모든 bash 호출에 아래를 적용한다. 상세는 지침 문서 R0 참조.

• 복합구문(for/if/case/heredoc/따옴표)은 한 명령 문자열 안에서 완결한다. 미완결 구문은 무한 대기를 유발한다.
• 셸 루프 대신 ls -d a b c, find -L /workspace/ ..., grep -rn pat a b c 같은 루프 없는 단일 명령을 쓴다.
• 모든 명령에 timeout 60 + </dev/null 을 붙인다. 장기 작업은 background 실행 후 폴링.
• 타임아웃 시 같은 명령을 재시도하지 않고 구문 점검 → 최소 명령 확인 → 경로 분해 순으로 복구한다.
• dbt 명령에는 셸 연산자를 쓸 수 없다. --project-dir 로 경로를 전달한다.

Step 0.5: 문서 전량 읽기 규칙 (모든 파일 읽기에 적용)

.md, .sql, .yml, .py, .csv 등 파일 종류와 무관하게 이 세션에서 읽는 모든 파일에 적용한다. 상세는 지침 문서 R1-3 참조.

• 전량 확보 필수: 파일은 처음부터 끝까지 읽는다. 일부만 읽은 상태에서 나머지 내용을 추론·단정하지 않는다.
• 분할 읽기로 이어 읽기: read 툴은 1회 호출당 최대 2000줄, 1줄당 2000자까지만 반환한다. 이 한도로 잘리면 offset/limit 를 옮겨 끝까지 반복 호출한다. 시간 제약(timeout 60)과는 무관한 문제이므로 시간을 이유로 중단하지 않는다.
• 줄 수 선확인: 대용량 파일은 timeout 60 wc -l <경로> 로 총 줄 수를 먼저 확인하고, 필요한 호출 횟수를 계산해 전량 읽었는지 자가 검증한다.
• bash 로 문서 읽기 금지: cat/head/tail 은 출력 절단으로 내용이 손실된다. 문서 내용 파악은 반드시 read 툴을 쓴다. bash 는 줄 수·크기 확인 용도로만 쓴다.
• 부분 읽기 명시: 사용자가 특정 구간만 요청한 경우에만 부분 읽기를 허용하고, 그 사실을 응답에 명시한다.

Step 0.6: 문서 작성 규칙 — 한 줄 2000자 가드 (모든 파일 쓰기에 적용)

.md, .sql, .yml, .py, .csv 등 파일 종류와 무관하게 이 세션에서 생성·수정하는 모든 파일에 적용한다. 상세는 지침 문서 R1-5 참조. 이유: read 툴은 1줄당 2000자에서 절단한다(Step 0.5). 2000자를 넘는 줄을 쓰면 다음 세션에서 그 줄을 전량 읽을 수 없어 전량 독해 규칙이 깨진다.

• 한 줄 2000자 초과 금지. 목표는 1줄 1000자 이내(안전 마진), 절대 상한 2000자.
• 긴 문장은 의미 단위로 개행한다. 문단·항목·절 단위로 줄을 나누고, 표는 행마다 개행한다.
• 한글은 1자 = 1문자로 계산하되, 바이트 기준 여유를 두고 판단한다.
• 긴 SQL·코드는 절(SELECT/FROM/WHERE/JOIN), 컬럼, 인자 단위로 개행한다. 한 줄 몰아쓰기 금지.
• 긴 목록·나열은 쉼표 나열 대신 불릿 또는 표 행으로 분해한다.
• 쓰기 후 검증 필수: 파일 생성·수정 직후 아래로 초과 줄을 확인하고, 있으면 즉시 개행 분할해 재검증한다. timeout 60 python3 scripts/line_len.py <경로> [<경로> ...]
• 🟢 PASS 가 나와야 통과. 초과 줄을 남긴 채 작업을 완료 보고하지 않는다.
• 🔴 awk 'length($0)>2000' 를 쓰지 마라(2026-08-18 교체). BusyBox awk 의 length() 는 바이트를 센다. 한글은 UTF-8 에서 1자 = 3바이트라 문자 1,907자인 줄이 3,091 로 잡혀 오탐한다. read 의 절단 기준은 문자이므로 판정도 문자여야 한다. line_len.py 는 UTF-8 절단까지 함께 잡는다.

Step 0.7: 파일 쓰기 안전 규칙 (기존 파일 수정 시 · 정본 = 00_guides/02_파일쓰기_안전규약.md R1-7)

🔴 정본은 그 문서다. 이 절은 「금지문 + 사고 횟수」만 담는다(2026-08-20 O92-C 다이에트). 조문 번호 R1-7-1~R1-7-10 은 그대로다. 왜 그 규칙이 있는지(사고 경위)가 필요하면 정본을 읽어라 — 파일을 쓰기 전, 그리고 쓰기 사고를 조사할 때가 그 시점이다. ⇒ 10개 조문은 하나도 빼지 않았다(매 세션 노출 담보 계약 유지). 빠진 것은 경위 서사뿐이다.

🔴 이 워크스페이스에서 원장이 4회 깨졌다. 전부 같은 뿌리이고 기존 게이트를 전부 통과했다.

• R1-7-1 전체 재작성(write) 금지 · 부분 치환(edit) 기본. open().read() → 수정 → write() 금지. 읽기가 조용히 부분 반환하므로 짧게 읽힌 버퍼를 쓰면 꼬리가 잘린다. write 는 신규 파일 전용. · 🔎 경위·실사고 근거 = 20_issue/91_사고사례집.md §C16(R2-8 무변경 이관 · O111) ⇒ 코드 파일에도 edit 를 쓴다. 부득이 전체를 다시 썼다면 즉시 ㉠ 꼬리 되읽기 ㉡ py_compile ㉢ def 개수 대조 ㉣ cortex ws cp + 해시로 스테이지 대조를 하라.
• R1-7-2 쓰기 전 해시 안정성 확인(blocking) — 같은 파일 2회 이상 읽어 크기·SHA256 동일해야 착수. 다르면 중단한다(부분 반환 중이거나 타 세션이 쓰는 중).
• R1-7-3 「손상」 판정 전에 2~3회 재읽어 해시 대조. torn read 를 손상으로 오판한 사례 1회.
• R1-7-4 원장 표를 건드렸으면 timeout 60 python3 scripts/index_row_gate.py. 제목·길이·크기 게이트는 행 소실·중복을 못 잡는다. 🔴 FAIL 을 --update-golden 으로 덮지 마라. 🟢 낡은 행은 지우지 말고 행 키를 보존한 채 내용을 대체한다(좌표 인용 안정성).
• R1-7-5 토큰 1개로 「보존」을 단정하지 마라. 문자열 1개만 검사해 통과시킨 사이 편집 2건 소실. 단정 대상은 행 키 집합이어야 한다(R1-7-4 가 그 자동화).
• R1-7-6 파일 단위 discard 는 되돌릴 수 없다. USER$ 는 head == live 라 redo 경로가 없고, discard 는 그 파일의 미커밋 변경 전부를 지워 타 세션 작업까지 날린다. 제안·수행 전에 명시한다. ALTER WORKSPACE … ABORT 는 승인 없이 금지(워크스페이스 전체가 날아간다).
• 🔴🔴 R1-7-7 rm -rf 도 같은 등급의 파괴 명령이다 — 실사고 1회(허브 파일 동반 삭제 · 복원 · 손실 0). 스테이지의 「폴더」는 경로 접두다. · 삭제 전 os.listdir 로 그 접두에 걸리는 것을 나열한다. · 디렉터리 통삭제 대신 파일 개별 삭제. · 🔴 삭제 직후 ls 를 믿지 마라(OPS-3 낡은 뷰) — os.listdir + cortex ws ls 두 축으로 확인. · 🟢 조문에 없다는 것은 안전의 근거가 아니다.
• 🔴 R1-7-8 edit 앵커는 「직전 줄까지」 포함하고, 편집 직후 게이트를 돌린다. 제목줄 파괴 5회 · 표 행 꼬리 중복 · 🆕 표 행 종결 | 유실 1회(O92-B). 🔴 게이트가 없어서가 아니라 늦게 써서 놓쳤다. · 긴 표 행은 행 전체를 앵커로(접두만 넣으면 꼬리가 남는다) · 🆕 표 셀에 병기할 때는 행 끝 | 까지 앵커에 넣어라(종결자를 잃으면 index_row_gate 만 잡는다) · 행이 너무 길면 edit 대신 python 으로 줄 인덱스 지정 치환 · 편집 직후 그 자리에서 doc_heading_gate.py + index_row_gate.py · 🟢 조문·절은 번호 순서 말미에 덧붙인다(clause_order_gate.py 가 역전·중복을 blocking 으로 잡는다).
• 🔴🔴 R1-7-9 백틱·$·! 를 포함한 본문은 셸을 경유시키지 않는다 — 실사고 3회(백틱 구간이 명령치환으로 해석되어 23줄에서 전부 삭제 · O106 재발 · 🆕 O109 는 quoted heredoc·python3 -c 치환 문자열에서 두 번 — 후자는 실제로 문안의 백틱 2개가 사라졌다). 이 워크스페이스 문서는 백틱이 매 줄에 있다. · write 툴로 쓰거나 스크립트 파일을 만들어 실행한다(bash -c 인라인 python 에 본문 금지). · ⚠️ 작은따옴표로 감싸도 바깥이 큰따옴표면 백틱은 해석된다 — 중첩 인용은 방어가 아니다. · 🆕 ⚠️ <<'EOF' quoted heredoc 도 「셸 경유」다 — 확장이 없어도 조문은 경로 자체를 금지한다. · 🔴 쓴 뒤 그 구간을 되읽어라. 성공 메시지는 「줄 수가 맞다」만 증명한다.
• 🆕 🔴🔴 R1-7-10 스냅샷은 scripts/snapshot_util.py 만 경유한다 (2026-08-28 O110 신설) · _archive/ 스냅샷은 유일한 되돌리기 수단인데(R1-7-6) 종전 구현들이 조용히 덮었다 — O108 이 00_INDEX 를 3회 republish 해 최초 상태가 이미 없다. · 라벨은 인자 = --label → 환경변수 SESSION_LABEL → UNLABELED. 🔴 default='O1NN' 처럼 지난 세션 라벨을 기본값으로 두지 마라(그러면 스냅샷의 「누가」가 거짓이 된다). · 덮지 않는다 = 바이트 동일이면 재사용 · 다르면 .2·.3 · 소진 시 예외로 중단. · 호출 = snapshot(path, op, label=…, archive=ARCHIVE) · 메모리 내용은 snapshot_content(name, op, data, …). · 🔴 archive= 를 넘겨라 — 안 넘기면 테스트가 패치한 경로를 벗어나 실 _archive/ 를 더럽힌다. · 🟢 집행 = scripts/test_snapshot_util.py 축7·축8(도구별 헬퍼 경유·우회 0·기본값 하드코딩 0).

Step 0.8: 독해 기록 의무 (지침 R1-3-7 · R1-3-7-a · 🆕 R1-3-7-b · R1-3-7-c)

read 가 본문을 돌려주지 않는 실패는 조용하다(에러가 아니다). 형태 = ㉠ edited out to manage context size ㉡ Output too large ㉢ 미리보기·꼬리만.

• 호출한 사실은 확보한 사실이 아니다. 매 호출 직후 본문 도착을 확인한다.
• 미반환이면 limit 을 60~100줄로 줄여 재호출한다(R0-6 「같은 명령 재시도 금지」와 다르다).
• 미반환 파일·offset 좌표와 총 건수를 응답과 인수인계에 숫자로 적는다. 판정식 = 재호출 건수 ≥ 미반환 건수. 충족하지 못하면 「전량 확보」라고 쓰지 말고 **「도착 실증 · 복구 절차 미실행」**으로 구분해 적는다.
• 복구 실패 시 그 파일을 미독으로 명시하고 그 파일 소관 수치·판정을 인용하지 않는다.
• 🔴 대체 근거 금지: 대화 로그·이전 응답·기억은 정본의 대체물이 아니다. 재측정하거나 판단을 보류한다.

🆕 🔴🔴 [O85-C 사용자 결정] 사후 역산을 포기하고 그 자리에서 기록한다 — 미반환 호출은 컨텍스트에서 사라지므로 나중에 세려 하면 증거가 없다(경위 = 91_사고사례집.md §C02·§C03).

• 🆕 R1-3-7-b(전건 적용) — 매 독해 직후 1~2줄을 남긴다: ㉠ 파일 경로 ㉡ offset/limit ㉢ 도착 여부 ㉣ 그 구간에만 있는 고유 토큰 2~3개. 🔴 고유 토큰이 판정의 핵심이다 — 「도착 O」는 자기신고이고, 고유 토큰은 grep 으로 대조 가능하다. 🔴 작업 끝에 몰아 쓰지 마라 — 그 시점엔 이미 트리밍됐다.
• 🆕 R1-3-7-c(인용 대상 한정) — 판정 근거를 판정보다 먼저 파일에 쓴다. 순서를 뒤집는다: read → 근거를 파일에 기록 → 판정. 기록은 원문 구절 그대로 + 좌표(요약 금지). 🔴 근거를 못 썼으면 판정하지 않는다. 🆕 🔴 [O112 실사고] 이 조문을 어기면 「주변 3줄」을 못 본다 — stale 수치를 지웠는데 바로 아래에 대체 실측과 그 문구를 선행사로 인용한 문장이 있었다(§C24 계열) ⇒ 삭제보다 취소선이 안전하다.

Step 1: 작업 지침 로드

00_guides/00_작업지침_세션운영규칙.md 를 전량 읽는다. 중간에 끊기면 이어서 끝까지 읽는다(Step 0.5). 📏 크기를 이 문서에 적지 않는다 — 적으면 stale 이 된다(O85-C 기재 「306줄/31,657B」가 그렇게 틀렸다). 🔴 재려면 python3 scripts/doc_census.py 를 쓴다(조각 수·바이트·여유를 전건 실측한다). 🟢 [2026-08-28 O106] 이 지침에서 「경위 서사」가 20_issue/91_사고사례집.md 로 분리됐다 (불변식 3종 blocking 통과 = 조문 ID 집합 · 제목 집합 · R2-8-1 토큰 · 🔴 건수를 적지 마라). ⇒ 조문·판정식은 전부 지침에 남아 있고 사라진 것은 「왜 이 규칙이 생겼는가」 서사뿐이다. 🔴 사례집은 세션 시작에 읽지 않는다. 읽는 시점 = 쓰기 사고를 조사할 때 · 조문을 개정하려 할 때 · 「이 규칙을 왜 지켜야 하나」가 의심될 때. 도구 = scripts/split_narrative.py. 🔴 [O85] R1-7 파일 쓰기 안전 규약은 00_guides/02_파일쓰기_안전규약.md 로 분리됐다. 조문 번호 R1-7-N 은 그대로다. 파일을 쓰기 전·쓰기 사고를 조사할 때 그 문서를 읽는다 (세션 시작에 읽을 필요는 없다 — Step 0.7 이 조문 전건을 요약하고 지침에 포인터가 남아 있다). 🔴🔴 [O112-B] 이 자리의 「9개 조문」 기재가 낡아 있었고, 실제로 R1-7-10 이 지침 목록에서 빠져 있었다 (경위 = 91_사고사례집.md §C26). ⇒ 🔴 개수를 적지 마라. 판정식은 집합 대조다 = clause_order_gate 의 R1-7 계열 ↔ Step 0.7 의 R1-7-N 등장 집합(부재 0 이어야 한다). 🆕 이 지침에 R3 단계 종료 게이트 9종(9번의 자문 축 ㉠~㉧ 포함)이 있다. 🔴 R1-7-7(rm -rf)·R1-7-8(앵커)·R1-7-9(셸 경유)는 Step 0.7 에 이미 요약돼 있다 — 여기 다시 적지 않는다(O112-B 중복 제거 · 두 곳에 적으면 한 곳이 낡는다). 🔴 [O83-E] R1-6 문서 분할 규약은 00_guides/01_문서분할_규약.md 로 분리됐다. 🆕 [O112] 그 문서도 이제 허브 + 01_문서분할_규약_조각/ 이다 ⇒ 고칠 때는 조각을 edit → --republish. 조문 번호 R1-6-N 은 그대로다. 분할·재균형·롤오버·은퇴 작업을 할 때만 그 문서를 읽는다. 🔴 번호 범위를 적지 않는다(O112-B 실측: 이 자리 기재 ~R1-6-18 ↔ 실제 R1-6-25) ⇒ 현재 값은 python3 scripts/clause_order_gate.py 가 계열별로 출력한다. 🆕 🔴🔴 [O112 신설 R1-6-25] 문서를 쪼개면 「그 문서를 읽는 도구」의 분모가 조용히 깨진다 (실측 2건 · 경위 = 91 §C26) — 🔴 「분모 4곳 편입」 체크리스트를 이행한 뒤에도 남았다. ⇒ 🟢 이제 doc_census.py 가 기계로 대조한다(split_denominator_check · 출력의 「분할 분모 대조」가 위반 0 인지 보라 · 축이 늘면 그 함수에 추가).

Step 2: 착수 브리핑 생성 → 00_BRIEF.md 만 읽는다 (🔴 전량 독해 폐지)

🔴🔴 [2026-08-28 O106 전면 개편 · 사용자 결정] 종전 「5문서 전량 독해」는 폐지됐다.

왜 폐지했나 — 그 규약은 물리적으로 이행 불가능했고(「필수」만 수십만 자 · 값은 doc_census.py 로 재라), 지키려면 컨텍스트가 터지고 안 터지려면 읽은 척하게 된다. 🔎 경위·실측 = 20_issue/91_사고사례집.md §C13(R1-1 소관 · O111 이관).

절차는 두 줄이다.

python3 scripts/session_brief.py --write     # 정본에서 추출해 00_BRIEF.md 를 생성

그 다음 20_issue/00_BRIEF.md 를 읽는다(1회 read). 세션 시작 독해는 여기서 끝난다.

🟢 브리핑이 「독해의 산출물」에서 「스크립트의 산출물」로 바뀌었다. ⇒ 읽지 않고도 정확하고, 「읽은 척」이 원리적으로 불가능해진다(수치의 출처가 파일이고 재현 가능하다).

00_BRIEF.md 에 실리는 것 — 전부 정본에서 기계로 추출한 것이고 창작이 0 이다:

• 열린 작업(착수표) — 99_NEXT 착수 순서에서 「순」 셀이 취소선 아닌 행.
• 직전 세션 인수인계 — 「여기서 시작한다」가 취소선 아니고 날짜가 최신인 절 + 그 절의 ▣ 항목. 🔴 99_NEXT 는 이 절이 적층된다(O106 실측 8겹 · 5개는 이미 취소선). 추출기가 현행만 고른다.
• 문서50 열린 절 — 절 제목 선두가 🔴/🟠/🟡 인 것(🟢/✅ 제외).
• 최근 세션 — 원장 §1 상태 대시보드 행.
• 문서군 규모·독해 예산 · 게이트 상태 · 조각 수 stale 건수.

🔴🔴 00_BRIEF.md 는 색인이고 정본이 아니다. 각 항목은 제목 + 상태 + 좌표(파일:행) 만 싣는다. 판정·수치는 싣지 않는다. ⇒ 수치를 인용하려면 그 좌표를 read 해야 한다(R1-3-7 「대체 근거 금지」). 🟢 대신 무엇을 읽어야 하는지가 브리핑에 다 있다 ⇒ 필요한 조각만 골라 읽으면 된다.

🔴 00_BRIEF.md 를 손으로 고치지 마라 — 다음 생성에서 조용히 사라진다(허브와 같은 계약). 내용을 바꾸려면 정본(원장 조각 · 99_NEXT 조각 · 문서50 조각)을 고치고 재생성한다.

필요할 때만 읽는 문서(세션 시작에는 읽지 않는다):

01_세션이력 특정 항목 찾기 — 🔴 폴더를 대상으로 grep 한다(허브에는 본문이 없다):

grep -n "O59-G" 20_issue/01_세션이력_조각/*.md

· 항목 형식 = > #### 🟢 [YYYY-MM-DD O##] … — 🔴 제목과 [ 사이에 상태 이모지가 끼어 있어 grep '^> #### \[' 는 0건을 낸다(BusyBox BRE). 전수 추출은 ^> #### .*\[20\d\d-\d\d-\d\d O 로 한다. · 항목 추가는 반드시 아래로 한다(조각을 직접 열지 않는다 · R1-6-15): python3 scripts/split_doc.py 20_issue/01_세션이력.md --rollover --entry-file <추가할.md> · ⚠️ 그 항목의 판정·수치를 근거로 쓰려면 항목 전체를 읽는다(부분 인용 금지 · P170·P154 경로).

🔴 조각 수·크기를 이 문서나 다른 문서에서 읽지 마라 — doc_census.py 로 재라. O106 실측 = 손으로 적힌 조각 수가 3곳에서 17건 stale 이었고 세 곳이 서로 다른 값이었다. O83-H·O90 이 두 번 「교정 + 재라고 경고」했는데 경고를 적은 그 표가 다시 stale 이 됐다 ⇒ 이제 숫자를 적을 자리를 없앴다(fix_stale_counts.py). doc_census.py 가 0건을 강제한다.

지시가 20_issue/ 와 충돌하면 20_issue/ 를 우선하거나 사용자에게 문의한다.

Step 3: 브리핑 출력

🆕 [2026-08-28 O106] 게이트는 Step 2 의 session_brief.py 가 이미 돌렸다 — 그 결과가 00_BRIEF.md §6 「게이트 상태」에 실려 있다. 🆕 [2026-08-28 O110] 게이트는 6종이다(O109 가 doc_coord_gate 를 추가했다): doc_census · doc_type_gate · clause_order_gate · index_row_gate · doc_heading_gate · doc_coord_gate(인용 좌표 실재 · R1-6-22). ⇒ 따로 돌리지 않는다. 🔴 게이트 목록은 코드가 정본이다 = scripts/session_brief.py GATES. 이 문서에 적힌 수가 그것과 다르면 코드를 믿고 이 줄을 고쳐라(R3-9 ㉦). ⚠️ 브리핑을 --no-gates 로 만들었다면 그때만 손으로 돌린다. 🔴 FAIL 이면 브리핑에 그대로 적고 사용자 지시를 기다린다 — 임의로 재균형·은퇴를 돌리지 않는다 (파괴 가능성이 있는 정리 작업은 승인 대상이다). 경고(🟠)는 「다음에 깨진다」이므로 보고만 한다.

단답형으로 아래만 출력한다. 모든 수치는 00_BRIEF.md 에서 그대로 옮긴다(세지 마라 · 창작 금지).

지침 로드: OK
게이트: 유형 <판정> · 조문순서 <판정> · 행키 <판정> · 제목 <판정> · 좌표 <판정> · 조각수 stale <n>
열린 작업: <착수표 열린 건수> — <순번 3개 이내>
직전 세션 인수인계: <현행 §절 라벨> — <1줄>
문서50 열린 절: <건수>
read 미반환: <건수> · 재호출 <건수>   ← 0 이면 「0」이라고 적는다
다음 후보 작업: <1~3개>
대기 중

⚠️ 조건부 STOP — 🆕 [2026-08-18 O85 사용자 결정으로 착수표 ⑮ 확정 · 정본 = 지침 R4-4]

• ㉠ 지시가 동봉되지 않은 턴 = 브리핑 출력 후 STOP · 사용자 지시를 기다린다.
• ㉡ 지시가 같은 턴에 동봉된 경우 = 브리핑을 먼저 출력한 뒤 그 지시를 즉시 수행한다. 🔴 브리핑 생략은 여전히 금지다 — 이 조문은 「STOP 을 없앤다」가 아니라 「브리핑 없이 착수」와 「지시가 있는데도 되묻기」를 둘 다 막는다. 🔴 다만 파괴 가능 작업(discard · rm · ALTER WORKSPACE … ABORT · --rebalance·retire_rows 같은 다중 파일 재작성)은 지시가 동봉돼도 별도 승인을 받는다 — 이 예외가 ㉡ 보다 강하다.
• 🔴 어느 경우든 브리핑 미출력은 위반이다(A5). 상습 결함으로 등재돼 있다. 🔴 원인은 게으름이 아니라 조문 설계였다(경위·실측 = 91_사고사례집.md §C12).
• 🟠 롤백 조건(사용자 지시): 이 완화로 에러·재작업이 늘면 ㉡ 를 철회하고 무조건 STOP 으로 되돌린다. ⇒ ㉡ 로 진행한 세션은 이력에 「㉡ 적용」과 확정위반 건수를 함께 적는다(롤백 판단 근거).

🔴 Step 2 미독과 결합하면 근거 없는 수치와 조문 위반을 동시에 만든다 — 브리핑은 Step 2 의 산출물이다.

세션 중 상시 준수

• 🆕 🔴🔴 [2026-08-28 O111·O111-B 신설 · O112 축약 · 판정 일반화 3조] 게이트·도구 출력을 읽는 규칙. · 🔎 경위·실측 사례 = 20_issue/91_사고사례집.md §C24(R2-8 무변경 이관 · O112 · 실물 4건)

  • ㉠ 「0건」은 「없다」가 아닐 수 있다 — 「내 판정식이 못 본다」일 수 있다. ⇒ 0건을 받으면 분모와 판정식을 먼저 의심하라. 특히 「이미 다 했다」류 메시지가 위험하다.
  • ㉡ 제외 규칙은 그 근거가 성립하는 축에만 적용한다(유실 축의 근거를 중복 축에 쓰지 마라).
  • ㉢ 판정 문구가 세는 것과 사람이 읽는 뜻이 다를 수 있다. ⇒ 🟢 판정 축과 관측 축을 분리해 둘 다 숫자로 내라. 🔴 네 건 다 게이트가 🟢 인 상태에서 났다 ⇒ R3-9(게이트가 보지 않는 축)의 실물 사례다.

• 실측 중심: BRONZE 원본 직접 스캔, 완료 판정은 INFORMATION_SCHEMA 스캔 결과(P33). 🆕 🔴 [O106] 이 계정이 문서작업 전용이면 라이브 판정을 보류한다(R2-8-4-c — 수치 창작 금지). 보류 항목은 20_issue/92_실측필요_후속작업.md 에 모인다(생성 = gen_measure_backlog.py --write).

• 🆕 🔴🔴 [O106] 「수」를 문서에서 읽지 말고 doc_census.py 로 재라. 대상 = 조각 수 · 문서 바이트 · 여유 · 세션 시작 독해 예산.

  python3 scripts/doc_census.py            # 인벤토리 + stale 대조
  python3 scripts/doc_census.py --strict   # stale 1건이라도 있으면 exit 1
  

  🔴 문서에 조각 수를 새로 적지 마라 — 적으면 doc_census 가 stale 로 잡는다(blocking 옵션). 실측 근거 = O106 착수 시점 3곳 17건 stale · 세 곳이 서로 다른 값이었다. 🟢 이미 적혀 있던 수치는 fix_stale_counts.py --apply 가 포인터로 교체했다. 🆕 🔴🔴 [O112-B] 이 도구는 「분할 분모 대조」도 함께 판정한다 — 문서를 쪼갠 직후 반드시 보라. 실측 = 분할 후 clause_order_gate 가 조문 0개로 ✅, fix_stale_counts 가 본문을 건너뜀 ⇒ 둘 다 체크리스트를 이행한 뒤에도 남았다. 판정 = 출력의 「분할 분모 대조 … 위반 0건」.

• 🆕 [O106] 브리핑은 손으로 쓰지 않는다 — session_brief.py --write 가 00_BRIEF.md 를 생성한다. 🔴 00_BRIEF.md·92_실측필요_후속작업.md 는 자동 생성물이다. 손으로 고치면 다음 생성에서 사라진다 (허브와 같은 계약). 내용을 바꾸려면 정본을 고치고 재생성한다.

• 모든 파일(.md/.sql/.yml/.py 등)은 Step 0.5 규칙대로 read 툴 분할 호출로 전량 읽는다. ⚠️ [O106] 「세션 시작에 무엇을 읽는가」는 Step 2 가 정한다 — R1-3 은 읽기로 결정한 파일에 적용되는 규칙이고 「전부 읽어라」가 아니다. 둘을 혼동하면 다시 수십만 자를 읽으려 하게 된다.

• 문서·코드 작성 시 Step 0.6 규칙대로 한 줄 2000자를 넘기지 않는다. 쓰기 직후 python3 scripts/line_len.py <경로들> 로 검증한다(awk 금지 — 바이트 오탐).

• 기존 파일 수정은 Step 0.7 규칙대로 edit 부분 치환만 쓴다. 전체 재작성 금지. 🔴🔴 **R1-7-9 는 O106·O109·O112 가 다시 어겼다 — python3 -c·quoted heredoc 둘 다 셸 경유다. ⇒ 🔴 본문에 백틱·$·! 가 있으면 edit/write 툴로 쓴다(경위 = 91 §C16·§C24 계열).

• 원장 표를 건드렸으면 python3 scripts/index_row_gate.py 로 행 유실·중복 0 을 확인한다.

• 🆕 문서 유형·용량 불변식 및 제너레이터 체계(지침 R1-6-14~R1-6-18 · 정본 = 00_guides/01_문서분할_규약.md): · python3 scripts/doc_type_gate.py — 유형 미선언 0 · 상한 초과 0 · 여유 부족 0 을 확인한다. 유형 정본은 **원장 §0 「문서 유형 등재표」**다(문서 수는 doc_census.py 로 재라). · 🔴🔴 허브(00_INDEX_이슈원장.md 등 분할된 문서의 원 파일)에 내용을 쓰지 마라. 허브는 자동 생성물이고 --republish·--rebalance·--rollover 가 통째로 다시 쓴다 ⇒ 허브에 손으로 적은 문장은 경고 없이 사라진다(조용한 소실 · 이 워크스페이스가 4번 당한 유형). 내용은 조각(-001…)에 쓴다.

  ▣ [문서 제너레이터 도구 일람표]

  1. 허브 재구성 제너레이터 (scripts/split_doc.py --republish):
     • 조각 파일(_조각/) 편집 후 허브 파일을 재생성한다.
     • 🔴 --expect TOKEN 필수(R1-6-23): 방금 넣은 핵심 변경 토큰이 조각과 허브에 실제로 존재하는지 기계 검증(누락 시 실패).
     • 예시: python3 scripts/split_doc.py 20_issue/30_설계_의사결정.md --republish --expect "DEC-49"
  2. Append형 문서 롤오버 제너레이터 (scripts/split_doc.py --rollover):
     • 01_세션이력.md, 90_해소완료_로그.md 등 추가형 문서에 조각 상한(300줄/40KB)을 준수하며 새 항목을 자동 배분 및 허브 갱신.
     • 예시: python3 scripts/split_doc.py 20_issue/01_세션이력.md --rollover --entry-file tmp/_o135_entry.md
  3. 조각 재균형 제너레이터 (scripts/split_doc.py --rebalance):
     • 조각이 300줄/40KB 상한에 근접했을 때 섹션 단위로 균등 재분할 (--fill 0.7 등).
  4. 조각 폴더화 제너레이터 (scripts/split_doc.py --to-outdir):
     • 형제 방식 조각들을 _조각/ 전용 폴더로 안전 이전 (--to-outdir <이름>_조각 --apply).
  5. 착수 브리핑 생성기 (scripts/session_brief.py --write):
     • 99_NEXT_SESSION 착수표, 직전 세션 인수인계, 문서50 미결, 게이트 6종 상태를 자동 추출하여 20_issue/00_BRIEF.md 생성.
  6. 실측 백로그 생성기 (scripts/gen_measure_backlog.py --write):
     • 라이브 미실측 및 보류 항목을 추출하여 20_issue/92_실측필요_후속작업.md 생성.
  7. 장문 셀 은퇴 제너레이터 (scripts/retire_rows.py --apply):
     • 원장 표의 닫힌 행 장문 셀을 포인터화하고 90_해소완료_로그로 이관.
  8. 절 본문 은퇴 제너레이터 (scripts/retire_sections.py --apply):
     • 닫힌 절의 본문을 은퇴 문서로 이관(제목줄 보존).
  9. 사례집 이관 제너레이터 (scripts/split_narrative.py):
     • 지침 조문의 경위 서사를 91_사고사례집.md로 자동 분리.

  · 갱신형 내용 수정 = 해당 조각을 edit → python3 scripts/split_doc.py <허브> --republish --expect "<토큰>". · append형 항목 추가(이력·90) = python3 scripts/split_doc.py <허브> --rollover --entry-file <추가할.md> — 조각을 직접 열지 않는다. · 조각이 상한에 가까우면 split_doc.py <허브> --rebalance (부분 충전 --fill 0.7). 🆕 ⚠️ [O106] 미분할 문서를 처음 쪼갤 때는 --rebalance 가 따로 필요하다 — build 는 fill 을 받지 않아 상한 이내면 1조각으로 끝난다(fits() 판정). 2단계로 한다: split_doc.py <문서> --outdir <이름>_조각 --boundary section → split_doc.py <문서> --rebalance --fill 0.5. 🔴 폴더명에 _조각 접미 필수(스테이지의 「폴더」는 경로 접두라 없으면 허브까지 지워진다 · R1-6-10). · 갱신형 원장이 커지면 닫힌 행만 python3 scripts/retire_rows.py … --apply 로 90 에 은퇴 이관한다 (행 삭제가 아니라 셀 비우기 — 행 키·열 수 보존 · R2-8-1 토큰 대조 blocking · 스냅샷 자동). 🆕 🔴 [O106] retire_rows.py 는 「절」을 옮기지 못한다 — 표 본문 행의 장문 셀만 포인터로 대체한다(big_cell_index). 🆕 🟢 [2026-08-28 O107] 절 단위 도구가 신설됐다 = scripts/retire_sections.py(R1-6-19). 🔴 절을 옮기지 않고 「본문」만 옮긴다 — 제목 줄을 하위 제목까지 한 줄도 건드리지 않으므로 §제목 인용 좌표와 doc_heading_gate 제목 집합이 원리적으로 보존된다(골든을 덮을 필요가 없다). 좌표 대응표 + R2-8-1 토큰 대조 blocking + 스냅샷 + dry-run 기본 + 멱등 차단. 🔴 실제 적용은 R4-4-3 별도 승인 대상이고 「닫힘」 표기는 제목 이모지 판정일 뿐이다 — 은퇴 전에 그 절을 읽어라. 음성 테스트 = scripts/test_retire_sections.py(9축). 🆕 🔴🔴 [2026-08-28 O111-B · R1-6-24] 「닫힘」 후보를 그대로 믿으면 대부분이 오이관이다. · 🔎 경위·실사고 근거 = 20_issue/91_사고사례집.md §C22(R2-8 무변경 이관 · O111-B) 🟢 도구가 열림 신호 5종(🔴/🟠/🟡 · 복귀 트리거 · 미결·대기 · BLOCKING-N · 존재 이유 자기선언)을 세어 --list 에 숫자로 표시하고 적용 경로에서 기본 차단한다(--force 로만 통과 · 통과시켰으면 이력에 적어라). ⚠️ 절감 기대치를 낮게 잡아라 — 실측 418 B 이관 = 절감 27 B. ⇒ 은퇴는 용량 회복 수단이 아니라 가독성 수단이고, 부분 은퇴가 정답인 경우가 많다. ⚠️ retire_rows.py 는 목적지(90)가 허브가 된 뒤에도 허브에 직접 append 한다(미시정) — 쓰기 전에 목적지가 허브인지 확인하라(허브에 쓴 내용은 다음 --republish 에서 사라진다). · 🆕 🔴🔴 [O107] 유지 연산 전·후에 「방금 넣은 토큰」을 grep 으로 단정한다. · 🔎 경위·실사고 근거 = 20_issue/91_사고사례집.md §C17(R2-8 무변경 이관 · O111) 🟢 복구 수단은 작성자가 다시 쓰는 것뿐이었다(스냅샷에도 없다) ⇒ 긴 절은 별도 파일 (_o1NN_entry.md)에 먼저 쓰고 붙여라. 이력 항목은 그 방식이어서 살았다. · 🆕 🔴🔴 [2026-08-28 O111-B · R1-6-23] 그 grep 을 손으로 하지 말고 도구에 넘겨라 = --expect TOKEN(반복 가능 · --republish·--rebalance). 🔴 같은 사고가 두 번 났고 두 번 다 게이트 6종이 전부 🟢 였다 — --verify 는 자기일관성만, R1-7-2 는 같은 시점 2회 읽기만 보므로 시점 간 불일치는 원리적으로 못 잡는다. · 🔎 경위·실사고 근거 = 20_issue/91_사고사례집.md §C25(R2-8 무변경 이관 · O112) ⇒ --expect 는 ㉠ 쓰기 전 방금 수집한 내용에 있는가 ㉡ 쓴 뒤 되읽어도 있는가를 둘 다 단정하고, 없으면 쓰지 않고 exit 1 한다. 🟢 토큰은 그 세션이 방금 넣은 것을 준다(세션 라벨 · 새 절 제목 · 새 표 행의 고유 문구). 🆕 🔴 토큰은 「연속 리터럴」이어야 한다 — 마크다운 장식(**·백틱)이 끼면 부분문자열이 아니므로 신선도 FAIL 이 난다(O112 실측 1건 · 파일은 정상이고 선언이 틀렸다). ⚠️ 선언 기반이다 — 주지 않으면 검사할 것이 없다. 음성 테스트 = test_split_doc_expect.py(5축). · 🆕 🟢 [2026-08-28 O107] 형제 조각을 폴더로 이전 = split_doc.py <허브> --to-outdir <이름>_조각 --apply (R1-6-21). 🔴 폴더에 먼저 쓰고 concat 바이트 동일을 확인한 뒤에만 형제를 개별 삭제한다 · _조각 접미 없으면 거부 · 이미 폴더면 거부 · 기본 dry-run. 🔴 이전 후 손으로 고칠 분모 = doc_census.FAMILIES · doc_line_length_gate.CANON_GLOB (죽은 패턴은 지운다) · decision_closure_gate 2곳(DECISION_GLOB 은 형제 파일명 직접 의존 · ISSUE.glob("*.md") 는 1단계만 본다). 🟢 마커를 읽는 게이트 3종 + doc_census.chunk_paths 는 자동 추종. 🟢 현재 폴더 방식 = 01_세션이력_조각 · 90_해소완료_로그_조각 · 99_NEXT_SESSION_조각. 🟠 20_issue/ 7문서는 아직 형제 방식이다(대상·조각 수는 doc_census.py 로 재라) — 이전하려면 decision_closure_gate 를 먼저 고쳐라. · 🆕 조문의 「왜 필요한가」 경위 서사는 split_narrative.py 로 91_사고사례집.md 에 이관한다 (불변식 3종 blocking = 조문 ID 집합 · 제목 집합 · R2-8-1 토큰). 🔴 처방(🟢/⚠️)은 옮기지 않는다 — 옮기면 조문이 지시를 잃는다(O106 초판이 실제로 처방 3줄을 빼냈다 · PRESCRIPTION 가드로 차단).

• 🆕 🔴 20_issue/ 에 문서를 「새로」 만들 때는 순서를 지킨다(지침 R1-6-18): ① 원장 §0 유형 등재표에 한 줄 먼저 등재(유형 + 근거 + 처리) — 빠뜨리면 doc_type_gate 축1 즉시 FAIL. ② write 툴로 생성(신규 전용) + LLM-METADATA 헤더 필수(doc_id·doc_role·project·created·index). ③ 상한 이내면 분할하지 않는다 — 허브+조각은 상한을 넘을 때만 만든다(불필요한 간접층 금지). ④ 폴더 밖 문서면 doc_type_gate.EXTRA_DOCS·doc_heading_gate.DOCS·doc_line_length_gate.CANON 에 손으로 편입. 🔴 이 단계를 빠뜨려 지침이 45,116B 까지 커졌는데 게이트가 침묵했다(O83-E). 🆕 🔴🔴 분모 편입과 「기준선 발행」은 별개의 두 동작이다 — doc_heading_gate.DOCS 에만 넣고 골든을 발행하지 않으면 그 문서의 제목 유실은 검사되지 않는다(O83-H 실측: 01_문서분할_규약.md 가 이 상태로 방치됐고 출력은 ⚪ 로 조용히 흘렀다). ⇒ 유실 0 을 확인한 뒤 반드시 발행한다: python3 scripts/doc_heading_gate.py --update-golden --reason "<사유>" 🟢 [O83-H] 이제 미등재는 ⚪ 가 아니라 🔴 FAIL 이다 — 잊으면 게이트가 막는다. 🆕 🔴 [O106] 분모가 4곳으로 늘었다 — 분할 문서를 새로 만들면 doc_census.FAMILIES 에도 (허브 상대경로, 'sibling' 또는 폴더명) 을 등재한다. 빠뜨리면 그 문서의 조각 수는 stale 검사 밖이 된다(이 도구가 막으려던 바로 그 상태다). 미분할 상시 독해 문서는 doc_census.SINGLES 에 넣는다. ⑤ doc_type_gate.py + line_len.py + doc_census.py + cortex ws ls 로 확인. 🆕 ⑥ 🔴 게이트·생성기를 새로 만들면 음성 테스트를 같이 만든다(R3-2). 선례 = scripts/test_*.py(🔴 축·단정 수를 여기 적지 마라 — 각 테스트가 스스로 세어 출력한다). 🔴 왜: 도구를 만들 때 나온 자기시정을 전부 음성 테스트가 잡았다(정상 입력만으로는 0건이었다). 🟢 O112 선례 = 오염 기반 축(분모를 일부러 깨서 검출·복구를 양축 단정) = test_doc_census.py 축6. 🟢 새 문서를 만들기 전에 기존 문서에 절을 추가하는 편이 낫지 않은지 먼저 판단한다 (문서 수가 늘면 독해 호출 수가 늘어난다 · 현재 규모는 doc_census.py 로 재라).

• 🆕 🔴 조문·절을 신설하면 python3 scripts/clause_order_gate.py 를 돌린다(O83-H 신설 · 지침 R1-7-8). 번호 순서 말미에 덧붙인다 — 중간 삽입은 번호와 문서 순서를 어긋나게 만들고, 실제로 삽입 과정에서 제목줄이 덮여 지워졌다. 축1 역전 · 축2 중복은 blocking · 축3 결번은 🟠 경고다.

• read 미반환은 Step 0.8 규칙대로 좌표·건수를 숫자로 기록한다.

• 파일 생성·수정 후 cortex ws ls 로 스테이지 실체 확인(P102).

• 라벨(O##)은 python3 scripts/id_collision_gate.py --next O 로 확인한 뒤 원장에 한 줄 선점 등재하고 착수한다(R1-4-3). 🔴 게이트의 「다음 발급」을 그대로 믿지 마라 — P222 참조 축 과대. 원장·이력에 「O85 계열」처럼 예고 문장이 있으면 참조 최대가 부풀려진다. ⇒ 정의 축 최대값을 함께 보고 판단한다. 🟢 같은 세션의 후속 작업 단위는 새 번호를 발급하지 말고 접미(-B·-C…)로 잇는다(경합·과대 회피).

• 로드맵 단계 종료 시 지침 R3 의 9개 게이트를 전부 통과 (7 = 행 키 · 8 = 미반환 건수 · 🆕 9 = 게이트가 보지 않는 축 ㉠~㉧ 8개 · 🔴 목록이 늘면 이 범위도 고쳐라).

• 🆕 🔴🔴 게이트 전수 PASS 는 「지침 준수」의 증거가 아니다(O83-H 실측 = 게이트 6종 🟢 에서 결함 4건). ⇒ 보고 전에 게이트가 보지 않는 축 8개를 자문한다. 🔴 정본은 지침 R3-9 ㉠~㉧ 이고 그 문서는 Step 1 에서 전량 독해된다 ⇒ 여기서는 질문만 싣는다 (O112 축약 · 종전에는 지침 본문을 그대로 다시 실어 두 곳이 각자 낡았다 · R3-9 ㉡ 자체 위반이었다). ① 원장 §1 대시보드가 실제 상태와 같은가(R4-2) ← ㉠ ② 같은 것을 다르게 재는 지점이 또 있는가 ← ㉡ ③ 분모에 넣은 문서의 기준선(골든)을 발행했는가 ← ㉢ ④ 신설 조문이 번호 순서 말미에 있는가 ← ㉣ ⑤ 「완료」가 라이브 실재를 주장하는가 → 닫기 직전 재조회(R2-8-4) ← ㉤ ⑥ 내 결정을 인용한 정본을 전수 검색했는가 → python3 scripts/decision_closure_gate.py ← ㉥ 🔴 무시는 답이 아니다 — 병기해 닫거나 열린 이유를 그 자리에 적는다. ⑦ 내가 만든 「수」가 문서에 박혀 있지 않은가 → python3 scripts/doc_census.py ← ㉦ ⑧ 자동 생성물(00_BRIEF.md·92_…·모든 허브)을 손으로 고치지 않았는가 ← ㉧

• 🔴 dbt 명령은 에이전트가 실행하지 않는다 — 사용자가 직접 실행한다. 대상 = dbt parse · dbt compile · dbt build(및 run/test 등 모델을 만지는 명령 전부). ⇒ 해당 단계에 도달하면 즉시 중단하고, 실행할 명령을 그대로 제시한 뒤 사용자 입력을 대기한다. 에이전트는 명령문 작성·결과 해석까지만 담당한다.

• 응답은 단답형(R4-3). 🔴 장문 표·절 나열 보고는 이 규칙 위반이고 상습 결함(A8)이다.

세션 종료 시

🆕 [2026-08-28 O106] 큰 작업을 마치면 아래를 실행한다(R4-2 의 집행부).

python3 scripts/doc_census.py                     # stale 0 · 여유 확인
python3 scripts/session_brief.py --write          # 00_BRIEF 재생성(게이트 6종 포함)
python3 scripts/gen_measure_backlog.py --write    # 실측필요 항목 재생성
python3 scripts/decision_closure_gate.py          # 🆕 내 결정을 인용한 정본이 stale 인가(경고)

🆕 🔴 [O110] 「음성 테스트를 전부 돌렸는가」는 목록을 세지 말고 파일로 재라 — 🔴 목록을 여기에 적지 마라(적으면 stale 이 된다 · R3-9 ㉦. O110 이 8종을 적어 뒀고 O111-B 시점에 13종이었다). 전건 실행 = 한 줄로 돈다:

for t in scripts/test_*.py; do python3 "$t" >/tmp/t.out 2>&1; r=$?; [ $r -ne 0 ] && echo "🔴 $t rc=$r"; done

🆕 🔴🔴 [2026-08-29 O120 신설 · 종전 판본이 실패를 감췄다] 종료코드를 파이프 뒤에서 읽지 마라. 종전 문안은 python3 "$t" | tail -1 이었다 — 🔴 $? 는 tail 의 코드이고 테스트의 코드가 아니다. · 실해 1 = O120 이 도메인 게이트를 같은 형태로 돌려 「14종 전건 exit 0」을 사용자에게 발행했고, 파이프 없이 재측정하니 16종 중 rc=1 이 4건이었다(분모·판정 둘 다 거짓). · 실해 2 = 그 형태로 돌던 음성 테스트 중 test_retire_sections.py 가 rc=1 로 실패하고 있었는데 여러 세션 동안 보이지 않았다(마지막 줄만 봤으므로). O120 이 위 형태로 바꿔 처음 적발했다. ⇒ 🔴 판정식 = 판정은 「출력 문구」가 아니라 「종료코드」이고, 종료코드는 리다이렉트로 받아라. 출력을 보고 싶으면 파일로 받아서 따로 열어라(>/tmp/t.out 후 read). 🔴 이 규칙은 게이트·테스트·도구 전부에 적용된다 — | tail·| head·| grep 뒤의 $? 는 전부 남의 것이다. ⚠️ 인자가 필수인 도구는 게이트가 아니다 — 무인자 크래시를 FAIL 로 세지 마라 (O120 이 o54_sv_value_gate 를 그렇게 오분류했다 · 그 도구는 이제 사용법 + exit 2 를 낸다). 🆕 🔴🔴 [2026-08-29 O112·O112-B 신설 · 유지 연산 실전 3칙] 이 세 가지가 이 세션에 시간을 잃게 했다.

• ㉠ --expect 토큰은 「연속 리터럴」이다. 마크다운 장식(**·백틱)이 문구 중간에 끼면 부분문자열이 아니므로 신선도 FAIL 이 난다 — O112 에서 두 번 그렇게 멈췄고 둘 다 파일은 정상이고 내 선언이 틀렸다. ⇒ 🟢 토큰은 장식이 없는 구간에서 고른다 (예: 착수 선점(진행중) · O112 병기). 🔴 가드가 멈추면 파일보다 토큰을 먼저 의심하라.
• ㉡ 유지 연산 직후의 게이트 FAIL 을 곧바로 믿지 마라(R1-7-3 · OPS-3 낡은 뷰). 실측 = 허브 3개를 재발행한 직후 제목·행키 게이트가 유실 1건씩을 냈고, 재읽기하니 둘 다 통과였다. ⇒ 2~3회 재실행한 뒤에 판정하고, 그 사이에 「내가 깼다」로 문서를 고치지 마라.
• ㉢ 원장 §1 행은 1,900자 안에 들어가지 않으면 계속 재작성하게 된다. 실측 = O112 행이 1,940 → 1,924 → 1,902 → 1,896 로 세 번 깎였다(그때마다 --republish). ⇒ 🟢 행을 쓰기 전에 「①~⑥ 각 항목 1문장」으로 초안을 잡고, 상세는 처음부터 이력으로 보내라.

🆕 🔴 [O111-B] 골든을 재발행할 때는 --reason 을 반드시 준다(3종 전부 지원한다): index_row_gate · doc_heading_gate · test_generators. 🔴 사유 없는 발행은 「정당한 재발행」과 「FAIL 을 덮은 발행」을 사후에 구별할 수 없게 만든다 (R1-7-4). 🟢 발행 전에 차이를 전량 분해하고 실유실 0 을 확인한 근거를 그 사유에 적어라. ⚠️ test_generators --update-golden 은 /tmp/schema.json 이 없으면 스키마 지문을 잃는다 — O111-B 가 실제로 한 번 지웠다(가드를 넣어 이제 이전 값을 보전한다). 발행 후 지문이 살아 있는지 보라.

그리고 정본 3곳을 갱신한다 — 🔴 셋은 서로 대체물이 아니다:

• 원장 §1 대시보드 행(상태) — 조각을 edit → split_doc.py <허브> --republish --expect "<라벨>" 🔴 --expect 를 붙여라(R1-6-23 · 경위 = 91_사고사례집.md §C25). ⚠️ 원장 행은 2,000자 상한을 넘기기 쉽다(R1-5-1 · 표 행은 개행 불가) ⇒ 상세는 이력으로 넘기고 행은 1,900자 이내로 쓴 뒤 line_len.py 로 확인한다.
• 01_세션이력 항목(서술) — split_doc.py 20_issue/01_세션이력.md --rollover --entry-file <파일>
• 99_NEXT_SESSION 인수인계 절(다음 세션이 읽을 것) — 🔴 「여기서 시작한다」를 새로 쓰고 이전 절의 그 문구를 ~~취소선~~ 으로 승계 표시한다. 그러면 session_brief.py 가 현행만 고른다. ⚠️ 승계 표시를 빼먹으면 브리핑이 날짜로만 판정하므로 옛 절이 현행으로 뽑힐 수 있다. 🆕 ⚠️ 그 취소선 편집은 doc_heading_gate 에 「제목 유실 1건」으로 잡힌다(제목 문자열이 바뀐다) — 이것은 정상 관례다 ⇒ 실유실 0 을 확인하고 --update-golden --reason "<승계 표기>" 로 발행한다. 🆕 ⚠️ 새 절을 쓰면 그 조각이 300줄 상한에 걸릴 수 있다 — O111 은 자기 절을 압축해 피했고 O111-B 가 승인받아 재균형했다. 상한에 닿으면 압축 또는 재균형이고, 재균형은 R4-4-3 승인 대상이다.

🆕 🔴🔴 [2026-08-28 O110 신설 · O109 D1 처방] 「닫았다」고 쓰기 전에 그 항목의 정본 행을 고쳤는지 확인한다. · 🔎 경위·실사고 근거 = 20_issue/91_사고사례집.md §C18(R2-8 무변경 이관 · O111)

• 판정식 = 「닫았다·완료·재정의」를 쓸 때마다 그 문구가 가리키는 정본 행/절을 열어 고쳤는가? · 착수표 항목이면 99_NEXT 착수 순서 표의 그 행(순 셀 취소선 + 대체 처방 명시) · 이슈면 원장 §1 행 · 결정이면 30_설계 절 · dbt 항목이면 문서50 절.
• 확인 방법(둘 다 한다): ① python3 scripts/session_brief.py --write 후 열린 착수표 건수가 줄었는지 본다. 🔴 줄지 않았다면 닫지 못한 것이다(보고 문구가 아니라 브리핑이 정본이다). 🆕 🔴🔴 [O112] 이 판정식은 「추출기가 안 바뀌었을 때만」 성립한다 — 종전 추출기는 조각 경계에 걸린 행을 탈락시켜 11 을 냈고 실제는 15 였다(경계가 바뀌면 수가 움직인다). ⇒ 추출기·조각 경계를 건드린 세션은 건수 비교 대신 ② 를 근거로 삼아라. ② grep -n "<그 항목 표시>" 99_NEXT_SESSION_조각/*.md 로 취소선 표기를 눈으로 확인한다.
• 🟢 취소선 관례 = | ~~⑥~~ | ~~옛 제목~~ → 🟢 [세션 라벨 재정의·수행] 새 처방 |. 🔴 행을 지우지 마라(R1-7-4 · 좌표 인용 안정성) — 취소선 + 대체 문장으로 남긴다. 🔴 「하지 마라」를 본문에 적어라 — 다음 세션은 옛 처방을 그대로 실행할 수 있다.

Output

지침 + 00_BRIEF.md 컨텍스트가 로드된 상태 + 단답형 브리핑 + 사용자 지시 대기 (지시가 동봉됐으면 브리핑 후 즉시 수행 · R4-4-2).