[DONE] BUILD_GUIDE 굽기 순서를 웹 가이드와 맞추고, README 의 Crowd Supply 캠페인을 「진행 중, 10월 15일 마감」으로 바로잡는다

[patternflow-bot]

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

BUILD_GUIDE 의 펌웨어 굽기(§7·§8.1)를 웹 가이드 01 굽기와 같은 순서로 다시 썼고, README 의 Crowd Supply 를 「목표를 넘겼고 10월 15일까지 진행 중」으로 바로잡았습니다. 머지하면 README·웹 가이드·BUILD_GUIDE 가 같은 순서(BOOT 누른 채 RST 먼저, 와이파이는 RST 뒤 한 번 더, 안 되면 핫스팟)를 말하고, 배지가 더는 캠페인이 끝난 것처럼 보이지 않습니다.

위 셋은 폰 폭(390)에서 찍었고, 왼쪽이 dev(bfc4b22), 오른쪽이 이 PR(e694298)입니다: ① BUILD_GUIDE §8·§8.1 단계 ② README 배지 · 「The device」 끝줄과 First light 머리 · Story so far 9·10월 줄 ③ BUILD_GUIDE §7 · §8.1 뒤 상자들. 셋 다 GitHub 가 그 커밋의 파일을 렌더한 HTML(article.markdown-body)을 그대로 쓴 것이고, 배지는 GitHub 의 이미지 프록시로 실제 그려진 모습입니다(github.githubassets.com 이 막혀 있어 스타일만 github-markdown-css 로 입혔습니다).

체크리스트

