[patternflow-bot]

ops / https://claude.ai/code/session_01L168ciWZem8FXxu8ojTYhr

사람이 읽는 레포 지도 세 장을 3단계가 바꾼 트리에 맞췄다. docs/REPOSITORY.md 에 shared/ 줄이 생기고, web/ARCHITECTURE.md 는 하네스의 상수가 shared/constants.json 에서 온다는 것과 갤러리 키가 낡은 키가 아니라 지금 쓰는 키라는 것을 말하고, firmware/README.md 의 패널 드라이버 안내는 UPSTREAM.md 와 패치를 가리킨다. 머지하면 지도를 따라간 사람이 상수와 드라이버 고침을 제자리에서 찾는다.

좋아지는 것: 없음

할 일

• 계획표 PR 26 줄과 세부(k26) 읽기
• 먼저 머지돼야 할 PR 4·7·9·11 이 dev 에 있는지 확인 ([DONE] 정리 3단계 PR 4 — Pattern Lab 의 7월 저장 키 셋이 누가 언제 썼는지 주석으로 말한다 #41·[DONE] 정리 3단계 PR 7 — 펌웨어와 사이트가 같이 쓰는 값이 한 파일에 모이고, 낡으면 CI 가 빨개진다 #45·[DONE] 정리 3단계 PR 9 — 사이트가 패널 크기와 한 바퀴 클릭 수를 펌웨어와 같은 한 파일에서 읽는다 #53·[DONE] 정리 3단계 PR 11 — 패널 드라이버가 원래 라이브러리와 다른 줄이 패치 한 장에 다 적힌다 #47)
• 표가 적은 세 파일만 고치기 (+10 −6 줄)
• 검사 돌리기 (voice·human-lock·링크·drift·doc-map·typecheck·lint·check:ci)
• CI 의 펌웨어 다섯 빌드 확인
• dev merge (이미 최신) 뒤 [DONE]

한 일

• docs/REPOSITORY.md: 맨 위 표에 shared/ 줄을 web/ 바로 뒤에 넣었다. constants.json 이 무엇을 담는지, npm run gen:shared 가 core_shared.h 와 constants.ts 를 쓰고 둘은 손으로 고치지 않는다는 것, check:shared 가 낡은 사본을 잡는다는 것, 7월 31일까지 랩이 한 바퀴를 20칸으로 셌던 일이 이 폴더의 까닭이라는 것. 「Start at」은 constants.json 링크.
• web/ARCHITECTURE.md 59줄(하네스): 끝에 두 문장을 더했다. 24 가 이제 src/lib/shared/constants.ts 에서 오고 패널 크기와 손잡이 수도 그렇다, 그 파일은 npm run gen:shared 가 shared/constants.json 에서 쓰고 펌웨어 core_shared.h 도 같은 곳에서 나온다.
• web/ARCHITECTURE.md 80줄(저장): 「legacy v1 draft/gallery keys」를 고쳤다. 갤러리는 patternflow_lab_gallery_v1 이 지금도 쓰는 키이고 legacyDraft.ts 가 읽고 쓴다. 7월 27일 Pattern Lab v2 부터 안 쓰는 건 초안과 램프 키이고, 프로젝트가 안 살아날 때 serialize.ts 의 migrateLegacyDraft 가 읽어 프로젝트로 올린다. PR 4 가 legacyGallery 를 gallery 로 바꾼 것과 맞춘 것이다.
• firmware/README.md 158–162줄: 덧붙인 것 둘(resumeDMAoutput(), 밝기 훅)을 세는 대신 UPSTREAM.md(원래 태그·커밋과 그 뒤 가져온 커밋)와 patternflow.patch(바꾼 줄 전부), VENDORED.md(까닭)를 가리키고, src/hub75/ 를 고치면 패치는 UPSTREAM.md 의 명령으로 다시 만든다고 적었다. 「설치·클론한 사본은 헤더만 맞추면 된다」는 그대로 뒀다.

증거

• npm run check:voice → read: 10 added lines in 3 files / check:voice: nothing found
• npm run check:human-lock → this diff touches 0 locked files / no locked words changed
• python3 .github/scripts/check_links.py → all 709 relative links resolve
• npm run check:drift → bom·bom-schematic·changelog·editions·features·links-absolute·markers·presets·shared 통과, roadmap 은 gh 가 engmung/Patternflow 를 못 읽어 건너뜀(CI 에선 돈다)
• git fetch --tags 뒤 npm run doc-map → 1095 links from 217 files / 0 do not resolve, 1366 Korean/English pairs / 7 en-short, 18 ko-short, 1 missing-ko, 1340 ok. 이 PR 몫은 새 행 셋(docs/REPOSITORY.md → shared/constants.json, firmware/README.md → src/hub75/UPSTREAM.md·VENDORED.md)이고 다 닿는다. 두 CSV 는 되돌렸다(PR 27 몫).
• §2.1(1): npm run typecheck exit 0, npm run lint -- --max-warnings=0 exit 0, npm run check:ci exit 0(check:panels 의 vitest 35 passed / 478 passed, check:sandbox-sync, check:modcache 포함). build.sh all 은 컨테이너에 PlatformIO 가 없어 이 PR 의 firmware-build.yml 로 갈음했다. default·audio·performance·clock·midi 다섯 다 success.

실행법

web/ 에서 npm ci 뒤 위 npm 명령을 그대로. check_links.py 는 레포 뿌리에서.

가정

• 표에 적힌 세 파일만 고쳤다. firmware/README.md 의 프로젝트 트리(208줄 hub75/ … see their VENDORED.md)와 936줄의 resumeDMAoutput() 안내는 지금도 맞아서 두었고, 계획서도 158–162줄만 꼽았다.
• 하네스 문장은 59줄 항목 끝에 붙였다. 앞에 넣으면 바로 뒤 「public/pattern-sandbox.html is built from it」의 it 이 하네스가 아닌 것을 가리키게 된다. 61줄 controls.ts 의 「shared with the firmware」는 PR 9 뒤에도 맞아서 두었다.
• 드라이버 안내에서 덧붙인 것 둘을 이름으로 세던 구절은 뺐다. 계획서 finding 8 이 그렇게 세는 주석이 이미 낡았다고 했고, PR 11 이 VENDORED.md 와 코어 주석을 패치를 가리키게 바꾼 것과 같은 방식이다.
• 업스트림 HEAD 를 클론하는 사본 이야기는 질문 21 의 기본값(이번 단계에선 안 지운다)대로 남겼다.
• shared/ 줄은 web/ 뒤에 두었다. PR 25 가 AGENTS.md 지도에 둔 자리와 같다.
• CHANGELOG.md 는 고치지 않았다(머리말·계획서대로). 넣을 줄은 아래.

Changelog

Docs

• The repository maps catch up with step 3. docs/REPOSITORY.md has a top-level row for shared/. web/ARCHITECTURE.md says the pattern harness takes its constants from shared/constants.json, and calls patternflow_lab_gallery_v1 the live gallery key instead of a legacy one. firmware/README.md sends readers of its vendored HUB75 note to UPSTREAM.md and patternflow.patch instead of naming two additions.

Upstream

• What: docs/REPOSITORY.md gets a top-level row for shared/. web/ARCHITECTURE.md names shared/constants.json as the harness constants' source and the live gallery key, and firmware/README.md points its HUB75 note at UPSTREAM.md and the patch.
• Checks: npm run typecheck, npm run lint, npm run check:ci (with check:panels), npm run check:human-lock and npm run check:voice pass; firmware-build.yml built all five compositions on the PR.
• Docs map: three new rows, all resolve: docs/REPOSITORY.md to shared/constants.json, and firmware/README.md to UPSTREAM.md and VENDORED.md in firmware/patternflow/src/hub75/.

🤖 Generated with Claude Code

https://claude.ai/code/session_01L168ciWZem8FXxu8ojTYhr