Project Architecture Guide

このガイドは、プロジェクト全体の構造と判断基準を理解するためのプロジェクト参照ページ群のトップです。長期運用を前提に、AIエージェントがコンテンツ作成・更新・情報設計・UI改善・品質管理・構造確認を行うときの参照起点になります。

• このガイドは入口であり、仕様の複製置き場ではない。各ルール・データの正本は1つだけ。
• 実在するルート・UI・トークン・公開本文は、サイトリポジトリの現行コードが基準。設計文書と食い違う場合はコードを先に確認する。
• 設計方針・運用ルール・タクソノミーなどの文書正本は、エージェントリポジトリ（01-matsusaka-guide-agent）にある。
• プロジェクト参照ページはURLを知っていれば閲覧できる（noindexはアクセス制限ではない）。公開して問題のない情報だけを載せる。

判断に迷ったときの優先順位。詳細の正本は agent project-documents/（content-policy.md・ux-design-system.md ほか）。

• 使いやすさ最優先。アクセシビリティと表示速度は非交渉。
• 質優先。整理されて読む価値があることが掲載基準。冗長なら載せない。
• 便利＋ワクワク。手続き系（ごみ・おくやみ等）をトップに出さず、発見が楽しいものを前へ。
• 高リスク領域（防災・医療・市政等）では広告・誘導を抑制し、一次情報と確認日を明示する。
• 正本は1つ。同じ仕様・データを複数の場所に持たない。

人間もAIも、まずこのページで「どの領域の話か」を特定し、Source of Truth Map で正本と確認ページへ移動します。

1. 変更・調査したい対象がどの領域（Design / Content / AI / Site）かを Architecture Areas で特定する。
2. Source of Truth Map でその領域の正本を確認し、正本を先に読む・直す。
3. 表示・確認ページ（Design System・Site Reference 等）で現状を確認する。
4. 変更後は Update Responsibilities に従い、追随が必要なページを更新する。

状態表示の語彙: Current＝実装済み・稼働中 / Draft＝実装はあるが暫定・整備中 / Planned＝未実装（構造だけ用意）。未実装の機能をCurrentとして表示しません。

プロジェクト参照ページ群は次の主要ページで構成します。論理階層はこのガイドと主要ページの2段までで、URLはすべてルート直下です。

領域ごとに正本は1つ。実装コードが正本の領域と、エージェントリポジトリの設計文書が正本の領域を区別して示します（agent ＝ 01-matsusaka-guide-agent リポジトリ）。

• 実際のデザイントークンCurrent

  色・タイポ・余白・角丸・影のCSS変数の実体

  正本: src/app/globals.css

  確認: Design System

  更新契機: トークンの追加・変更時

