ファイリング構成

hub/projects/ と assets/ のフォルダ名を揃え、 プロジェクト単位で素材をまとめます。

全体ツリー

CURSOR file/
├── docs/
│   ├── project-roadmap.md
│   ├── filing-structure.md
│   └── logs/
├── PlatformIO/PlatformIO_Projects/
│   └── m5_motor_gadget/          ← アンダースコア
├── Web_html/hub/
│   ├── data/projects.json
│   └── projects/
│       ├── m5-motor-gadget/      ← ハイフン
│       └── m5-joycon-stick/
└── assets/
    ├── m5-motor-gadget/          ← hub と同名
    ├── m5-joycon-stick/
    └── guides/                   ← 共通図

命名ルール

assets/{プロジェクト}/ の中身

assets/m5-joycon-stick/
├── hall-pinout-v1.drawio     ← Draw.io 編集用
├── hall-pinout-v1.svg        ← Hub 掲載用
├── photo-breadboard-01.jpg   ← 実配線写真
├── easyeda-export.json       ← EasyEDA
├── schematic-v1.png
└── 3d/                       ← STL（④以降）
    └── chassis-v1.stl

ファイル名: {内容}-v1.{拡張子}（英小文字・ハイフン）

動画は Drive

Hub からの参照

プロジェクト詳細（hub/projects/{slug}/index.html）から:

<img src="../../assets/m5-joycon-stick/hall-pinout-v1.drawio.drawio.svg" alt="pin 配置">

書庫（hub/library/*.html）からは ../assets/...、トップからは assets/... です。旧ルート直下 ../../../assets/ は使いません。

新プロジェクト追加時

1. hub/projects/{slug}/index.html
2. data/projects.json に 1 件追加
3. assets/{slug}/ フォルダ作成
4. docs/logs/ に活動ログ
5. push → Cloudflare 自動デプロイ