---
paths:
  - "**/src/infra/adapters/config_writer.rs"
  - "**/src/app/ports/config_writer.rs"
  - "**/src/infra/adapters/connection_store.rs"
---

# 設定マイグレーションルール

## 後方互換性

- `connections.toml` スキーマの変更は既存の設定ファイルを壊してはならない
- 新しいフィールドには適切なデフォルト値を設定し、古い設定がエラーなくロードできるようにする
- 削除されたフィールドはデシリアライズ時にサイレントに無視すること

## スキーマバージョニング

- 破壊的なスキーマ変更がやむを得ない場合、設定に `version` フィールドを追加する
- 前バージョンからのマイグレーションパスを提供する
- 古い設定を自動マイグレーションする際は明確な警告をログに出すこと
