메뉴
コードベースやサブシステムの仕組みを、実際のコマンド出力付きで直線的に解説する文書を作る。読んでいないコードや、忘れたコードを把握し直すときに使う。
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 の分離が、どこでトランスポート依存を
食い止めているか一度読めば、能力のある開発者が全体を理解できる文書になっていること。