contributorとAI coding tool向けの内部設計資料です。作業に関係する文書・節だけを参照してください。通読や固定の読む順番は不要です。
| 作業・確認したいこと | 参照先 |
|---|---|
| Core／Feature／adapterの責務・依存方向 | architecture.mdのLayer boundary |
| Graph・phase・feature依存・Artifactの契約 | architecture.mdの実装contract |
| 公開API・型・互換性 | architecture.mdの公開API、型境界 |
| Viteのbuild／dev・experimental API・fallback | vite.md |
| 個別機能の設計理由・却下案 | ADR索引から該当する判断 |
| テストの選択・実行方法 | testing.md |
| docsのCloudflare Workers公開・archive更新・移行手順 | docs-deployment.md |
| 未実装・上流待ち・再検討条件 | roadmap.md |
| v5への移行・完了済み変更 | release-notes-v5.md |
| 性能比較・過去の測定条件 | benchmarks/ |
- 構造変更では関係する設計資料とADRを同時に更新する。
architecture.mdは実装済みの事実、roadmap.mdは未実装・experimental・移行条件を扱う。 - Vite APIの採用状態・fallback・Build用語は
vite.mdに集約する。外部APIのstatusには公式資料と確認日を添える。 - machine-readable schemaには
schemaVersionを持たせ、互換性方針を該当ADRへ記録する。 - ADRのContext・却下案、レビュー、benchmarkは記録時点の情報。過去の検証記録や完了条件は、新しい作業で一律に実行する指示ではない。
必要な問題の経緯を調べる場合に参照します。
- v5設計レビュー、実装確認
- プラグイン改善計画と完了記録（P01〜P11完了）
- Astra向け指示・参照構成の整理