[DONE] 정리 3단계 PR 25 — 에이전트 안내서가 shared/·포크의 두 파일·새 명령을 안다

[patternflow-bot]

lsh / https://claude.ai/code/session_0144SDTMrY4Z14sCKC1PgVrT

AGENTS.md 의 레포 지도와 명령 목록에 3단계가 더한 것을 적었다. shared/constants.json 과 거기서 생기는 두 파일, 패널 드라이버의 UPSTREAM.md 와 patternflow.patch, 그리고 gen:shared·check:shared·lint 문턱·markers 검사다. 머지하면 에이전트가 상수는 JSON 한 곳에서 고치고, 패치는 손으로 고치지 않고 다시 만든다는 걸 처음부터 안다.

좋아지는 것: 없음

할 일

• 계획표 PR 25 줄과 세부(k25) 읽기
• 먼저 머지돼야 할 PR 3·7·11 이 dev 에 있는지 확인 ([DONE] 정리 3단계 PR 3 — 사이트 lint 경고가 하나라도 새로 생기면 CI 가 빨개진다 #43·[DONE] 정리 3단계 PR 7 — 펌웨어와 사이트가 같이 쓰는 값이 한 파일에 모이고, 낡으면 CI 가 빨개진다 #45·[DONE] 정리 3단계 PR 11 — 패널 드라이버가 원래 라이브러리와 다른 줄이 패치 한 장에 다 적힌다 #47)
• AGENTS.md 고치기 (그 파일만, +5 −2 줄)
• 검사 돌리기 (check_versions·drift·human-lock·voice·doc-map)
• dev merge (이미 최신) 뒤 [DONE]

한 일

• 레포 지도 firmware/ 줄: core_display.h 가 쓰는 src/hub75/ 가 ESP32-HUB75-MatrixPanel-DMA 3.0.13 을 들여온 것이고, UPSTREAM.md 가 원래 커밋과 그 뒤 가져온 커밋을, patternflow.patch 가 바꾼 줄 전부를 담는다고 적었다. src/hub75/ 를 고치면 패치는 UPSTREAM.md 의 명령으로 다시 만든다(원래 라이브러리 줄 끝 공백을 편집기가 지우면 패치가 깨진다).
• 레포 지도에 shared/ 줄을 새로 넣었다. constants.json 이 무엇을 담는지, 거기서 생기는 core_shared.h(PF_SHARED_ 접두)와 constants.ts 는 손으로 고치지 않는다는 것, 7월 31일까지 랩이 한 바퀴를 20칸으로 셌던 일이 이 폴더의 까닭이라는 것.
• 「Common commands」에 두 줄: lint·typecheck(CI 는 --max-warnings=0, 예외는 eslint-disable-next-line 에 -- 뒤 까닭), 공유 상수(gen:shared 뒤 두 파일 커밋, check:shared 가 생성 못 하는 두 사본 abi/pf_params.h 의 1000 과 build_module.py 의 128·64 까지 읽는다).
• 드리프트 줄: check:<name> 목록에 shared 를 더하고, npm 스크립트가 없는 markers 는 npx tsx scripts/drift.ts markers 로 따로 돈다고 적었다.

증거

• python3 firmware/toolchain/check_versions.py → versions agree: core v3.11.0, audio v0.7.0, performance v0.4.0 … (AGENTS.md 를 읽는 검사, 계획서가 이 PR 에 돌리라고 한 것)
• npm run check:voice → read: 5 added lines in 1 file / check:voice: nothing found
• npm run check:human-lock → this diff touches 0 locked files / no locked words changed
• npm run check:drift → bom·bom-schematic·changelog·editions·features·links-absolute·markers·presets·shared 통과, roadmap 은 gh 로그인이 없어 건너뜀(CI 에선 돈다)
• git fetch --tags 뒤 npm run doc-map → 1088 links from 217 files / 0 do not resolve, 1366 Korean/English pairs / 7 en-short, 18 ko-short, 1 missing-ko, 1340 ok. AGENTS.md 에서 나온 행은 바뀌지 않았다(새 16행은 앞 PR 들이 더한 파일 몫). 두 CSV 는 되돌렸다.
• firmware/·web/src/ 를 건드리지 않아 §2.1(1) 의 다섯 명령은 해당 없음.

실행법

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

가정

• 계획서 세부가 이 PR 에 꼽은 넷(shared/, 포크의 두 파일, gen:shared, lint 문턱)에 더해 check:shared 와 markers 검사를 한 줄씩 넣었다. 표의 「the new commands」에 3단계가 새로 만든 명령이 다 들어간다고 봤다. 둘 다 AGENTS.md 안이고 다른 PR 과 파일이 겹치지 않는다.
• shared/ 는 지도에서 web/ 바로 뒤에 두었다. 두 생성 파일이 펌웨어와 사이트에 하나씩 있어 둘 다 지난 뒤가 읽기 쉽다.
• 「Common commands」의 공유 상수 줄과 지도의 shared/ 줄은 나눴다. 지도는 무엇이 있나, 명령 줄은 고칠 때 무엇을 돌리나.
• CHANGELOG.md 는 고치지 않았다(머리말·계획서대로). 넣을 줄은 아래.

Changelog

Docs

• AGENTS.md names shared/, the HUB75 driver's UPSTREAM.md and patternflow.patch, and the commands step 3 added. The repository map has shared/constants.json and the two files generated from it, and says the patch is rebuilt with the command in UPSTREAM.md, never edited by hand. Common commands gain gen:shared with check:shared, the lint gate (--max-warnings=0, an exception with its reason after --), and the markers drift check.

Upstream

• What: AGENTS.md gets shared/ in its repository map, the vendored HUB75 driver's UPSTREAM.md and patternflow.patch, and npm run gen:shared, check:shared, the lint gate and the markers check under Common commands.
• Checks: check_versions.py, npm run check:drift, npm run check:human-lock and npm run check:voice pass; nothing under firmware/ or web/src/ changes, so the five section 2.1 commands do not apply.
• Docs map: none

🤖 Generated with Claude Code

https://claude.ai/code/session_0144SDTMrY4Z14sCKC1PgVrT