docs: 2026-08-26 구조 개선 계획과 잠금 달린 실행판을 docs/plan에 둔다 - #12
Merged
Conversation
왜: 8/26 구조 검수(범위 b0c7eb8..5e54d6b)가 1,000줄을 넘긴 파일 3개, 이미 큰 파일 4개의 팽창, 그리고 복사본이 갈라져 생긴 행동 결함 6건(EXPUNGE Thread 로그 누락 · deferAll의 NOTIFY=NEVER 무시 · Identity/changes 와이어 노출 · 집계 리포트의 report-type · 데드라인 계층 역전 · 종료 훅의 cwd 해석)을 냈다. 이전 TODO(T-07 ②, T-09)가 "헬퍼 하나로" 하라고 적은 것을 손으로 넣은 결과가 그 결함들이라, 이번에는 계획서(논거)와 실행판(순서·통과·잠금)을 나누고 실행판의 통과 조건을 전부 기계 판정으로 둔다. 실행판이 거는 것: P0에서 scripts/gate.ts(순서 R1·최신성 R2·재검 R3, how 8종)를 만들고 단계마다 봉인 파일(docs/plan/seals/)을 요구한다. 결정(D-01~D-07)은 decisions.json으로만 인정되어 결정 없는 단계는 열리지 않는다. 계획서의 모든 숫자(줄 수·개수·델타·릴리즈 9회·골든 10,000쌍)는 어느 GATE의 통과 기준이다. 결함 6건은 red-green(부모 빨강·HEAD 초록)으로만 닫힌다. 최종 판정: src/**/*.ts 중 1,000줄 초과 파일이 apps/server/src/app.ts 하나뿐이고(G-P8.7) 래칫(G-P8.5)이 그것을 다시 키우지 못하게 한다. 기존 docs/AUDIT-*-TODO.md 형식을 따르지 않은 이유: 그 형식은 "무엇을 왜"까지 잘 적지만 통과 조건이 사람 판단이고 순서를 기계가 걸지 않아, 전부 처리했다는 커밋 뒤에 미완이 남았다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
PR #12를 올리며 확인: main에 pull_request·required_status_checks·required_linear_history 규칙이 걸려 있어 CLAUDE.md의 'git push origin HEAD:main' 절차는 실행 불가다. 계획·실행판이 그 절차를 그대로 적고 있었으므로 고친다. CLAUDE.md·AGENTS.md 본문 수정은 8-A(D-05)에서. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
무엇
8/26 구조 검수(범위
b0c7eb8e..5e54d6b) 후속 문서 두 개를docs/plan/에 둔다.REFACTOR-2026-08-26.md— 계획서(논거 · 위치 · 문제 · 수정 방향). 9단계 · 33배치 · 결정 항목 D-01~D-07 · 릴리즈 케이던스 · 위험 목록.REFACTOR-2026-08-26-todo.md— 실행판(순서 · 통과 조건 · 잠금만). 62작업 · 172 TC · GATE 10. 통과 조건은 전부 기계 판정이고, P0.T1이 만들scripts/gate.ts가 단계 봉인(docs/plan/seals/)과 순서를 강제한다.왜
검수가 낸 결함 6건(EXPUNGE Thread 로그 누락 ·
deferAll의 NOTIFY=NEVER 무시 ·Identity/changes와이어 노출 · 집계 리포트report-type· 데드라인 계층 역전 · 종료 훅 cwd 해석)은 전부 "복사한 블록이 하나만 고쳐진" 결과다. 이전 TODO의 T-07 ②·T-09가 "헬퍼 하나로" 하라고 적은 것을 손으로 넣은 결과가 그 결함이라, 이번에는 통과 조건을 사람 판단에서 빼고 기계에 준다.이 PR이 바꾸는 코드
없다 — 문서 두 개뿐. 스키마·동작 무변경.
착수 전에 정할 것 (실행판 §0 결정 파일)
D-05 — CLAUDE.md 116행("main 푸시는 배포를 트리거하지 않는다")과 149행("main 푸시가 곧 라이브 배포다")이 모순. 이 PR을 만들면서 확인한 사실: main은 ruleset으로
pull_request·required_status_checks·required_linear_history가 걸려 있어 직접 push 자체가 거부된다. 즉 149행과 "워크트리에서git push origin HEAD:main" 절차는 낡았고, 실제 흐름은 PR 머지 →release.yml수동 실행이다. 계획의 P8.T1이 CLAUDE.md·AGENTS.md를 고칠 때 이 사실을 반영해야 한다.🤖 Generated with Claude Code