mcpField
P
principle-foundational-thinking

principle-foundational-thinking

github.com/mdsmithaustin開発8181 回インストール今日更新
リポジトリ

principle-foundational-thinking について

ソフトウェア開発の判断に役立つ基礎思考スキルです。データ構造を先に選び、明示的なコードを保ち、機能開発前に共通基盤を整え、並行共有状態を分離する方針を示します。

主な機能

  1. 01ロジックより先にデータ構造を選択
  2. 02巧妙な抽象化より明示的なコード
  3. 03動作とエッジケースをテスト
  4. 04共通基盤を早期に整備
  5. 05アクター間で共有する状態を分離
  6. 06基盤整備の前に未使用コードを削除

活用シーン

  1. 01実装前にコア型とアクセスパターンを計画
  2. 02類似コードを抽象化する必要性を判断
  3. 03CI、Lint、テスト、機能開発の順序を決定
  4. 04並行するアクター間の状態共有設計をレビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mdsmithaustin/pstack --skill principle-foundational-thinking

インストール後、Claude Code で/principle-foundational-thinkingを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

基礎となる考え方

構造上の判断は、選択肢の価値を守ります。コードレベルの判断は、シンプルさを守ります。

**まずデータ構造から。**ロジックを書く前に、データの形を適切に整えます。中核となる型を早い段階で定義し、あらゆるアクセスパターンをたどり、主要な経路に合った構造を選びます。

コードレベルでは、すべての行ではなく構造をDRYにします。型とデータモデルは一貫させます。似た文が3つあるほうが、時期尚早な抽象化よりも優れています。巧妙さより明示性を優先します。行数ではなく、振る舞いとエッジケースをテストします。

**並行性に関する補足。**アクター間で状態を共有する前に、「別のアクターが同時にこれを変更したらどうなるか?」と問いかけます。答えが「何も起きない」でなければ、分離します。

**まず足場を整える。**後続のすべてのフェーズに役立つものがあれば、最初に行います。「これが既にあることで、以降のすべてのフェーズにメリットがあるか?」と問いかけます。CI、リンティング、テスト基盤、共有型は足場です。選択肢の価値を高める順序にします。機能の前にセットアップ、修正の前にテストを行います。コミットは小さく、単一の目的に絞ります。

各段階で、一貫した抽象化を導入するか、既存の抽象化を深めます。特別な連携処理として新機能を呼び出し側に分散させないでください。

足場を整える前に、まず削除します。最初に不要なコードを取り除き、その後で基盤を築きます。

コメント