no-workarounds

ソースを修正する

提案された修復が問題を修正するのではなく、診断を抑制したり失敗を隠したりする場合に、このスキルを使用します。すでに収集された証拠を起点にしてください。原因がまだ不明な場合に限り、systematic-debugging を使用します。

• 観測された失敗を、それを所有するコードまたは境界まで追跡します。その原因を修正し、既存の所有者側のテストスイートまたはプローブで、元の症状が解消したことを確認します。
• キャスト、抑制、握りつぶされたエラー、固定スリープ、モンキーパッチ、フォールバックチェーンを、文脈に照らして確認します。これらは調査の手がかりであり、すべてが誤りである証拠ではありません。必要に応じて、references/workaround-catalog.md の該当項目を確認します。
• プロジェクトのポリシーで求められる、意図的な境界での検証、型付けされた失敗処理、互換性のための移行やアダプターを維持します。文書化された非推奨期間は、プロダクト上の契約です。
• 修正の範囲を絞り、適切なユーティリティを再利用して、無関係なアーキテクチャの整理は避けます。

外部の欠陥

欠陥がチームの管理外にある場合は、必要なアダプターを境界に隔離し、根拠と削除条件を説明して、既存のテストスイートで影響を受ける動作を保護します。該当する既存の上流イシューがあれば参照します。外部イシューの作成は、許可されている場合に限ります。有効期限を確実に検出でき、保守コストに見合う場合にのみ、カナリアまたはレビュー日を追加します。

元の失敗を修正するか、範囲を限定した外部要因による制約を明示し、関連するチェックが通れば完了です。現在の結果を再利用してください。すべての修正で、カタログ全体を読んだり、別途文書化されたゲートを設けたりする必要はありません。references/philosophical-foundations.md は、根拠として任意で参照できます。