Skip to content

Metanaka Nuxt Architecture

Rule Levels

  • [必須]: 違反は必須修正として扱う。
  • [推奨]: 原則として採用する。合理的な理由がある逸脱は許容する。
  • [条件付き]: 記載した条件が成立するときだけ適用する。根拠不足なら違反ではなく確認事項とする。

レビュー判定に使う規則は level tag 付きの箇条書きだけとする。tag のない文章と code sample は背景、理由、例を示す。 仕様判断は要件・設計資料を正とし、この skill は Nuxt application の配置、依存方向、責務境界を定義する。

Routing

作業対象に該当する reference をすべて読む。一つの変更が複数領域へまたがる場合は一つだけ選ばない。

  • feature/shared slice、pages、命名、公開 API は references/architecture.md を読む。
  • Vue component、composable、model、Zod、Result、error handling は references/application.md を読む。
  • i18n source、key ownership、merge は references/i18n.md を読む。
  • Firestore の frontend read boundary、authenticated write API、共有データ方針は references/firestore.md を読む。
  • 複数 ownership 領域をまたぐレビューは references/review.md と対象 reference を併読する。
  • 複数規則を組み合わせた実例が必要な場合だけ references/room-setup/ 配下の対象 source を読む。sample は規則の正本ではない。

Ownership

  • [必須] architecture は配置、依存方向、feature/shared 境界、公開 API の正本にする。
  • [必須] application は Vue、composable、model、validation、Result/error handling の責務分担の正本にする。
  • [必須] i18n は locale source、key ownership、生成 workflow の正本にする。
  • [必須] firestore は frontend の read/write 境界と共有データ方針の正本にする。
  • [必須] review はレビュー範囲、根拠、重要度だけを定義し、技術規則を再掲しない。
  • [必須] TypeScript のコード表現は metanaka-nuxt-coding、unit test の構造と検証内容は metanaka-nuxt-testing、observable production behavior を変更する実行順序は metanaka-nuxt-tdd へ委ねる。