:::note[デモ用コンテンツ]
この記事はzudo-docの `note-tray` カテゴリ形式を紹介するために作成されたサンプルであり、実際の変更履歴や開発ブログの記事ではありません。
:::

## コンテンツを見慣れた形に保つ

ショーケースのAstroからの移行がうまくいったのは、コンテンツツリーを見慣れたまま保てたからです。ページはfrontmatterを持つ `.mdx` ファイルのまま、ディレクトリはナビゲーションを定義し続け、バイリンガルのミラーも同じファイル名を維持しました。読者から見ると、すでに理解しているサイトの下でエンジンが変わっただけです。

この継続性によって、変更を小さな単位でレビューできました。ルートの所有、パッケージのビルド、chrome bindingを個別に移行しながら、[インストールガイド](https://zudo-doc.takazudomodular.com/ja/docs/getting-started/installation)や執筆ワークフローの形を保てました。

## ファイルではなく契約を移行する

フレームワークの切り替えは、ページの周辺にある動作の所有者が明確なままなら完了です。パッケージが共有chromeを描画し、ホストがサイトの個性を提供し、執筆者が同じ規約を使い続けます。古いディレクトリを新しいビルドシステムへコピーするのではなく契約として扱う方が、不足している部分を早く見つけられます。