어디 있을까? — 빠른 찾기 인덱스¶

자주 묻는 질문 + 자주 찾는 위치를 한 페이지에 모았습니다. 메뉴를 9 개씩 뒤지지 말고 여기서 Ctrl+F (찾기) 로 키워드 검색.

🚀 시작하기¶

상황	어디로
처음 시작, 무엇부터 해야 하지	docs/getting-started/00-claude-code-quickstart.md (AI 안내) 또는 01 하드웨어 연결
Claude Code 가 무엇입니까	00 Claude Code 시작
URL 만 받았는데 어떻게 진행	00 페이지 - ZIP 받기 전 OK 박스
환경 구축 단계가 막혔습니다	02 환경 구축 → troubleshooting.md
첫 빌드가 안 됩니다	03 첫 빌드 + troubleshooting.md
LED 가 안 켜집니다	Ex.00 Quick Start README

상황	어디로
내 코드 어디에 쓰지	`XM_Apps/Control_Task/control_task.c` (ZIP 압축 푼 폴더 기준)
내 코드가 언제 호출되는지	docs/architecture/README.md
함수 시그니처 / API 명세	docs/api-reference/
버튼 / LED 제어	api-reference/03-led-btn-control.md + Ex.01~03
외부 GPIO / ADC	api-reference/04-external-io.md + Ex.04~06
USB 시리얼로 PC 에 데이터 보내기	api-reference/05-usb-connectivity.md + Ex.07~09
USB 로 데이터 내보내기 (실시간)	api-reference/05-usb-connectivity.md + Ex.09 CDC Stream · xm10 도구 (내 구조체) · PhAI Studio (Total Data)
내 구조체를 이름 · 단위 · 타입과 함께 PC 로 보내기 (Rev 2.0 전용)	api-reference/10-struct-logging.md + Ex.44 CDC Struct Logging · xm10 도구
USB 메모리에 저장하기 (Rev 2.0 전용)	getting-started/05-usb-memory-log.md + api-reference/06-usb-data-logging.md + Ex.10 · Ex.34
메모리 영역 (PSRAM, Workspace)	api-reference/07-memory-management.md + Ex.19
날짜·시간 (RTC)	api-reference/08-rtc-clock.md
KIT H10 외골격 제어	api-reference/02-h10-control-n-data.md + Ex.11~13
상태 머신 (TSM)	api-reference/01-task-state-machine.md + Ex.03

상황	어디로
48 개 예제 전체 인덱스	examples/README.md
난이도별·트랙별 학습 경로	docs/tutorials/README.md
한 학기 수업 진도표 (16 주)	tutorials/README.md - 한 학기 진도표 섹션
Ex.XX 예제가 잘 안 됩니다	해당 `examples/XX_*/README.md` 의 "⚠️ 흔한 실수" 섹션
입문자가 첫 30 분 동선	examples/README.md - 처음 오신 분
PD 제어 / 임피던스 / CPG 등 알고리즘 예제	examples/14, 15, 20~30 (자세한 매핑은 examples/README.md)

상황	어디로
보드에 뭐가 몇 개 있나 (LED / 버튼 / CAN / USB / UART)	docs/hardware/README.md
외부 GPIO 핀맵 (Rev 1.1)	hardware/external-gpio-rev1.1.md
외부 GPIO 핀맵 (Rev 2.0)	hardware/external-gpio-rev2.0.md
내 보드가 Rev 1.1 인지 Rev 2.0 인지	hardware/README.md - 보드 리비전 비교
48 개 예제는 어느 리비전에서 동작	examples/README.md - 보드 리비전 호환성 (40 개는 양쪽 모두 동작·외부 GPIO 핀맵만 다름, Ex.10 · Ex.34 · Ex.36 과 Ex.40/41/42/43/44 는 Rev 2.0 전용)

상황	어디로
ST-Link SWD 로 직접 업로드	docs/getting-started/03-first-build.md
PhAI Studio FTP 업로드 (배포용)	docs/bootloader/README.md
부트로더가 뭐고 왜 필요한가	bootloader/README.md - WHY 섹션
KIT H10 외골격 펌웨어 업데이트	docs/kit-h10-firmware/README.md
XM10 ↔ KIT H10 버전 호환성	kit-h10-firmware/README.md

상황	어디로
외골격 데이터로 AI 모델 학습	docs/advanced/ai-data-pipeline.md
보드 안에서 Tiny NN 추론	Ex.16, Ex.36 + advanced/README.md
PC 에서 데이터 받기 / 저장 / CSV 뽑기 (Python, exe)	getting-started/04-pc-data-tool.md
보드 없이 도구 먼저 써 보기	`python xm10.py demo` — 04-pc-data-tool.md 첫 절
프레임이 빠지는지 판정	`python xm10.py soak` — 04-pc-data-tool.md
PhAI Studio 사용법	studio.onephai.com + Ex.09 README (Studio 는 Total Data(0x20)를 보여 줍니다 — 내 구조체는 xm10 도구)
내 알고리즘을 1 ms 안에 끝내고 싶음	Ex.18 Debug Monitor + Ex.19 Memory Aware Design
자기주도 학습 트랙 (관심 분야별)	advanced/README.md - 자기주도 학습 경로

상황	어디로
빌드 / clone / 한글 경로 에러	docs/troubleshooting.md
시리얼 통신 / USB 연결 안 됨	troubleshooting.md + 해당 예제 README
USB 메모리가 안 잡힙니다 / 저장 중에 PC 가 안 잡힙니다 (Rev 2.0 전용)	getting-started/05-usb-memory-log.md + Ex.10 · Ex.34 의 ⚠️ 흔한 실수
PhAI Studio 가 안 잡힙니다 (CDC)	Ex.07~09 의 ⚠️ 흔한 실수 + `.c` 파일 헤더의 PhAI 동시점유 경고
보드가 무한 리부팅	troubleshooting.md
Body Data 가 무엇입니까 (gaitCycle 등)	api-reference/README.md - Body Data 전제조건
버전별 알려진 이슈	docs/release-notes/

위 표를 외울 필요 없습니다. Claude Code 에서 다음과 같이 자연스럽게 물어보세요.

"USB 로 실시간 데이터 어떻게 받아?"
"Ex.14 빌드 에러 났어"
"보드 리비전 확인하는 법"
"AI 학습 데이터 어떻게 모아?"

example-helper / student-onboard 스킬이 자동으로 해당 페이지를 찾아 인용해줍니다.