[DONE] 옛 v2 조립 가이드를 docs/legacy/ 로 옮겨 루트에서 한 장 덜어낸다

[patternflow-bot]

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

루트에 있던 옛 v2 보드 조립 가이드를 정리 1단계 계획서의 A1 그대로 docs/legacy/ 로 옮겼다(메인테이너 답 1도 같은 자리). 가이드 안의 사진·링크 경로만 새 깊이로 고쳤고 글은 한 글자도 바꾸지 않았다. 이 파일을 가리키던 레포 안 링크 다섯 곳, 사이트의 v2 링크와 그 시험, AGENTS.md 같은 지도 문서의 언급도 모두 새 경로를 가리킨다. 머지하면 루트 파일이 하나 줄고, 바깥에서 옛 루트 경로로 건 링크만 끊긴다(계획서 D6 대로 리다이렉트는 없다).

좋아지는 것: 없음

할 일

• git mv BUILD_GUIDE_v2.md docs/legacy/BUILD_GUIDE_v2.md
• 옮긴 파일 안의 상대 링크(<img src>·<video src> 포함)를 새 깊이로. 글은 그대로
• 들어오는 Markdown 링크(5개 파일) · BuildPanel.tsx 사이트 링크 · BuildPanel.test.tsx 기대 href
• 백틱 언급: AGENTS.md(지도·규칙 5) · docs/README.md(규칙의 루트 가이드 목록에서 빼고 legacy/ 한 줄) · docs/REPOSITORY.md(root 줄·docs/ 줄) · layout.ts 주석
• 그대로 둔 것 확인: roadmap-data.ts 의 detail/detailKo · CHANGELOG.md · docs/releases/v3.0.0.md 의 v3.0.0: 태그 링크
• 검사: check_links.py · npm run doc-map(CSV 버림) · git diff -M --stat · web check:ci·check:panels·typecheck·lint · check_versions.py
• 기준 브랜치(dev) merge: 메인테이너 답을 적은 4888d27(docs/rfc-cleanup.md 만)을 merge, 충돌 없음. 그 뒤 검사 다시 돌림
• 새 head aea139a CI 초록

한 일

• 옮김. BUILD_GUIDE_v2.md → docs/legacy/BUILD_GUIDE_v2.md. git 이 rename 으로 본다(아래 stat). 바뀐 28줄은 모두 링크 대상 경로뿐이다: docs/… → ../…(이미지 22개 포함), BUILD_GUIDE.md·firmware/…·hardware/… → ../../…. 링크 글자([docs/assembly/README.md] 같은 것)는 계획서의 「No word changes」 대로 두었다.
• 들어오는 링크. BUILD_GUIDE.md(1), README.md(2), docs/assembly/README.md(2), hardware/README.md(1), hardware/case/README.md(2). hardware/README.md 의 링크 글자는 그 파일 기준 상대 경로 자체라(옆의 ../BUILD_GUIDE.md 와 같은 꼴) 대상과 함께 고쳤다.
• 사이트. BuildPanel.tsx 의 v2 링크 → …/blob/main/docs/legacy/BUILD_GUIDE_v2.md. BuildPanel.test.tsx 는 계속 그 링크를 검사하고 기대 경로만 옮겼다.
• 언급. AGENTS.md: 저장소 지도에서 루트 가이드 목록에서 빼고 docs/ 설명에 docs/legacy/BUILD_GUIDE_v2.md 를 넣었다. 규칙 5는 「docs/legacy/BUILD_GUIDE_v2.md section 10」. docs/README.md: 규칙의 루트 가이드 목록에서 빼고 「Building it」에 목록 한 줄(「the build guide for the legacy v2.x board」). docs/REPOSITORY.md: root 줄은 「the four guides」, docs/ 줄에 legacy/. layout.ts: 주석이 새 경로를 이름으로 쓴다(주석 줄바꿈만).

증거

$ git diff -M --stat origin/dev        # dev 4888d27 merge 뒤
 AGENTS.md                                          |  4 +-
 BUILD_GUIDE.md                                     |  2 +-
 README.md                                          |  4 +-
 docs/README.md                                     |  3 +-
 docs/REPOSITORY.md                                 |  4 +-
 docs/assembly/README.md                            |  4 +-
 BUILD_GUIDE_v2.md => docs/legacy/BUILD_GUIDE_v2.md | 56 +++++++++++-----------
 hardware/README.md                                 |  2 +-
 hardware/case/README.md                            |  4 +-
 web/src/components/guide/stage/build/layout.ts     |  6 +--
 web/src/components/sections/BuildPanel.test.tsx    |  2 +-
 web/src/components/sections/BuildPanel.tsx         |  2 +-
 12 files changed, 47 insertions(+), 46 deletions(-)

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

$ git fetch --tags && (cd web && npm run doc-map)      # 28 tags
1010 links from 194 files → docs/investigations/2026-10-doc-map.csv
0 do not resolve
$ git checkout docs/investigations/2026-10-doc-map.csv   # lane C commits the map

$ python3 firmware/toolchain/check_versions.py
versions agree: core v3.11.0, audio v0.7.0, performance v0.4.0 - in net_config.h, the overrides, AGENTS.md, the manifest and the /editions cards, images on the shelf; try-out images: clock-v0.1.5, midi-v0.1.0

