core2deck

compound engineering のステップ。ひとつの作業のあとに短く振り返り、学んだことを CLAUDE.md・スキル・hoard に畳み込む。意味のある作業の終わりごとに使う。

実機をシリアル越しに操作して挙動を確認する。tools/deck.py で JSON Lines を投げ、人間にしかできない確認は手順書にして渡す。ビルドが通ったあと、動いたと言い切る前に使う。

arduino-cli でファームをビルド／書き込みする。ボード設定、ライブラリのバージョン固定、書き込み時の注意をまとめてある。ファームを触ったあと、実機で確かめる前に使う。

git の混乱を収拾し、履歴を手術する。コミットの取り消し・書き換え、conflict の解消、reflog からの復旧、git bisect による退行の特定。

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

アルゴリズムや仕組みを、単一 HTML のインタラクティブ／アニメーション付きページで説明する。文章だけでは腑に落ちないときの認知的負債の返済に使う。

自動テストの外側で実物を動かして確かめ、結果を notes/ に記録する。ホスト側は使い捨てプログラム、実機はシリアル、web はブラウザ自動化。テストが通ったあと、完了と言う前に使う。

仕様 §11 のマイルストーン（M1〜M6）の完了条件を判定し、次に進んでよいかを決める。ひとつの段階を終えたと思ったときに使う。

PR を出す前のチェックリスト。動くことを確認し、差分がレビュー可能で、文脈と検証の証拠が付いているかを見る。PR を開く前に必ず走らせる。

公開前の文書を校正する。誤字・文法・繰り返し・論理や事実の誤り・弱い主張・空リンクを指摘する。書き手の声を書き換えることはしない。

赤/緑の TDD で機能追加やバグ修正を行う。まず失敗するテストを書き、失敗を目で確認してから実装する。新しい挙動とバグ修正はすべてこれで進める。

コードベースやサブシステムの仕組みを、実際のコマンド出力付きで直線的に解説する文書を作る。読んでいないコードや、忘れたコードを把握し直すときに使う。