整合性を維持する運用ガイド｜3層同期チェックリストとCI自動化の教科書

第2章で三枚舌を、第3章で見出し階層を直しました。しかし整合性は放っておくと必ず崩れます。 記事リライト、CMS移行、デザインリニューアル、新しい執筆者の参加——運用中のあらゆるイベントが、 3層同期を部分的に壊します。本章では、崩さない仕組みを4つのレイヤー（更新フロー / PRレビュー / CI / 定期監視）で設計します。

1. 整合性が崩れる"イベント"を先に把握する

運用設計の第一歩は、どのイベントで矛盾が発生するかを列挙することです。 崩れる瞬間が特定できれば、そこに対して防御策を配置できます。

2. 更新フロー：1イベント = 3層同時更新の原則

最も重要なのは、「タイトルを変更する」というタスクを、3層にまたがる1つの作業単位として扱う運用ルールです。 部分更新はすべてNGと決めるだけで、矛盾発生率は大きく下がります。

3. PRレビュー観点：差分から矛盾を発見する

レビュアーに整合性観点の具体的な見方を共有すれば、矛盾の多くはマージ前に発見できます。 PR diff上で見るべき3つの観点を整理します。

観点① 「片方だけ」変わっている行がないか

タイトル・著者・日付・主題キーワード——これらのいずれかが差分に含まれるPRでは、同じページ内のメタ / JSON-LD / H1 / 本文すべてに差分があるかを確認します。 片方だけ変わっているPRは、ほぼ確実に矛盾を生みます。

## 概要
<!-- 何を変更したか -->

## 構造的整合性チェック（該当する項目がある場合のみ）
以下のいずれかを変更した場合、3層すべての同期を確認してください：

- [ ] title / meta description の変更 →
  - [ ] og:title / og:description も同期
  - [ ] JSON-LD の headline / description も同期
  - [ ] 本文H1 / リード文も同期
- [ ] 著者情報の変更 →
  - [ ] JSON-LD の author.name も同期
  - [ ] 本文末クレジットも同期
- [ ] 公開日 / 更新日の変更 →
  - [ ] JSON-LD の datePublished / dateModified も同期
  - [ ] sitemap.xml の lastmod も同期
  - [ ] 本文内の日付表記も同期

## 検証
- [ ] Rich Results Test で JSON-LD がエラーなし
- [ ] AIOGeoScan 再診断で主題グループが1つにまとまっている

観点② 見出し階層の変更を検知する

見出しタグ（h1〜h4）の追加・削除・降格がある PR は、変更後の階層ツリー全体をレビュー対象にします。1行の修正に見えても、 その前後の階層包含関係が壊れていないかを必ず確認します。

観点③ テンプレート変更は全ページへの波及

共通テンプレート（layout.tsx、metadataジェネレーター、JSON-LDビルダー）の変更は、1ページのPRで数百ページに影響します。レビュー時は必ず「本番で影響を受けるURL数」を想定し、 代表ページ3〜5件で手動検証する運用にします。

4. CI / 自動テストへの組み込み

人間のレビューには見落としが付き物です。機械で確実に検出できる項目は CI に任せます。 ここでは、GitHub Actions で実装できる3つの自動チェックを紹介します。

チェックA: JSON-LDの構文・スキーマ妥当性

schema-dts などのTypeScript型定義や、structured-data-testing-toolといったライブラリで、 ビルド時に全ページのJSON-LDを検証します。

name: seo-checks
on: [pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20' }
      - run: npm ci
      - name: Build site
        run: npm run build
      - name: Validate JSON-LD
        run: npm run test:jsonld  # schema-dts + カスタムスクリプト
      - name: Heading hierarchy lint
        run: npm run lint:headings  # HTMLパースで階層スキップ検知
      - name: Meta consistency check
        run: npm run check:meta  # title vs og:title vs JSON-LD.headline

チェックB: 見出し階層のスキップ検出

ビルド成果物のHTMLをcheerio等でパースし、H1→H3といった階層スキップを自動検知します。 第3章のmdxComponentsパターンの、CI版です。

import { load } from 'cheerio';
import { readFileSync } from 'fs';
import { globSync } from 'glob';

const files = globSync('.next/server/app/**/*.html');
let hasError = false;

for (const file of files) {
  const $ = load(readFileSync(file, 'utf-8'));
  let lastLevel = 0;

  $('h1, h2, h3, h4, h5, h6').each((_, el) => {
    const level = Number(el.tagName.substring(1));
    if (lastLevel > 0 && level > lastLevel + 1) {
      console.error(
        `[${file}] skipped: H${lastLevel} → H${level}`
      );
      hasError = true;
    }
    lastLevel = level;
  });
}

process.exit(hasError ? 1 : 0);

チェックC: メタ情報の主題一致

<title>・og:title・JSON-LDのheadline・h1の4つを抽出し、文字列が完全一致するかをテストします。派生を許容する場合は、 主要キーワードの部分一致に緩めた正規表現ベースのチェックに変更します。

5. 定期監視：AIOGeoScanを"ダッシュボード"として運用する

CIで防げるのは「コードに起因する矛盾」です。CMSでの記事編集やデザイン変更など、コード外で発生する矛盾は、定期診断でしか発見できません。

6. ゴールデン・チェックリスト

本章の運用設計を1枚のチェックリストにまとめます。組織に導入する時はこれをそのまま貼ってください。

7. このガイドが提示した新しい"品質指標"

本ガイド全4章を通じて、「整合性」という新しいWeb品質指標を提示してきました。 従来のSEOが「カテゴリ別ベストプラクティスの積み上げ」だったのに対し、 AI時代のWeb品質は 「カテゴリ横断の整合性が取れていること」が前提条件になります。

整合性が取れたサイトは、AI Overviews や生成AIがページを解釈する際の手がかりが揃いやすくなります。 これは魔法の近道ではありませんが、検索表示・構造化データ利用・AIによる参照の土台を安定させる実務条件として重要です。 逆に言えば、どれだけコンテンツの質を上げても、整合性が崩れているとその価値が伝わりにくくなります。