backward-compat-governance
Installation
SKILL.md
後方互換性ガバナンス
互換性を「残すコード」ではなく「契約と撤去計画」として管理する。
核心原則
後方互換性それ自体が悪ではない。互換性を支える「仕様・テスト・撤去計画・計測」が欠けたとき、互換要求が実装へ流れ込みゴミコード化する。
| 状態 | 互換性の扱い | 結果 |
|---|---|---|
| 管理あり | 契約(仕様)+ テスト + 撤去SLO + 計測 | 安定性の基盤(資産) |
| 管理なし | 実装でのその場しのぎ | 互換層の肥大化(負債) |
負債化のフィードバックループ
既存クライアント → 「壊すな」の要求
→ 公開APIの固定・増殖
→ 非推奨APIの温存 + 互換アダプタ/分岐追加
Related skills