[DONE] 행동 강령·보안·지원 안내는 .github/ 로, 오디오 가이드는 docs/ 로 옮겨 루트가 한눈에 읽힌다

[patternflow-bot]

studio / https://claude.ai/code/session_01UiNXfT3BJwA4V6Ht8ZULZN

메인테이너 답 1대로 CODE_OF_CONDUCT·SECURITY·SUPPORT 를 .github/ 로, AUDIO_GUIDE 를 docs/ 로 옮겼다. 옮긴 파일 안에서는 링크 경로만 고쳤고 글은 그대로다. 레포 안 링크, 이슈 선택 화면의 지원 링크, 사이트의 오디오 가이드 링크도 새 경로를 가리킨다. 머지하면 루트에는 메인테이너가 정한 12개 파일만 남는다. GitHub 은 .github/ 에 있는 세 파일도 그대로 찾고, 바깥에서 옛 루트 경로로 건 링크만 끊긴다.

좋아지는 것: 없음

할 일

• 계획서 표 PR A2 · rfc-cleanup §2.13 답 1 읽기
• git mv: CODE_OF_CONDUCT.md·SECURITY.md·SUPPORT.md → .github/, AUDIO_GUIDE.md → docs/
• 옮긴 파일 안의 상대 링크(<img src> 포함)를 새 폴더 기준으로. 글은 그대로
• 들어오는 링크: README.md(5), CONTRIBUTING.md(2), docs/README.md, docs/REPOSITORY.md, firmware/README.md, tools/patternflow-audio-extension/README.md, .github/ISSUE_TEMPLATE/config.yml(절대 URL), features-data.ts, guide/copy/audio.ts(2 + 주석)
• 백틱 언급: AGENTS.md(저장소 지도) · docs/README.md(규칙의 루트 가이드 목록, Walk-throughs 한 줄) · docs/REPOSITORY.md(root·docs/·.github/ 줄, 「Put sound into it」, 바깥 링크 목록)
• 그대로 둔 것: CHANGELOG.md 의 언급 5곳(기록), 계획서·RFC 의 언급
• 검사: check_links.py · npm run doc-map(CSV 버림) · check_versions.py · console_pages.py check · build_audio_in_page.py --check · check_boundaries.py · web typecheck·lint·check:panels·check:ci
• 기준 브랜치(dev) merge: [DONE] 뒤 dev 에 C1([DONE] 한국어·영어 짝 문서가 서로 맞는지 표 하나로 본다 #15)·C2([DONE] 문서 지도가 이슈 양식의 링크까지 본다 #17)가 들어와 25c879d 로 merge, 충돌 없음. 들어온 건 web/scripts/doc-map.ts 와 CSV 둘뿐이라 이 PR 의 web/src 검사는 그대로 유효. 링크 검사·doc-map 은 다시 돌림(아래)
• head 25c879d GitHub CI 9개 모두 success (펌웨어 다섯 조합 포함). 앞 head ac1e811 도 같았다

한 일

• 옮김. git 이 네 개 모두 rename 으로 본다(아래 stat). 옮긴 파일 안에서 바뀐 줄은 링크 대상 경로뿐이다. .github/ 의 세 파일은 docs/…·BUILD_GUIDE.md·CONTRIBUTING.md → ../…, 서로 가리키는 SECURITY.md 는 같은 폴더라 그대로. docs/AUDIO_GUIDE.md 는 docs/X → X, 나머지(tools/·firmware/·integrations/·루트 가이드·AGENTS.md) → ../…. 링크 글자([docs/osc-spec.md] 같은 것)는 A1 처럼 두었다.
• 사이트. features-data.ts 의 「Audio guide」와 Audio 가이드 끝 링크(영어·한국어 두 곳)를 …/blob/main/docs/AUDIO_GUIDE.md 로 옮겼다. audio.ts 머리 주석의 출처 목록도 새 경로로 쓰고 줄만 다시 나눴다. 링크 이름(「AUDIO_GUIDE.md」)은 그대로다.
• 지도. AGENTS.md: 루트 가이드 목록에서 빼고 docs/ 설명에 AUDIO_GUIDE.md (sound into the panel) 를 같은 꼬리표로 넣었다. docs/README.md: 규칙 괄호의 루트 가이드 목록에서 빼고, Walk-throughs 맨 위에 목록 한 줄. 「On the site」 문단의 「the guides in the root」는 「the written guides」로 고쳤다(오디오 가이드가 루트를 떠나서 틀린 말이 되어서). docs/REPOSITORY.md: root 줄은 「the three guides」로 하고 세 파일을 빼서 .github/ 줄로, docs/ 줄에 「the audio guide」, 바깥 링크 목록에서는 docs/AUDIO_GUIDE.md 를 docs/ 줄로 옮겼다.

증거

$ git diff -M --stat origin/dev        # dev 7c2570b merge 뒤
 CODE_OF_CONDUCT.md => .github/CODE_OF_CONDUCT.md |  2 +-
 .github/ISSUE_TEMPLATE/config.yml                |  2 +-
 SECURITY.md => .github/SECURITY.md               |  2 +-
 SUPPORT.md => .github/SUPPORT.md                 |  4 +-
 AGENTS.md                                        |  2 +-
 CONTRIBUTING.md                                  |  2 +-
 README.md                                        | 10 ++---
 AUDIO_GUIDE.md => docs/AUDIO_GUIDE.md            | 52 ++++++++++++------------
 docs/README.md                                   |  7 ++--
 docs/REPOSITORY.md                               | 12 +++---
 firmware/README.md                               |  2 +-
 tools/patternflow-audio-extension/README.md      |  2 +-
 web/src/app/features/features-data.ts            |  2 +-
 web/src/components/guide/copy/audio.ts           | 11 ++---
 14 files changed, 57 insertions(+), 55 deletions(-)

$ git ls-files | grep -v / | grep -v '^\.'      # 루트
AGENTS.md BUILD_GUIDE.md CHANGELOG.md CITATION.cff CLAUDE.md CONTRIBUTING.md
FEATURE_GUIDE.md LICENSE LICENSE-CC-BY-SA LICENSE-MIT PATTERN_GUIDE.md README.md

$ python3 .github/scripts/check_links.py
all 635 relative links resolve

$ git fetch --tags && (cd web && npm run doc-map)        # 28 tags, dev merge 뒤 (C2 로 .yml 도 읽는다)
1017 links from 198 files → docs/investigations/2026-10-doc-map.csv
0 do not resolve
1366 Korean/English pairs → docs/investigations/2026-10-doc-parity.csv
$ grep config.yml docs/investigations/2026-10-doc-map.csv
.github/ISSUE_TEMPLATE/config.yml,.github/SUPPORT.md,absolute-blob,,yes
.github/ISSUE_TEMPLATE/config.yml,CONTRIBUTING.md,absolute-blob,,yes
$ git checkout docs/investigations/2026-10-doc-map.csv   # lane C commits the map (parity CSV 는 바뀌지 않음)

$ 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

$ python3 firmware/toolchain/console_pages.py check      # console-sync.yml 가 tools/patternflow-audio-extension/** 에 걸려서
all 12 console headers match their HTML, stamped with chrome h=efffd505; all 14 gzip twins decompress to their literals
$ python3 firmware/toolchain/build_audio_in_page.py --check
console/audio-in.html is what its sources assemble to: 56343 bytes, 17217 gzip -9 as the panel sends it (budget 17500, 283 spare; ...)
$ python3 firmware/toolchain/check_boundaries.py
boundary holds: 73 core files know none of 42 feature namespaces across 9 features

# web/  (dev merge 는 web/src 를 건드리지 않아 그대로 유효)
$ 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
 Test Files  35 passed (35)
      Tests  478 passed (478)
$ npm run check:ci       → exit 0, last line: All module cache checks passed.

• head 25c879d 의 GitHub CI: check run 9개(check ×3, build, 펌웨어 default·audio·performance·clock·midi) 모두 success. firmware/README.md 가 firmware-build.yml 을 돌려서, 이 컨테이너에서 못 돌리는 build.sh all(PlatformIO 없음, 기준선과 같음)의 기록은 이 CI 다. 바뀐 펌웨어 파일은 Markdown 하나뿐이다.
• .pfm 캐시 키는 움직일 수 없다: abi/·src/·툴체인 파일을 하나도 건드리지 않았다(check:ci 의 module cache 검사도 통과).

정리 기록 (RFC §2.11)

• 옮긴 것: CODE_OF_CONDUCT.md·SECURITY.md·SUPPORT.md → .github/, AUDIO_GUIDE.md → docs/AUDIO_GUIDE.md
• §2.1 명령: check_links.py, npm run doc-map, check_versions.py, web check:ci·check:panels·typecheck·lint. build.sh all 은 CI 의 firmware-build.yml 이 기록(펌웨어 무변경, firmware/README.md 만)
• doc-map 행 (dev 에서 만든 맵과 비교): 옮긴 파일에서 나가는 37행은 출처 열만 새 경로로 바뀌고 대상·종류·anchor·resolves 는 그대로(SECURITY.md 를 가리키는 2행은 대상도 함께 옮김). 들어오는 10행은 대상이 새 경로로(CONTRIBUTING.md 2, README.md 2, docs/README.md, docs/REPOSITORY.md, firmware/README.md, 확장 README, features-data.ts, audio.ts). 새 행 1개(docs/README.md → docs/AUDIO_GUIDE.md). C2 가 들어온 뒤로는 config.yml → .github/SUPPORT.md 행 1개도 대상이 새 경로다. 그 밖의 행 변화 없음. 전부 yes.

for another lane

• C3 또는 메인테이너: docs/README.md 첫 문단과 docs/REPOSITORY.md 의 규칙 「a guide somebody follows start to finish lives at the repository root」는 이제 예외가 하나 있다(docs/AUDIO_GUIDE.md). 규칙 문장을 다시 쓰는 건 새 글이라, 답 6대로 docs/voice.md 가 머지된 뒤로 남겼다. 이 PR 은 괄호 안의 목록만 고쳤다.
• C3: 맵을 다시 만들면 위 행들이 들어간다.

실행법

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

가정

• 계획서 A2 표에 있는 파일만 고쳤다. AUDIO_GUIDE.md 가 옮겨 가서 표의 조건부 파일 넷(firmware/README.md, 확장 README, features-data.ts, audio.ts)도 고쳤다. git grep 으로 찾은 언급은 모두 이 목록 안에 있었다. CHANGELOG.md·docs/rfc-cleanup-progress.md 는 건드리지 않았다.
• 계획서 D5 는 세 파일을 docs/ 로 보낸다고 했지만, 메인테이너 답 1은 .github/ 다. 답을 따랐다. GitHub 은 이 세 파일을 루트·docs/·.github/ 어디서나 찾는다.
• 오디오 가이드는 이름을 바꾸지 않고 docs/AUDIO_GUIDE.md 로 옮겼다. 답 1은 「docs/ 로」만 말하고, 이름까지 바꾸면 이동이 아니라 rename 이 된다.
• 답 6(docs/voice.md 머지 전엔 글을 쓰는 1단계 PR 을 열지 않는다): 이 PR 은 옮김 PR 이고, 새로 넣은 글은 docs/README.md 의 목록 꼬리표 하나(「sound into the panel」, AGENTS.md 에 이미 있던 말)와 docs/REPOSITORY.md 의 「the audio guide」 같은 이름표뿐이다. 「the guides in the root」 → 「the written guides」는 옮김 때문에 틀려진 말을 맞춘 것이다.
• 사이트 링크는 원래 레포(engmung/Patternflow) main 을 가리킨다. 이 이동이 원래 레포 main 에 들어가는 순간 새 경로가 맞게 되고, 그 전까지는 옛 경로가 아직 있다. A1 과 같다.
• 리다이렉트는 없다: 옛 경로를 가리키는 사이트 경로가 없고, github.com 링크는 next.config.ts 가 돌릴 수 없다. 바깥에서 blob/main/AUDIO_GUIDE.md·blob/main/SUPPORT.md 로 건 링크(원래 레포 릴리스 본문 등)는 끊긴다. 원래 레포 릴리스 본문은 이 세션 권한 밖이라 확인하지 못했다.
• 라벨 cleanup·step-1(D4)은 포크에 없어 붙이지 않았다(A1 과 같음).
• 작업 지시대로 CHANGELOG.md 는 고치지 않았다. 넣을 줄은 아래에 있다.

Changelog

Docs

• The community files moved to .github/ and the audio guide to docs/. CODE_OF_CONDUCT.md, SECURITY.md and SUPPORT.md are now in .github/, where GitHub still finds them for the community profile and the security tab, and AUDIO_GUIDE.md is docs/AUDIO_GUIDE.md. Every link to them in the repository, the issue chooser and the site points at the new paths. Links from outside to the old root paths break, since GitHub serves no redirect for a moved file.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UiNXfT3BJwA4V6Ht8ZULZN