القائمة
コードベースやサブシステムの仕組みを、実際のコマンド出力付きで直線的に解説する文書を作る。読んでいないコードや、忘れたコードを把握し直すときに使う。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
compound engineering のステップ。ひとつの作業のあとに短く振り返り、学んだことを CLAUDE.md・スキル・hoard に畳み込む。意味のある作業の終わりごとに使う。
実機をシリアル越しに操作して挙動を確認する。tools/deck.py で JSON Lines を投げ、人間にしかできない確認は手順書にして渡す。ビルドが通ったあと、動いたと言い切る前に使う。
arduino-cli でファームをビルド／書き込みする。ボード設定、ライブラリのバージョン固定、書き込み時の注意をまとめてある。ファームを触ったあと、実機で確かめる前に使う。
git の混乱を収拾し、履歴を手術する。コミットの取り消し・書き換え、conflict の解消、reflog からの復旧、git bisect による退行の特定。
新しく分かった小技を、動く最小例として hoard/ に保存する。非自明なことを初めて解決したあとに使う。
アルゴリズムや仕組みを、単一 HTML のインタラクティブ／アニメーション付きページで説明する。文章だけでは腑に落ちないときの認知的負債の返済に使う。
| name | walkthrough |
| description | コードベースやサブシステムの仕組みを、実際のコマンド出力付きで直線的に解説する文書を作る。読んでいないコードや、忘れたコードを把握し直すときに使う。 |
コードの仕組みを、上から順に読めば分かる形で解説する文書を作る。 自分が書いたが読んでいないコード、時間が経って忘れたコードに効く。
notes/walkthrough-<topic>.md を作る（全体なら walkthrough.md）。sed -n '10,30p' <file> などのコマンドと、その
実出力を貼る。こうすれば引用が本物のソースと一致していることが保証され、
幻覚が混ざらない。uvx showboat が使えるなら showboat exec が確実。このプロジェクトで特に価値が高い対象:
resolveAction と dispatchAction の分離が、どこでトランスポート依存を
食い止めているか一度読めば、能力のある開発者が全体を理解できる文書になっていること。