structure-first

構造を優先する

所有者を見つけます。フローを追跡します。責任を負う最小の単位を変更します。契約を検証します。

ランタイム契約

1. 症状や出力ではなく、振る舞いやルールを所有する最小の現在の単位を選びます。意図と、最小の観測可能な完了条件を明示します。バグの場合は、構造を変更する前に観測可能な失敗を確立します。
2. 呼び出し元から意思決定または状態、そして書き込みまたは効果を経て完了までの必要な経路のみを、コードにとって自然な形式で追跡します。型、テスト、ドキュメント、設定は、変更しないままにすると振る舞い、契約、または意味のある検証が壊れる場合にのみ含めます。
3. 構造的な要求—フロー、ライフサイクル、意思決定・効果・完了の所有、合成、マイグレーション、または境界契約—と、追跡やテストを妨げる摩擦を名指しします。
4. 焦点を絞った局所的な明確化を優先します。構造は、総合的な複雑さを取り除くか、独立して変更可能な責任を分離する場合にのみ変更します。ヘルパー、ラッパー、コンテキスト、状態、エラー、またはライフサイクルが複雑さを隠しているだけなら、トップレベルが短い方が良いわけではありません。
5. 各意思決定、書き込み、効果、完了ルールに、発見可能で競合しない単一の解決経路を与えます。古い同等の経路は同じ変更の中で削除します。そうでなければ、マイグレーションの所有者と終了条件を名指しします。
6. 観測可能な振る舞いは、ヘルパーの内部ではなく、最も安定した責任単位で検証します。別の単位が契約の一部を所有していることを証拠が示す場合にのみ、関係する最小の単位を再度開きます。

保持、インライン化、マージ、削除、並べ替え、抽出、および構造を変更しないことは、すべて有効な結果です。将来の使用のためのオプション、設定、依存関係、ラッパー、または抽象化を追加しないでください。

パフォーマンス作業では、既存の再現で入力スケール、繰り返し操作、実体化、およびフェーズのタイミングを測定します。支配的で回避可能な作業をその所有者において取り除き、次に同じ再現と観測可能な振る舞いを比較します。

必要な詳細

公開 I/O、意思決定・書き込み・効果・完了の所有、非同期・状態のライフサイクル、表現の意味、またはマイグレーション経路を変更する前に、構造的境界をお読みください。

重要な主張がアイデンティティ、権威あるデータ、表現、外部への書き込み、またはランタイム・非同期の境界を越える場合、あるいはバグ、リファクタリング、または機能に境界の証拠が必要な場合は、検証をお読みください。

現在の単位、構造的な要求、選択した結果、所有またはマイグレーションの状況、および検証は、タスクに役立つ場合にのみ報告します。計画や単純な局所的な作業にテンプレートを押し付けないでください。