=== AHEADARC Theme ===
Contributors: aheadarc
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AIエージェントと人が同じ設計ルールで運用する、日本語組版に最適化したWordPressブロックテーマです。

== 特長 ==

* Full Site Editing対応の9テンプレート（front-page、home、index、page、single、singular、archive、search、404）
* Coreブロックだけで構成した10パターン
* デフォルト、日本語 Editorial、ダークの3表示モード
* Noto Sans JP優先のシステムフォントスタック。外部フォント通信なし
* 禁則、本文幅42rem、本文行間1.9、見出し折返しをfront/editor共通CSSで調整
* focus-visible、44px操作領域、reduced motion、forced colors、Coreのskip linkに対応
* Coreブロック別CSSをwp_enqueue_block_styleで必要時だけ読み込み
* テーマ所有フロントエンドJavaScript 0 byte
* agent-contract.jsonとaheadarc-manifest.jsonによるAIエージェント向け契約
* WordPress、Astro、EmDash、Cloudflare staticで共有できるベンダー非依存design-tokens.json
* ショートコード、独自投稿タイプ、外部フォント、外部CSSなし

== インストール ==

1. 管理画面の「外観 > テーマ > 新規追加 > テーマのアップロード」を開きます。
2. aheadarc-theme-1.1.0.zipを選び、インストールして有効化します。
3. 「外観 > エディター」でサイト名、ナビゲーション、フッターを実際の情報へ変更します。
4. 「スタイル」でデフォルト、日本語 Editorial、ダークから表示モードを選びます。
5. パターンの仮文言、リンク、料金、連絡先を公開前に確認します。

== 日本語編集UX ==

本文の基準幅は42rem、行間は1.9です。日本語にはline-break: strict、自然な句読点間隔、見出しのbalanced wrappingを段階的に適用します。未対応ブラウザでは標準組版へ安全にフォールバックします。style.cssはエディターにも読み込まれ、ブロック別CSSもWordPress API経由でfront/editorへ同じルールを配ります。

== パターン ==

* ファーストビュー
* サービス紹介
* 料金比較
* よくある質問（Detailsブロック。freeform HTML不使用）
* お問い合わせCTA
* 記事の導入
* 記事の要点
* セクション見出し
* 3ステップ
* 新着記事

== AIエージェント運用 ==

aheadarc-manifest.jsonがリソースと安全境界を示し、agent-contract.jsonが見出し、画像alt、許可ブロック、承認、競合検知、復旧ルールを定義します。AHEADARC Agentを併用する場合、変更は提案として保存され、管理者承認、SHA-256競合停止、適用前WordPress revisionを経て反映されます。テーマ単体はAgentなしでも動作します。

== Portability ==

design-tokens.jsonが共通の正本です。theme.jsonとstyles/*.jsonはWordPress用、assets/design-tokens.cssはAstro/Cloudflare static用、exports/portable-theme.jsonはEmDashなどのツール用です。npm run sync:theme-tokensで生成し、npm run check:theme-tokensで同期ずれを停止します。WordPress本文はCoreブロックのまま保持され、移植対象は色、組版、間隔、幅、表示モード、パターンメタデータです。

== 表示性能の予算 ==

performance-budget.jsonで次を固定しています。

* テーマZIP: 512 KiB以下
* テーマ独自CSS合計: 24 KiB以下
* テーマ独自フロントエンドJS: 0 byte
* 外部runtime URLと外部フォント: 0
* パッケージファイル: 80以下

WordPress Coreが生成するブロックCSSやユーザーが追加するプラグインはこのテーマ予算の外です。テーマ側では外部フォント待ち、独自JS、不要な全ページblock CSSを避け、Core Web Vitalsを崩しにくい基礎を維持します。

== 検証 ==

配布前にnpm run qaを実行します。PHP構文、JSON Schema、theme.json/token同期、ブロック直列化、freeform HTML禁止、アクセシビリティ規則、contrast、CSS/JS/ZIP予算、ZIP root、不用ファイル、SHA256SUMSを検証します。実環境のLCP、INP、CLSはコンテンツ、画像、プラグイン、配信基盤にも依存するため、公開サイトごとに計測してください。

== データとロックイン ==

テーマはショートコードや独自投稿タイプを登録しません。コンテンツはWordPress Coreのブロックマークアップとして残ります。計測は任意のAHEADARC Measureプラグイン側で同意後のみ有効になり、テーマ単体は解析タグを出力しません。

== ライセンス ==

GPL-2.0-or-later。LICENSEを参照してください。
