hoard

name	hoard
description	新しく分かった小技を、動く最小例として hoard/ に保存する。非自明なことを初めて解決したあとに使う。

分かったことを溜め込む

小技は 一度 解決すれば十分。動くコード例として残しておけば、以後どのセッション からも参照でき、似た形の問題に応用したり、複数の例を組み合わせたりできる。

このプロジェクトで溜め込む価値が高いもの（どれも一度ハマると時間を溶かす）:

• 動いた ESP32 コア × BLE HID ライブラリのバージョンの組み合わせと、最小スケッチ
• NimBLE でコンシューマコントロール（音量等）のレポートを出す最小例
• ArduinoJson でストリーミング的に JSON Lines を読む書き方
• M5Unified のオフスクリーン描画（M5Canvas）の最小例
• Web Serial の読み書き（行区切りの取り回し、TextDecoderStream の注意点）
• Service Worker で単一 HTML をオフライン化する最小構成
• SD / NVS のフォールバック処理の骨格

記録する

引数は、いま分かった小技。

1. hoard/<slug>/README.md を作る:
   • 何ができるか — 1〜2 文。答えている問いの形で書く （「NimBLE で音量キーを送るには？」）。
   • 動く例 — 最小の完全なコード。README 内でも、隣に置いた実行可能な ファイルでもよい。実際に動かして動いたコードであること。 「理論上できるはず」は溜め込む対象ではない。
   • 動かし方 — 正確なコマンド。ファームなら FQBN とライブラリのバージョンまで。
   • ハマりどころ — 発見に時間がかかったこと。
2. 小技そのもの以外を削ぎ落とす。

使う

• 何かを作り始める前に hoard/ を探す。
• 組み合わせる: 「A は X を、B は Y を示している。両方使って Z を作れ」という プロンプトが、この収集物がもたらす最強のパターン。
• 外部の例も同じように使える。curl で生のソースを取ってくる（WebFetch は 要約してしまう。欲しいのは生のコード）。参考リポジトリは /c/tmp に clone して中を検索する。