# web/  (merge 와 마지막 커밋은 web/ 을 건드리지 않아 그대로 유효)
$ npm run typecheck      → exit 0, tsc --noEmit prints nothing
$ npm run lint           → exit 0, ✖ 12 problems (0 errors, 12 warnings)   # step 0 기준선과 같은 12개, 이 PR 파일엔 없음
$ npm run check:panels   → exit 0
 ✓ src/components/sections/BuildPanel.test.tsx (15 tests)
 Test Files  35 passed (35)
      Tests  478 passed (478)
$ npm run check:ci       → exit 0, 25 suites, last line: All module cache checks passed.

• head aea139a 의 GitHub CI: check run 3개(build, check, check) 모두 success. 앞 head ca0ec7b 도 같았다.
• build.sh all 은 해당 없음: firmware/ 아래 바뀐 파일이 없다.
• 옛 경로가 남은 곳(git grep BUILD_GUIDE_v2): CHANGELOG.md, roadmap-data.ts 의 잠긴 detail/detailKo, docs/releases/v3.0.0.md 의 태그 링크, 계획서·RFC·기준선·doc-map CSV. 모두 계획서가 그대로 두라고 한 기록이다.

정리 기록 (RFC §2.11)

• 옮긴 것: BUILD_GUIDE_v2.md → docs/legacy/BUILD_GUIDE_v2.md
• §2.1 명령: check_links.py, npm run doc-map, check_versions.py, web check:ci·check:panels·typecheck·lint. build.sh all 은 해당 없음(펌웨어 무변경)
• doc-map 행: 옮긴 파일에서 나가는 34행(상대 31)은 출처 열만 docs/legacy/BUILD_GUIDE_v2.md 로 바뀌고 대상·resolves 는 그대로. 들어오는 7행(BUILD_GUIDE.md, README.md, docs/assembly/README.md, hardware/README.md, hardware/case/README.md, BuildPanel.tsx, BuildPanel.test.tsx)은 대상이 새 경로로 바뀜. 새 행 1개(docs/README.md → docs/legacy/BUILD_GUIDE_v2.md). 전부 yes.

for another lane

없음. C3 참고: 다시 만든 맵에는 이 PR 과 무관한 행 2개가 더 보인다(2026-10-cleanup-step1-plan.md → rfc-cleanup.md, rfc-cleanup-progress.md → 2026-10-cleanup-step1-plan.md). #12 가 커밋된 맵보다 늦게 들어와서이고, C3 가 맵을 다시 만들면 들어간다. A2 참고: 메인테이너 답 1로 AUDIO_GUIDE.md 가 docs/ 로 가니, docs/README.md 첫 문단의 루트 가이드 목록과 docs/REPOSITORY.md root 줄의 「the four guides」도 A2 가 같이 고친다.

실행법

python3 .github/scripts/check_links.py
git fetch --tags && (cd web && npm ci && npm run doc-map) && git checkout docs/investigations/2026-10-doc-map.csv
cd web && npm run check:ci && npm run check:panels && npm run typecheck && npm run lint

가정

• 계획서 A1 표에 있는 파일만 고쳤다. 다른 갈래 파일은 건드리지 않았다.
• 메인테이너 답 6은 「docs/voice.md 가 머지되기 전에는 글을 쓰는 1단계 PR 을 열지 않는다」고 한다. 이 PR 은 그 답보다 먼저 열린 옮김 PR 이다. 새로 쓴 글이 되지 않게, docs/README.md 에 넣은 한 줄을 처음 쓴 규칙 문장에서 다른 줄들과 같은 꼴의 목록 이름표로 줄였다. 나머지 고침은 경로·목록 이름뿐이다.
• 옮긴 가이드 안 링크 글자 중 루트 기준 경로처럼 생긴 것([docs/assembly/README.md], [firmware/CUSTOM_PATTERNS.md] 등)은 계획서의 「No word changes」 대로 남겼다. 루트에서 본 이름으로는 여전히 맞다.
• BuildPanel.tsx 의 링크는 원래 레포(engmung/Patternflow) main 을 가리킨다. 이 이동이 원래 레포 main 에 들어가는 순간 같이 맞게 된다. 사이트와 파일이 같은 커밋으로 움직이니 그 전까지 사이트 링크도 옛 경로(아직 존재)를 쓴다.
• D6(리다이렉트·스텁 없음): 이 포크에는 릴리스가 하나도 없다(list_releases → []). 원래 레포의 릴리스 본문은 이 세션 권한 밖이라 못 읽었다. 원래 레포 릴리스(특히 v3.0.x) 본문에 blob/main/BUILD_GUIDE_v2.md 링크가 있으면 메인테이너가 고칠 몫이다.
• docs/legacy/ 에 README 는 두지 않았다. 계획서는 docs/README.md 에 한 줄만 요구하고, 그 줄이 폴더를 설명한다.
• 라벨 cleanup·step-1(D4)은 포크에 없다. 새로 만드는 건 레포 전체 설정이라 붙이지 않았다.
• 작업 지시대로 CHANGELOG.md 는 고치지 않았다. 넣을 줄은 아래에 있다.

Changelog

Docs

• The v2 build guide moved to docs/legacy/BUILD_GUIDE_v2.md. Every link to it in the repository and the site's v2 board link point at the new path; links from outside to the old root path break, since GitHub serves no redirect for a moved file.

🤖 Generated with Claude Code

https://claude.ai/code/session_018UmbPuPgM9ey5Pn3etBwek