• dev 최신(bfc4b22, [DONE] 메인 README 한 번 더 — 독자별 비판 검토부터 하고 다시 다듬는다 #8 머지 뒤)에서 시작
• BUILD_GUIDE §7.4·§8.1 을 웹 Play 가이드 01 Flash(#flash-1~#flash-8)·Build 가이드 06·README First light 와 같은 순서로
• README: 배지·「Get one assembled」 줄·Story so far 를 「진행 중, 10월 15일 마감」으로, 히어로 영상은 그대로
• README First light 가 §8 을 같은 절차로 다시 가리킴
• BUILD_GUIDE 단계 번호를 인용하던 곳(Besoiobiy 리믹스 README) 맞춤, CHANGELOG [Unreleased] 기록 맞춤
• J4 전원만(USB-C 는 굽기·데이터로만), BOM·BUILD_GUIDE_v2.md 안 건드림, BUILD_GUIDE §10 은 그대로
• check_links.py 통과, 렌더 전후 스크린샷, 웹 copy·펌웨어 문자열과 대조한 사실 검토 1회 → 지적 반영

What — 한 일과 까닭

BUILD_GUIDE.md

1. §8.1 을 웹 가이드 순서로. 1 모듈만 왼쪽 포트·데이터 케이블 → 2 다운로드 모드 먼저(BOOT 누른 채 RST, BOOT 놓기 — 지우기 경고와 「이미 쓰는 보드는 Update 페이지로」) → 3 Flash Patternflow, USB JTAG/serial debug unit → 4 와이파이는 보통 안 나옴: 닫고 RST, 다시 Flash Patternflow, 포트, Connect to Wi-Fi(빈 스캔, 정확한 이름, 2.4 GHz; 바로 나오면 거기서) → 5 USB 빼고 보조배터리 뺀 채 꽂기(USB 표시 쪽, 44핀), J4 로 전원, Origin → 6 그래도 와이파이가 없으면 핫스팟: 15초 뒤 K2, CONNECTED/HOTSPOT patternflow-xxxx, 비밀번호 patternflow, http://192.168.4.1/, Wi-Fi 페이지, JOINED → 7 Basics 팩. 전엔 먼저 꽂고 굽기, BOOT+RST 는 「포트가 안 보일 때」였습니다.
2. §7 4단계: 「꺼진 채 꽂고 켜기」 → 「DevKit 은 아직 꽂지 않는다, 첫 전원은 §8.1 5단계」. 그래서 §7 제목은 Wiring(목차 줄도).
3. §8 머리: 「꺼내서 굽고 다시 꽂으면 끝」 → 「보드 밖에서 한 번, 그 뒤로는 와이파이로」.
4. 상자들: 🔍 는 「다운로드 모드 다시 → 케이블 → 드라이버 없음」과 USB 로 제자리 업데이트하는 길만, 📡 핫스팟 상자는 6단계가 됐으니 빼고 남은 정보(모드·비밀번호)는 📶 로.

README.md
5. 배지 Crowd Supply | Funded → Crowd Supply | funded, ends Oct 15.
6. 「Rather have one arrive assembled…」 끝에 「The campaign is past its goal and runs until 15 October 2026.」
7. Story so far 10월 줄 맨 앞에 「The Crowd Supply campaign, open until 15 October, reached 200% of its goal」. 9월 「met its funding goal」은 그때 사실이라 그대로.
8. First light 머리에 「[BUILD_GUIDE §8] is the same order in writing, with more on each step」.

그 밖
9. hardware/case/remixes/besoiobiy-printed/README.md: 「seat it … (section 7, step 4)」 → 「(section 8.1, step 5)」, 「Load the patterns (section 8.1, step 6)」 → step 7, 와이파이 없으면 step 6 한 줄.
10. CHANGELOG.md [Unreleased]: README 줄의 「the campaign reads funded」 → 「past its goal and open until 15 October」, 「BUILD_GUIDE.md … are as they were」 → v2 만, BUILD_GUIDE 줄 하나 추가.

Tested — 증거

• python3 .github/scripts/check_links.py → all 623 relative links resolve · 고친 네 파일만 → all 155 relative links resolve
• 앵커: #7-wiring, #8-firmware, #81-browser-flash-recommended 가 GitHub 렌더에 실제로 있음(user-content-… id 확인). 옛 #7-wiring--first-power-up 를 가리키는 곳은 레포에 없음(grep). 사이트가 거는 앵커(REPOSITORY.md: §1·§2·§4·§8·§8.2·§10)는 그대로.
• grep -c "—" README.md → 0 (README 의 em dash 없는 관례 유지)
• 펌웨어 문자열 대조: CONNECTED·CONNECTING(core_wifi.h:623), HOTSPOT, JOINED(core_hotspot.h:373), 비밀번호 patternflow, 15초 지연, Improv 스캔이 일부러 빈 목록.
• 핫스팟이 든 이미지: grep -c -a HOTSPOT web/public/flash/bin/*/patternflow.ino.bin → core-v3.11.0 8 · audio-v0.7.0 8 · performance-v0.4.0 8 · clock-v0.1.5 0 · midi-v0.1.0 0
• 사실 검토(새 눈 1회, 웹 copy·펌웨어·리믹스 README 대조): 막는 오류 없음. 지적 넷 반영 — 「card for card」(카드 8장 ↔ 단계 6개) → 「in the same order」, K2 를 15초에 누르면 아직 CONNECTING 일 수 있음 → 「Neither on K2 yet? Wait a few seconds and hold it again」, clock·MIDI try-out 이미지엔 핫스팟이 없음 → 📶 에 한 줄, 움직이는 숫자(200%)를 배지·본문에 두지 말 것(manifesto §12) → 아래 가정.
• 렌더: 커밋마다 github.com/…/blob/<SHA>/<파일> 의 GitHub 렌더 HTML 을 headless Chromium 으로 390 폭에서 찍음(위 그림).
• 이 포크는 GitHub Actions 가 돌지 않아 PR 체크가 없습니다([DONE] 웹 가이드 펌웨어 굽기·와이파이를 BOOT+RST 기본으로 고치고, 메인 README·문서를 정리한다 #7·[DONE] 메인 README 한 번 더 — 독자별 비판 검토부터 하고 다시 다듬는다 #8 과 같음).

실행법

GitHub 에서 이 브랜치의 파일을 열면 됩니다(폰으로도).

• https://github.com/Patternflow-lab/Patternflow/blob/claude/studio-guide-sync-campaign-w1bd3m/BUILD_GUIDE.md#8-firmware
• https://github.com/Patternflow-lab/Patternflow/blob/claude/studio-guide-sync-campaign-w1bd3m/README.md
• 링크 검사: python3 .github/scripts/check_links.py

Which row

CONTRIBUTING 표의 「A fix to a guide, a README or a spec」.

가정

• 200% 는 10월 타임라인 줄에만. 창작자 말 「현재 200퍼」는 지금 값이라 계속 움직입니다. docs/manifesto.md §12 「숫자는 낡는다… 영구적인 곳엔 두지 말라, 카운터가 움직였다고 고쳐야 하는 곳이 없게」에 따라 배지는 funded, ends Oct 15, 본문은 「past its goal」로 숫자 없이 쓰고, 날짜가 붙은 이력(Story so far 10월)에만 「reached 200% of its goal」을 적었습니다. 정확히 200% 가 안 됐다면 그 한 마디만 고치면 됩니다.
• 10월 15일이 지나면 고칠 곳 둘: 배지(ends Oct 15)와 「The device」 끝줄(「runs until 15 October 2026」). 날짜를 박아 둬서 지나도 거짓말은 안 되지만, 마감 뒤 Crowd Supply 에서 계속 주문을 받는지(선주문 등)는 레포에 근거가 없어 적지 않았습니다. 「Get one assembled」 링크는 Crowd Supply 페이지 그대로 둡니다.
• 히어로: 썸네일과 링크가 다른 영상인 것은 창작자 확인대로 의도라 그대로.
• §7 제목을 「Wiring」으로. 「다른 절은 안 건드림」 범위 안에서 §7 의 제목과 목차 한 줄은 바꿨습니다 — 첫 전원이 §8.1 5단계로 옮겨가 「& First Power-Up」이 틀린 말이 됐기 때문입니다. 옛 앵커는 레포 안에선 목차만 썼고, 사이트가 거는 앵커 목록에 없습니다. 밖에서 걸린 옛 링크가 있다면 파일 맨 위로 열립니다.
• §9 1단계(보조배터리 넣고 J4 꽂기)는 이제 §8.1 5단계와 겹치지만, 점검 목록이고 범위 밖이라 그대로 뒀습니다. §8 머리의 「pin map is identical on v2.x and v3.0」도 그대로(v3.9 도 같은 핀맵이라 틀리진 않음).
• 웹 카드 ↔ 단계: 웹 01 의 카드 1~3(꺼내기·잡는 법·왼쪽 포트)은 §8.1 1단계와 §8 머리에 묶었습니다. 「Firmware after v3.10.4」 문구는 지금 굽는 모든 이미지에 핫스팟이 있어 빼고, 없는 clock·MIDI try-out 만 예외로 적었습니다.
• 범위 밖으로 고친 두 곳: Besoiobiy 리믹스 README 의 단계 번호 인용(안 고치면 틀린 단계를 가리킴)과 CHANGELOG [Unreleased] 의 두 줄(다음 릴리스에 「the campaign reads funded」, 「BUILD_GUIDE … as they were」가 틀린 기록으로 나가지 않게).
• 증거 그림은 .github/pr-evidence/pr-9/ 에 올렸다가 다음 커밋에서 뺐습니다([DONE] hardware+web: mbchars' horizontal desktop case (upstream #488) is the fourth case in the /build 3D preview #5·[DONE] 웹 가이드 펌웨어 굽기·와이파이를 BOOT+RST 기본으로 고치고, 메인 README·문서를 정리한다 #7·[DONE] 메인 README 한 번 더 — 독자별 비판 검토부터 하고 다시 다듬는다 #8 과 같은 방식, 그림은 6a8b008 에 남음).

---

• Touches a markdown file → its relative links resolve (python3 .github/scripts/check_links.py)

🤖 Generated with Claude Code

https://claude.ai/code/session_01VNrkaFqadViNTX6AsvmZ7Y