認知負荷ミニマイザー

ソフトウェアから「避けられる」認知負荷を減らす。ドメイン由来の本質的複雑さは残し、将来の貢献者に不要なメンタルモデルの再構築を強いる表現・構造・アーキの選択だけを取り除く。

手順

ステップ1: タスク境界を決める

1. 変更の種類を特定する: コードレビュー、リファクタ、機能実装、アーキ判断、オンボーディング改善のいずれか。
2. 読み手のペルソナを決める: 新規コントリビュータ、隣チーム、将来の保守担当、QA、現機能オーナーなど。
3. 本質的複雑さと余計な複雑さを分ける:
   • 本質的: ドメインルール、正しさの要件、現実のスケール制約、データモデルの事実。
   • 余計な: 技巧表現、不要な間接化、浅い分割、独自マッピング、フレームワークの魔法、主観的なアーキ用語。
4. 混乱の原因がコード構造ではなくドメイン知識不足なら、コードをいじる前にドメインの事実を文書化する。