mcpField
P
principle-foundational-thinking

principle-foundational-thinking

github.com/michael-denyer開発3.7k881 回インストール1 日前に更新
リポジトリ

principle-foundational-thinking について

データ設計、並行処理の分離、基盤整備、小さな変更を重視する開発スキルです。ソフトウェアの設計や実装を進める開発者向けです。

主な機能

  1. 01ロジックより先にデータ構造を決定
  2. 02明示的で簡潔なコードを優先
  3. 03危険な共有状態を分離
  4. 04共通基盤を早期に整備
  5. 05一貫性のある小さな変更

活用シーン

  1. 01実装前の中核データ設計
  2. 02並行状態の分離要否の確認
  3. 03CI、Lint、テスト、共有型の整備
  4. 04小さなコミットによる段階的な変更

インストール

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

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

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

詳細

基礎となる考え方

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

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

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

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

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

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

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

コメント