[patternflow-bot]

dev / https://claude.ai/code/session_01EBqghsXippKV7Bj3UPRY1a

정리 1단계(문서 구조)를 정찰하고, 세 갈래(A 루트 파일 옮기기 · B CHANGELOG 를 릴리스별 파일로 나누기 · C 한영 짝 목록)로 나눈 계획서를 썼다. 갈래끼리 고치는 파일이 하나도 겹치지 않아 머지하면 바로 세 시트에 동시에 맡길 수 있고, 루트에 남길 파일과 README 이야기 절의 자리는 창작자 답을 기다린다.

좋아지는 것: 없음

체크리스트

• docs/rfc-cleanup.md §2.3 · rfc-cleanup-progress 읽기
• 0단계 출발점(baseline · doc map CSV) 읽기
• 1단계가 건드리는 파일·폴더 정찰 (링크 지도 + git grep + CI 워크플로 + release.py)
• 갈래 표 작성 — 갈래 3 · 갈래마다 고칠 파일 · 안 겹침 · 먼저/동시
• docs/investigations/2026-10-cleanup-step1-plan.md 커밋
• docs/rfc-cleanup-progress.md 표에 1단계 「planned」 + 계획서 링크
• dev merge (그새 안 움직임 — Already up to date)

한 일

• 계획서 docs/investigations/2026-10-cleanup-step1-plan.md (영어, 0단계 기록과 같은 꼴). 구현은 하지 않았다.
• 갈래 표 (자세한 파일 목록은 계획서 맨 위 표)
  • A — 루트 옮기기: A1 BUILD_GUIDE_v2.md → docs/legacy/ (지금) · A2 나머지 루트 파일 (질문 1 답 뒤) · A3 README 이야기 절 → docs/story.md (질문 2 답이 「옮긴다」일 때만). 지도 문서(AGENTS.md · docs/README.md · docs/REPOSITORY.md)는 A 가 가진다.
  • B — CHANGELOG 나누기: B1 하나 (지금, A1·C1 과 동시). CHANGELOG.md · docs/releases/ · docs/RELEASING.md · release.py · roadmap-data.ts 의 links 만.
  • C — 한영 짝 목록: C1 parity CSV (지금) · C2 doc map 이 .yml 도 읽게 (선택) · C3 1단계 닫기 (A·B 다 머지된 뒤).
  • doc-map CSV 는 C 만 커밋한다 — A·B 는 돌려서 결과만 PR 에 적고 CSV 는 되돌린다.
• 정찰에서 나온 것 (RFC 가 몰랐던 것)
  1. docs/releases/ 가 이미 있다 — v3.0.0.md · v3.1.0.md(긴 릴리스 노트)가 CHANGELOG 를 나눌 이름과 겹친다.
  2. RFC 가 말한 한영 짝(*.ko.md · 콘솔 페이지 짝 · features-data detailKo)은 셋 다 없다. 실제 짝은 저널 37쌍 · roadmap titleKo/detailKo 84개 · atlas nm/nmEn 등 · 가이드 copy 의 en/ko · /guide/* 와 /ko 경로 5쌍.
  3. doc map 은 .yml 을 안 읽는다 — .github/ISSUE_TEMPLATE/config.yml 이 SUPPORT.md 를 절대 주소로 가리킨다.
  4. CHANGELOG 를 읽는 코드는 release.py 하나. 머리글 · RELEASING.md · docs/README.md 52줄 · 긴 노트 배너 넷이 「루트가 전부」라고 말한다.
  5. CLAUDE.md · CITATION.cff 는 루트에서만 제 일을 한다. CODE_OF_CONDUCT · SECURITY · SUPPORT 는 GitHub 이 docs/ 에서도 찾는다.
• 창작자에게 물을 것 (계획서 끝 절. 1·2 는 RFC 의 질문, 7–11 은 정찰에서 나왔고 기본값이 있다)
  1. 루트에 남길 파일 — 제안: 기본 목록 + CLAUDE.md · CITATION.cff · AUDIO_GUIDE.md, 공동체 파일 셋은 docs/ 로
  2. README 이야기 절(Where it began · The community responded · Story so far)을 둘지 docs/story.md 로 옮길지 — 기본값 없음, 일꾼이 정하지 않는다
     7–11. 긴 노트 이름 양보(D1) · 그대로 옮긴 글은 300줄에서 뺀다(D3) · 루트 3절과 파일이 어긋나는지 보는 검사를 2단계에(D2) · 실제 있는 짝을 쓴다 · v2 가이드는 리디렉트·껍데기 없이(D6)

증거

$ python3 .github/scripts/check_links.py
All 633 relative links resolve

$ git add <계획서> && (cd web && npm run doc-map)    # 0단계 규칙대로 git fetch --tags 먼저
1009 links from 194 files → docs/investigations/2026-10-doc-map.csv
0 do not resolve
$ git checkout docs/investigations/2026-10-doc-map.csv   # CSV 는 C 갈래만 커밋 (계획서 규칙)

정찰에 쓴 명령: doc-map CSV 를 파일별로 걸러 들어오는/나가는 링크 세기, git grep 으로 백틱 언급까지 찾기, 한글이 든 추적 파일 전수 조사, .github/workflows/* 트리거 읽기, release.py 의 bump_changelog · changelog_section · cmd_cut 읽기, web/src/lib/firmware/builderRev.ts 가 해시하는 파일 확인.

실행법

계획서만 있는 PR 이라 돌릴 것이 없다. 읽을 곳: docs/investigations/2026-10-cleanup-step1-plan.md 맨 위 「The lanes」 표 — 총괄이 이 표의 PR 한 줄씩을 빈 시트에 맡기면 된다(A1 · B1 · C1 은 지금 동시에).

가정

• 계획서는 영어로 썼다 — docs/investigations/ 의 다른 기록(0단계 baseline 포함)이 영어다.
• RFC §2.11 의 브랜치 이름(cleanup/1-…)·세 줄 PR 본문 대신 hub 의 브랜치·본문 규칙을 따르게 했다(D4). RFC 의 세 줄은 본문의 한 절로 넣는다.
• 300줄 제한은 「그대로 옮긴 글은 증명하면 세지 않는다」로 읽었다(D3) — 안 그러면 CHANGELOG 나누기(약 920줄 복사)가 PR 하나로 안 된다.
• 지도 문서는 A 가 가지고, B 가 바꿀 한 문장은 C3 가 넣는다 — 「파일 안 겹치게」를 지키려고. 그동안 docs/README.md 52줄이 잠깐 옛말이 된다.
• 갈래가 셋이라 사람도 최대 셋, 갈래 안 PR 은 차례대로 — 처음에 열리는 정리 PR 은 셋(§2.11 의 다섯 개 한도 안).
• rfc-cleanup-progress.md 표에 계획서 링크 한 줄을 넣었다(「Entries are added by whoever merges」지만 0단계 PR 도 이 파일을 고쳤다).
• 계획서 안 문장은 RFC §2.10 말투(첫 줄에 「이 문서는」 없음, 금지 단어 없음)에 맞추려 했다.

Changelog

Docs

• Cleanup step 1 is planned. docs/investigations/2026-10-cleanup-step1-plan.md cuts the step into three lanes that share no file (root moves, the changelog split, the ko/en parity list), lists what the RFC did not know about the tree (docs/releases/ already exists; the ko/en pairs it names do not), and asks the maintainer five more questions, each with a default.

🤖 Generated with Claude Code

https://claude.ai/code/session_01EBqghsXippKV7Bj3UPRY1a