superior-lean

Superior Lean

要求された問題全体を、新たに増やすコードの範囲を最小限に抑えて解決します。簡潔さを求めるのは解決策であり、理解、正確性、検証ではありません。

最適な所有者を探す

編集する前に、影響を受ける処理の流れをたどり、呼び出し元を確認します。次の順に優先します。

1. 要求された動作がすでに存在する場合や、提案が推測にすぎない場合は、変更しない；
2. 既存のプロジェクトのヘルパー、型、コンポーネント、設定箇所、またはパターン；
3. 言語の標準ライブラリ；
4. ネイティブのフレームワーク、ブラウザー、データベース、またはオペレーティングシステムの機能；
5. すでにインストールされている依存関係；
6. 所有者が明確な、小規模なローカル実装。

現実的な動作を完全に満たし、コードベースに適合する最初の選択肢で止めます。誤った層にコードを置いて行数を減らしても、簡潔にはなりません。

不要な仕組みを取り除く

次の点を見直します。

• 安定した境界がなく、実装が1つしかないインターフェース；
• 固定のプロダクトを1つだけ生成するファクトリー；
• 変化しない値のための設定；
• 既存の API に別の名前を付けるだけのラッパー；
• リポジトリがすでに備えている機能のための、並行するユーティリティ；
• 推測に基づく拡張ポイント、レジストリー、フラグ、移行用の足場；
• 明快で保守しやすいローカルコード数行で置き換えられる依存関係；
• 根本原因を1か所直すべきところに重複しているガード。

動作を維持できるなら、削除を優先します。単に行数を減らすために、わかりやすいコードを気の利いた式に押し込めないでください。

残すべき複雑さ

次の要素を簡略化によって取り除いてはいけません。

• 明示されたユーザー要件や、サポート対象の互換性；
• 信頼境界における検証と認可；
• プライバシー、認証、セキュリティ、監査の管理策；
• 破損やデータ損失を防ぐために必要な復旧処理；
• アクセシビリティとレスポンシブ動作；
• 実際の並行性、順序、リトライ、冪等性、キャンセルの保証；
• 物理システムや変動するシステムに必要な調整・チューニング機能。

検証

削除した仕組みに必須の利用者がいなかったことと、動作が維持されていることを確認します。分岐、パーサー、状態遷移、金融処理、セキュリティに関わるフローでは、対象を絞ったテストを実施します。レビューでは、確認できた複雑さと仮定上の整理を区別し、具体的な効果がある変更だけを推奨します。

何が簡潔になったか、何を意図的に維持したか、そして将来複雑さを追加する根拠となる実際の条件を報告します。

クレジット表記

このスキルは、Dietrich Gebert による Ponytail を大幅に書き換えて翻案したものです。LICENSE を参照してください。