• UIコンポーネントCurrent

  実装済みコンポーネントのコード

  正本: src/components/*.tsx

  確認: Design System

  更新契機: コンポーネントの追加・変更時

• UX・アクセシビリティ原則Current

  設計原則・アクセシビリティ基準の文書

  正本: agent project-documents/ux-design-system.md

  確認: Design System

  更新契機: 設計方針の決定・変更時

• 情報価値とPresentation設計Draft

  情報価値がContext・Presentationでどう実現するかの研究フレームワーク（CIPValue Framework / Information Presentation Architecture）

  正本: agent project-documents/cipvalue-framework.md

  確認: CIPValue Framework

  更新契機: CIPValueの名称・中心モデル・責務境界の変更時

• URLとルートCurrent

  実在ルートの実体（App Router）

  正本: src/app/（現行コード）＋ agent project-documents/site-spec.md（URL原則）

  確認: Sitemap View

  更新契機: ページ・ルートの追加・削除時

• コンテンツモデルCurrent

  コンテンツ種別・必須項目・掲載ルールの定義

  正本: agent project-documents/entry-architecture.md・content-policy.md

  確認: Content Architecture

  更新契機: コンテンツ構造の設計変更時

• エントリー構造Current

  エントリー実データ（frontmatter＋本文）

  正本: content/entries/*.md ＋ src/lib/entries.ts（読み取り）

  確認: Site Reference

  更新契機: エントリーの追加・更新時

• タクソノミーCurrent

  フィールド判定・タグ・ジャンルの分類定義

  正本: agent project-documents/tag-taxonomy.md ＋ src/lib/fields.ts（判定実装）

  確認: Site Reference › Tags

  更新契機: タグ・分類の追加・変更時

• 公開済みコンテンツCurrent

  公開中の本文（エントリー・くらしガイド・固定ページ）

  正本: content/ ＋ src/lib/*-topics.ts（くらしガイドのトピック）

  確認: Sitemap View

  更新契機: 本文の公開・更新時

• 情報源と更新根拠Current

  出典・確認日・一次情報の管理

  正本: agent sources/ ＋ Notion Source Index DB ＋ 各エントリーfrontmatter（source/verified_date）

  確認: Site Reference

  更新契機: ソース取り込み・再確認時

• AI運用ルールCurrent

  AIの作業手順・読むべき文書・品質ゲート

  正本: agent AGENTS.md ＋ workflows/*.md

  確認: AI Prompt Guide

  更新契機: 運用手順の決定・変更時

• サイト構造Current

  ページ階層・ページ種別・親子関係の一覧

  正本: src/app/（実在ルート）＋ src/app/sitemap-view/page.tsx（構造の記述）

  確認: Sitemap View

  更新契機: 主要ルート・トピック群の追加時

• 印刷・オフライン表現Current

  Webトークンの印刷用途への翻訳（CMYK・紙面・入稿）

  正本: src/app/design-system-print/page.tsx（ブランド定義自体は ux-design-system.md）

  確認: Design System Print

  更新契機: 印刷物の制作・ブランド変更時

プロジェクト参照ページ群の現在の実装状態。サイト全体の実データ状態（エントリー数・診断）は Site Reference で確認します。

• 主要ページ11本と専門ビュー1本（Design System Print）で構成。主要ページのうち CIPValue Framework は Research Draft（Draft）で、他は Current。
• CIPValue Framework（研究フレームワーク）の Core と Matsusaka Guide Application Profile は、現時点では同じ研究正本（agent cipvalue-framework.md）内で管理している。独立リポジトリへの分離は将来案で、決定済みではない。
• Site Reference の New Entries / Tags / Orphan Entries は実データ表示（Current）。Content Freshness・Data Quality・Broken References は構造のみ（Planned）。
• Orphan判定は現在「フィールド判定タグに一致しない」のみ（Field Orphan）。Navigation Orphan・Visibility Issue は Planned。
• /sitemap.xml は未実装。実装時は src/lib/project-reference-pages.ts の定義でプロジェクト参照ページを除外する。
• Design System の Presentation Patterns は共通構造のみ定義済み（Planned・本文は今後）。

全プロジェクト参照ページ一覧（正本: src/lib/project-reference-pages.ts）。全ページで noindex・サイト内検索除外・公開ナビ除外・将来のsitemap除外を維持します。

• Project Architecture Guide/project-architecture-guide主要ページCurrent
• CIPValue Framework/cipvalue-framework主要ページDraft
• Design System/design-system主要ページCurrent
• Design System Print/design-system-print専門ビュー（/design-system 配下）Current
• Glossary/glossary主要ページCurrent
• Sitemap View/sitemap-view構造ビュー（全幅）Current
• AI Prompt Guide/ai-prompt-guide主要ページCurrent
• Site Reference/site-referenceダッシュボードCurrent
• Entry Workflow/entry-workflow主要ページCurrent
• Content Architecture/content-architecture主要ページCurrent
• Site Analytics/site-analyticsダッシュボードCurrent
• Site SEO/site-seoダッシュボードCurrent

変更したとき、どこを更新するか。「正本を先に直し、表示ページを追随させる」が原則です。

プロジェクト参照ページを追加・削除・改名した

src/lib/project-reference-pages.ts（ProjectReferenceNav・検索除外・一覧はここから自動反映）

公開ページ・ルートを追加・削除した

/sitemap-view のTREE（src/app/sitemap-view/page.tsx）

デザイントークン・コンポーネントを変更した

src/app/globals.css → /design-system の該当セクション

タグ・分類・用語の定義を変更した

agent tag-taxonomy.md（正本）→ /glossary を追随

エントリー運用の工程を変更した

agent workflows/entry-collection-to-publication.md（正本）→ /entry-workflow を追随

AIの作業手順・品質ゲートを変更した

agent AGENTS.md・workflows/（正本）→ /ai-prompt-guide を追随

CIPValueの名称・中心モデル・責務境界を変更した

agent project-documents/cipvalue-framework.md（正本を先に更新）→ /cipvalue-framework を追随