From 0757e8ce4149694fe40fee05f21a568bf878fd91 Mon Sep 17 00:00:00 2001
From: watanabe-kohei-jp <283722319+watanabe-kohei-jp@users.noreply.github.com>
Date: Thu, 21 May 2026 15:40:02 +0900
Subject: [PATCH 1/4] docs(seo): sync lectures 02/03 to sitemap/llms.txt/README
 and fix og:url
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

既存講義 02-setup / 03-claude-md を SEO・GEO 系メタデータに同期し、
02/03 の og:url が旧 GitHub Pages URL を指していた誤りを修正する。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 02-setup/index.html     |  2 +-
 03-claude-md/index.html |  2 +-
 README.md               |  4 ++++
 index.html              |  8 ++++++++
 llms.txt                |  2 ++
 sitemap.xml             | 14 +++++++++++++-
 6 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/02-setup/index.html b/02-setup/index.html
index ee4d5b9..8838259 100644
--- a/02-setup/index.html
+++ b/02-setup/index.html
@@ -8,7 +8,7 @@
 <meta property="og:type" content="article">
 <meta property="og:title" content="Lecture 02 — Claude Code 環境構築">
 <meta property="og:description" content="プランの選択からインストール・認証・初起動まで。Claude Code を動かすまでの 12 枚。">
-<meta property="og:url" content="https://watanabe-kohei-jp.github.io/lectures/02-setup/">
+<meta property="og:url" content="https://co-lect.github.io/lectures/02-setup/">
 
 <link rel="stylesheet" href="../shared/theme.css">
 <script src="../shared/deck-stage.js"></script>
diff --git a/03-claude-md/index.html b/03-claude-md/index.html
index e333c3f..e250d00 100644
--- a/03-claude-md/index.html
+++ b/03-claude-md/index.html
@@ -8,7 +8,7 @@
 <meta property="og:type" content="article">
 <meta property="og:title" content="Lecture 03 — CLAUDE.md でプロジェクトを記憶させる">
 <meta property="og:description" content="毎回の説明をゼロにする CLAUDE.md の使い方を 12 枚で。">
-<meta property="og:url" content="https://watanabe-kohei-jp.github.io/lectures/03-claude-md/">
+<meta property="og:url" content="https://co-lect.github.io/lectures/03-claude-md/">
 
 <link rel="stylesheet" href="../shared/theme.css">
 <script src="../shared/deck-stage.js"></script>
diff --git a/README.md b/README.md
index 0e797c8..9e3b63c 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,8 @@ AI コーディング（Claude Code 等）を中心に、散在しがちな情
 |---|---|---|
 | [`00-about/`](./00-about/index.html) | この資料の歩き方（Read me） | 9 枚 |
 | [`01-claude-code-intro/`](./01-claude-code-intro/index.html) | Claude Code 入門 | 12 枚 |
+| [`02-setup/`](./02-setup/index.html) | Claude Code 環境構築 | 12 枚 |
+| [`03-claude-md/`](./03-claude-md/index.html) | CLAUDE.md でプロジェクトを記憶させる | 12 枚 |
 
 各章は単体の HTML として完結しているので、ブラウザで開けばそのまま読めます。
 
@@ -41,6 +43,8 @@ AI コーディング（Claude Code 等）を中心に、散在しがちな情
 ```
 https://co-lect.github.io/lectures/00-about/
 https://co-lect.github.io/lectures/01-claude-code-intro/
+https://co-lect.github.io/lectures/02-setup/
+https://co-lect.github.io/lectures/03-claude-md/
 ```
 
 ### 方法 2: クローンしてローカルで開く
diff --git a/index.html b/index.html
index e690a72..2c78496 100644
--- a/index.html
+++ b/index.html
@@ -110,6 +110,14 @@ <h2>講義</h2>
       <a class="title" href="01-claude-code-intro/">01 — なぜ今、Claude Code を学ぶのか</a>
       <div class="desc">AI コーディングの全体像、ツールの正体、人の立ち位置の変化（12 枚）</div>
     </li>
+    <li>
+      <a class="title" href="02-setup/">02 — Claude Code 環境構築</a>
+      <div class="desc">プランの選択からインストール・認証・初起動まで（12 枚）</div>
+    </li>
+    <li>
+      <a class="title" href="03-claude-md/">03 — CLAUDE.md でプロジェクトを記憶させる</a>
+      <div class="desc">毎回の説明をゼロにする CLAUDE.md の書き方・置き場所・効果的な 3 パターン（12 枚）</div>
+    </li>
   </ul>
 
   <h2>鮮度について</h2>
diff --git a/llms.txt b/llms.txt
index ceed783..215c3fd 100644
--- a/llms.txt
+++ b/llms.txt
@@ -8,6 +8,8 @@
 
 - [00 Read me](https://co-lect.github.io/lectures/00-about/): 教材シリーズの設計思想と歩き方。1 年で陳腐化する世界で資料をどう作るか（9 枚）
 - [01 なぜ今、Claude Code を学ぶのか](https://co-lect.github.io/lectures/01-claude-code-intro/): AI コーディングの全体像、ツールの正体、人の立ち位置の変化（12 枚）
+- [02 Claude Code 環境構築](https://co-lect.github.io/lectures/02-setup/): プランの選択からインストール・認証・初起動まで（12 枚）
+- [03 CLAUDE.md でプロジェクトを記憶させる](https://co-lect.github.io/lectures/03-claude-md/): 毎回の説明をゼロにする CLAUDE.md の書き方・置き場所・効果的な 3 パターン（12 枚）
 
 ## メタ
 
diff --git a/sitemap.xml b/sitemap.xml
index 7b89909..939eb4b 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,7 +2,7 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://co-lect.github.io/lectures/</loc>
-    <lastmod>2026-05-17</lastmod>
+    <lastmod>2026-05-20</lastmod>
     <changefreq>monthly</changefreq>
     <priority>1.0</priority>
   </url>
@@ -18,4 +18,16 @@
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
+  <url>
+    <loc>https://co-lect.github.io/lectures/02-setup/</loc>
+    <lastmod>2026-05-20</lastmod>
+    <changefreq>monthly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://co-lect.github.io/lectures/03-claude-md/</loc>
+    <lastmod>2026-05-20</lastmod>
+    <changefreq>monthly</changefreq>
+    <priority>0.8</priority>
+  </url>
 </urlset>

From 7e0ea93ac51f0c94e83d6ff6e0325833512c8477 Mon Sep 17 00:00:00 2001
From: watanabe-kohei-jp <283722319+watanabe-kohei-jp@users.noreply.github.com>
Date: Fri, 22 May 2026 15:12:54 +0900
Subject: [PATCH 2/4] feat(automation): auto-sync listings from
 NN-slug/index.html
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

NN-slug/index.html を真実源として sitemap.xml / llms.txt / index.html /
README.md の講義一覧ブロックを自動生成する仕組みを追加。

- scripts/sync_listings.py: <title> / <meta description> / <section> 数を
  抽出して各 listing ファイルのマーカー間を再生成する
- sync-listings-check.yml: PR で --check を強制
- sync-listings-bot.yml: main へのマージ後 --write して bot コミット
- 4 ファイルにマーカー埋め込み、現状の listing を再生成済み
- CONTRIBUTING.md / CLAUDE.md / _template/index.html に運用ノート追記

PR #31 で手動同期した同期漏れの再発防止。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .github/workflows/sync-listings-bot.yml   |  44 ++++
 .github/workflows/sync-listings-check.yml |  27 ++
 CLAUDE.md                                 |   6 +
 CONTRIBUTING.md                           |  21 +-
 README.md                                 |  10 +-
 _template/index.html                      |   3 +
 index.html                                |  11 +-
 llms.txt                                  |  11 +-
 scripts/README.md                         |  63 +++++
 scripts/sync_listings.py                  | 287 ++++++++++++++++++++++
 sitemap.xml                               |   7 +-
 11 files changed, 477 insertions(+), 13 deletions(-)
 create mode 100644 .github/workflows/sync-listings-bot.yml
 create mode 100644 .github/workflows/sync-listings-check.yml
 create mode 100644 scripts/README.md
 create mode 100644 scripts/sync_listings.py

diff --git a/.github/workflows/sync-listings-bot.yml b/.github/workflows/sync-listings-bot.yml
new file mode 100644
index 0000000..85fe6e9
--- /dev/null
+++ b/.github/workflows/sync-listings-bot.yml
@@ -0,0 +1,44 @@
+name: Listings Sync Bot
+
+# main への push 後に同期ブロックを再生成し、差分があれば
+# github-actions[bot] が main に直接 commit する。PR 段階のチェック
+# (sync-listings-check.yml) を通過していれば通常は no-op で終わる。
+#
+# ループ防止: bot 自身の push では走らせない。
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  sync:
+    if: github.actor != 'github-actions[bot]'
+    name: Auto-commit listing sync
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Run sync_listings --write
+        run: python3 scripts/sync_listings.py --write
+
+      - name: Commit if changed
+        run: |
+          if [[ -z "$(git status --porcelain)" ]]; then
+            echo "No changes — listings already in sync."
+            exit 0
+          fi
+          git config user.name  "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "chore(listings): auto-sync $(date +%F)"
+          git push
diff --git a/.github/workflows/sync-listings-check.yml b/.github/workflows/sync-listings-check.yml
new file mode 100644
index 0000000..80ffc08
--- /dev/null
+++ b/.github/workflows/sync-listings-check.yml
@@ -0,0 +1,27 @@
+name: Listings Sync Check
+
+# PR 用の verify-only。NN-slug/index.html の追加・変更があった際に
+# sitemap.xml / llms.txt / index.html / README.md の自動生成ブロックが
+# 同期されていなければ fail させる。
+# ローカルでの修正コマンド: python3 scripts/sync_listings.py --write
+#
+# 詳細: scripts/README.md
+
+on:
+  pull_request:
+
+jobs:
+  check:
+    name: Verify auto-generated listing blocks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Run sync_listings --check
+        run: python3 scripts/sync_listings.py --check
diff --git a/CLAUDE.md b/CLAUDE.md
index 0f7cc45..f571bf6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -49,6 +49,12 @@
 - AI 周辺は移り変わりが激しい。古くなったら直す、ではなく、**最初から "更新される前提" で設計**
 - HTML × Git × PR ベースの運用は、その変化への対応手段
 
+### 5. 講義一覧は自動同期する（手で更新しない）
+- 新しい講義 `NN-slug/index.html` を追加するだけで、`sitemap.xml` / `llms.txt` / ルート `index.html` / `README.md` の講義一覧ブロックが自動同期される
+- 真実源は各 `NN-slug/index.html` の `<title>` と `<meta name="description">`
+- 同期スクリプト: `python3 scripts/sync_listings.py --write`（PR では `--check` が CI 強制）
+- 詳細: [`scripts/README.md`](./scripts/README.md)
+
 ---
 
 ## 期待する効果（長期）
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 469fa35..7a0d7d6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -100,7 +100,26 @@ commit に `Co-Authored-By: Name <email>` trailer を付けると、GitHub の C
 ### CI
 
 - **Prompt Injection Guard** が HTML/CSS/JS の追加行を自動スキャン
-- 失敗時は job summary に検出箇所が表示される
+- **Listings Sync Check** が `sitemap.xml` / `llms.txt` / `index.html` / `README.md` の講義一覧ブロックを検証
+- 失敗時は job summary に検出箇所・修正コマンドが表示される
+
+### 新しい Lecture を追加するとき
+
+`sitemap.xml` / `llms.txt` / `index.html`（ルート）/ `README.md` の講義一覧は **自動同期** されます。`NN-slug/index.html` の `<title>` と `<meta name="description">` から自動生成されるので、これらのファイルを手で編集する必要はありません。
+
+```bash
+# 講義ディレクトリを作って書く
+cp -r _template NN-slug
+# ... NN-slug/index.html を編集 ...
+
+# 4 つの listing ファイルを同期
+python3 scripts/sync_listings.py --write
+
+# 確認用
+python3 scripts/sync_listings.py --check
+```
+
+PR で同期し忘れた場合は CI（`sync-listings-check.yml`）が落とします。詳細は [`scripts/README.md`](./scripts/README.md)。
 
 ### 大きな変更の場合
 
diff --git a/README.md b/README.md
index 9e3b63c..9b8f0dd 100644
--- a/README.md
+++ b/README.md
@@ -27,10 +27,13 @@ AI コーディング（Claude Code 等）を中心に、散在しがちな情
 
 | 章 | 内容 | スライド |
 |---|---|---|
-| [`00-about/`](./00-about/index.html) | この資料の歩き方（Read me） | 9 枚 |
-| [`01-claude-code-intro/`](./01-claude-code-intro/index.html) | Claude Code 入門 | 12 枚 |
+<!-- Auto-generated by scripts/sync_listings.py. Do not edit by hand. -->
+<!-- listings:auto:lectures-table:start -->
+| [`00-about/`](./00-about/index.html) | Read me | 9 枚 |
+| [`01-claude-code-intro/`](./01-claude-code-intro/index.html) | なぜ今、Claude Code を学ぶのか | 12 枚 |
 | [`02-setup/`](./02-setup/index.html) | Claude Code 環境構築 | 12 枚 |
 | [`03-claude-md/`](./03-claude-md/index.html) | CLAUDE.md でプロジェクトを記憶させる | 12 枚 |
+<!-- listings:auto:lectures-table:end -->
 
 各章は単体の HTML として完結しているので、ブラウザで開けばそのまま読めます。
 
@@ -41,10 +44,13 @@ AI コーディング（Claude Code 等）を中心に、散在しがちな情
 ### 方法 1: 公開サイト（GitHub Pages）
 
 ```
+<!-- Auto-generated by scripts/sync_listings.py. Do not edit by hand. -->
+<!-- listings:auto:lectures-urls:start -->
 https://co-lect.github.io/lectures/00-about/
 https://co-lect.github.io/lectures/01-claude-code-intro/
 https://co-lect.github.io/lectures/02-setup/
 https://co-lect.github.io/lectures/03-claude-md/
+<!-- listings:auto:lectures-urls:end -->
 ```
 
 ### 方法 2: クローンしてローカルで開く
diff --git a/_template/index.html b/_template/index.html
index 3863b1d..3e32081 100644
--- a/_template/index.html
+++ b/_template/index.html
@@ -2,6 +2,9 @@
 <html lang="ja">
 <head>
 <meta charset="UTF-8">
+<!-- 注意: <title> と <meta name="description"> はルートの sitemap.xml / llms.txt /
+     index.html / README.md の講義一覧に自動転記されます（scripts/sync_listings.py）。
+     listing にそのまま載る前提で、短く・的確に書いてください。 -->
 <title>{{ 講義タイトル }} — Lectures</title>
 <meta name="description" content="{{ 1〜2 文の概要。検索・GEO 用。160 字以内で、この回が扱う機能と読者の得るものを書く }}">
 <meta name="author" content="@watanabe-kohei-jp">
diff --git a/index.html b/index.html
index 2c78496..36141ac 100644
--- a/index.html
+++ b/index.html
@@ -102,22 +102,25 @@ <h1>Lectures</h1>
 
   <h2>講義</h2>
   <ul class="map">
+    <!-- Auto-generated by scripts/sync_listings.py. Do not edit by hand. -->
+    <!-- listings:auto:start -->
     <li>
       <a class="title" href="00-about/">00 — Read me</a>
-      <div class="desc">教材シリーズの設計思想と歩き方。1 年で陳腐化する世界で、資料をどう作るか（9 枚）</div>
+      <div class="desc">Lectures シリーズの歩き方 — 1 年で陳腐化する世界で、AI と共同編集する資料はどう作るべきか。教材全体の設計思想を 9 枚で示す Read me。</div>
     </li>
     <li>
       <a class="title" href="01-claude-code-intro/">01 — なぜ今、Claude Code を学ぶのか</a>
-      <div class="desc">AI コーディングの全体像、ツールの正体、人の立ち位置の変化（12 枚）</div>
+      <div class="desc">なぜ今 Claude Code を学ぶのか — AI コーディングの全体像、ツールの正体、人の立ち位置の変化を 12 枚で概観する HTML スライド教材。</div>
     </li>
     <li>
       <a class="title" href="02-setup/">02 — Claude Code 環境構築</a>
-      <div class="desc">プランの選択からインストール・認証・初起動まで（12 枚）</div>
+      <div class="desc">Claude Code を動かすまでの手順を 12 枚で解説。プランの選択からインストール・認証・初起動まで。</div>
     </li>
     <li>
       <a class="title" href="03-claude-md/">03 — CLAUDE.md でプロジェクトを記憶させる</a>
-      <div class="desc">毎回の説明をゼロにする CLAUDE.md の書き方・置き場所・効果的な 3 パターン（12 枚）</div>
+      <div class="desc">毎回の説明をゼロにする CLAUDE.md の使い方。書き方・置き場所・効果的な3パターンを12枚で解説。</div>
     </li>
+    <!-- listings:auto:end -->
   </ul>
 
   <h2>鮮度について</h2>
diff --git a/llms.txt b/llms.txt
index 215c3fd..e78321a 100644
--- a/llms.txt
+++ b/llms.txt
@@ -6,10 +6,13 @@
 
 ## 講義
 
-- [00 Read me](https://co-lect.github.io/lectures/00-about/): 教材シリーズの設計思想と歩き方。1 年で陳腐化する世界で資料をどう作るか（9 枚）
-- [01 なぜ今、Claude Code を学ぶのか](https://co-lect.github.io/lectures/01-claude-code-intro/): AI コーディングの全体像、ツールの正体、人の立ち位置の変化（12 枚）
-- [02 Claude Code 環境構築](https://co-lect.github.io/lectures/02-setup/): プランの選択からインストール・認証・初起動まで（12 枚）
-- [03 CLAUDE.md でプロジェクトを記憶させる](https://co-lect.github.io/lectures/03-claude-md/): 毎回の説明をゼロにする CLAUDE.md の書き方・置き場所・効果的な 3 パターン（12 枚）
+<!-- Auto-generated by scripts/sync_listings.py. Do not edit by hand. -->
+<!-- listings:auto:start -->
+- [00 Read me](https://co-lect.github.io/lectures/00-about/): Lectures シリーズの歩き方 — 1 年で陳腐化する世界で、AI と共同編集する資料はどう作るべきか。教材全体の設計思想を 9 枚で示す Read me。
+- [01 なぜ今、Claude Code を学ぶのか](https://co-lect.github.io/lectures/01-claude-code-intro/): なぜ今 Claude Code を学ぶのか — AI コーディングの全体像、ツールの正体、人の立ち位置の変化を 12 枚で概観する HTML スライド教材。
+- [02 Claude Code 環境構築](https://co-lect.github.io/lectures/02-setup/): Claude Code を動かすまでの手順を 12 枚で解説。プランの選択からインストール・認証・初起動まで。
+- [03 CLAUDE.md でプロジェクトを記憶させる](https://co-lect.github.io/lectures/03-claude-md/): 毎回の説明をゼロにする CLAUDE.md の使い方。書き方・置き場所・効果的な3パターンを12枚で解説。
+<!-- listings:auto:end -->
 
 ## メタ
 
diff --git a/scripts/README.md b/scripts/README.md
new file mode 100644
index 0000000..cb372e1
--- /dev/null
+++ b/scripts/README.md
@@ -0,0 +1,63 @@
+# scripts/
+
+リポジトリ運用のためのユーティリティスクリプト。
+
+---
+
+## `sync_listings.py` — 講義一覧の自動同期
+
+`NN-slug/index.html` を真実源（source of truth）として、以下の自動生成ブロックを同期する：
+
+| ファイル | 同期される場所 |
+|---|---|
+| `sitemap.xml` | `<!-- listings:auto:start --> ... :end -->` — 講義 URL の `<url>` ブロック |
+| `llms.txt` | 同上 — 「## 講義」の箇条書き |
+| `index.html`（ルート） | 同上 — `<ul class="map">` の中身 |
+| `README.md` | `<!-- listings:auto:lectures-table:start -->` 〜 — 章テーブル |
+| `README.md` | `<!-- listings:auto:lectures-urls:start -->` 〜 — 公開 URL 一覧 |
+
+各 `NN-slug/index.html` の `<title>` と `<meta name="description">` と `<section>` 数が抽出元。
+
+### 使い方
+
+```bash
+# 変更を書き戻す（ローカル開発で使う）
+python3 scripts/sync_listings.py --write
+
+# ずれていないか確認（CI 用、exit 1 で fail）
+python3 scripts/sync_listings.py --check
+```
+
+### 新しい講義を追加する流れ
+
+1. `_template/` をコピーして `NN-slug/` を作る
+2. `<title>` / `<meta name="description">` / スライド本文を書く
+3. `python3 scripts/sync_listings.py --write` で 4 ファイルを同期
+4. `git add -A && git commit && PR`
+
+PR を上げ忘れても CI の `sync-listings-check.yml` が落とすので発見できる。
+main にマージ後は念のため `sync-listings-bot.yml` が再生成する二重防衛。
+
+### 依存
+
+- Python 3.8+（標準ライブラリのみ。`pip install` 不要）
+- `git`（lastmod の取得に使用）
+
+### マーカー設計
+
+各ファイルに HTML/XML コメント形式でマーカーを埋める。マーカー間の本文のみ
+スクリプトが再生成し、マーカー外は触らない。
+
+```
+<!-- listings:auto:start -->
+... 自動生成 ...
+<!-- listings:auto:end -->
+```
+
+同じファイルに 2 か所以上ある場合は名前付きにする：
+
+```
+<!-- listings:auto:<name>:start -->
+... 自動生成 ...
+<!-- listings:auto:<name>:end -->
+```
diff --git a/scripts/sync_listings.py b/scripts/sync_listings.py
new file mode 100644
index 0000000..47beeca
--- /dev/null
+++ b/scripts/sync_listings.py
@@ -0,0 +1,287 @@
+#!/usr/bin/env python3
+"""sync_listings.py — keep listing files in sync with NN-slug/index.html.
+
+Discovers lecture directories matching ``NN-slug/`` at the repo root,
+extracts metadata (title / meta description / <section> count / git lastmod),
+and rewrites the auto-generated blocks (delimited by HTML comment markers)
+inside sitemap.xml, llms.txt, index.html, and README.md.
+
+Usage:
+  python3 scripts/sync_listings.py --check   # exit 1 if any block drifts
+  python3 scripts/sync_listings.py --write   # apply drift back to disk
+
+Marker format:
+  <!-- listings:auto:start --> ... <!-- listings:auto:end -->
+  <!-- listings:auto:<name>:start --> ... <!-- listings:auto:<name>:end -->
+
+No third-party deps; Python 3.8+ standard library only.
+"""
+from __future__ import annotations
+
+import argparse
+import datetime
+import os
+import re
+import subprocess
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+
+SITE_BASE = "https://co-lect.github.io/lectures/"
+LECTURE_DIR_RE = re.compile(r"^([0-9]{2})-([a-z0-9-]+)$")
+TITLE_RE = re.compile(r"<title>(.*?)</title>", re.DOTALL)
+META_DESC_RE = re.compile(
+    r'<meta\s+name=["\']description["\']\s+content=["\'](.*?)["\']',
+    re.DOTALL,
+)
+SECTION_RE = re.compile(r"<section[\s>]")
+
+
+def repo_root() -> Path:
+    out = subprocess.run(
+        ["git", "rev-parse", "--show-toplevel"],
+        capture_output=True, text=True, check=True,
+    )
+    return Path(out.stdout.strip())
+
+
+def git_lastmod(rel_path: str, root: Path) -> str:
+    try:
+        out = subprocess.run(
+            ["git", "log", "-1", "--format=%cs", "--", rel_path],
+            capture_output=True, text=True, check=True, cwd=root,
+        )
+        date = out.stdout.strip()
+        if date:
+            return date
+    except subprocess.CalledProcessError:
+        pass
+    return datetime.date.today().isoformat()
+
+
+@dataclass
+class Lecture:
+    num: str
+    slug: str
+    raw_title: str
+    desc: str
+    slide_count: int
+    lastmod: str
+
+    @property
+    def dir_name(self) -> str:
+        return f"{self.num}-{self.slug}"
+
+    @property
+    def url(self) -> str:
+        return f"{SITE_BASE}{self.dir_name}/"
+
+    @property
+    def topic(self) -> str:
+        """Short topic title for listing display.
+
+        Handles two patterns:
+          "Lecture 01 — Foo"        → "Foo"
+          "Read me — 1 年で..."      → "Read me"
+          (anything else)            → full title (after stripping " — Lectures")
+        """
+        t = re.sub(r"\s+—\s+Lectures$", "", self.raw_title.strip())
+        m = re.match(r"^Lecture\s+\d{2}\s+—\s+(.+)$", t)
+        if m:
+            return m.group(1).strip()
+        m = re.match(r"^(.+?)\s+—\s+.+$", t)
+        if m:
+            return m.group(1).strip()
+        return t
+
+
+def _extract(pattern: re.Pattern, html: str, label: str, path: Path) -> str:
+    m = pattern.search(html)
+    if not m:
+        raise SystemExit(f"ERROR: missing {label} in {path}")
+    return m.group(1).strip()
+
+
+def discover_lectures(root: Path) -> list[Lecture]:
+    lectures: list[Lecture] = []
+    for child in sorted(root.iterdir()):
+        if not child.is_dir():
+            continue
+        m = LECTURE_DIR_RE.match(child.name)
+        if not m:
+            continue
+        idx = child / "index.html"
+        if not idx.exists():
+            continue
+        html = idx.read_text(encoding="utf-8")
+        lectures.append(Lecture(
+            num=m.group(1),
+            slug=m.group(2),
+            raw_title=_extract(TITLE_RE, html, "<title>", idx),
+            desc=_extract(META_DESC_RE, html, '<meta name="description">', idx),
+            slide_count=len(SECTION_RE.findall(html)),
+            lastmod=git_lastmod(f"{child.name}/index.html", root),
+        ))
+    return lectures
+
+
+# --- renderers ---------------------------------------------------------------
+
+def render_sitemap(lectures: list[Lecture]) -> str:
+    parts = []
+    for lec in lectures:
+        parts.append(
+            "  <url>\n"
+            f"    <loc>{lec.url}</loc>\n"
+            f"    <lastmod>{lec.lastmod}</lastmod>\n"
+            "    <changefreq>monthly</changefreq>\n"
+            "    <priority>0.8</priority>\n"
+            "  </url>"
+        )
+    return "\n".join(parts)
+
+
+def render_llms(lectures: list[Lecture]) -> str:
+    return "\n".join(
+        f"- [{lec.num} {lec.topic}]({lec.url}): {lec.desc}"
+        for lec in lectures
+    )
+
+
+def render_index_html(lectures: list[Lecture]) -> str:
+    blocks = []
+    for lec in lectures:
+        blocks.append(
+            "    <li>\n"
+            f'      <a class="title" href="{lec.dir_name}/">{lec.num} — {lec.topic}</a>\n'
+            f'      <div class="desc">{lec.desc}</div>\n'
+            "    </li>"
+        )
+    return "\n".join(blocks)
+
+
+def render_readme_table(lectures: list[Lecture]) -> str:
+    return "\n".join(
+        f"| [`{lec.dir_name}/`](./{lec.dir_name}/index.html) "
+        f"| {lec.topic} | {lec.slide_count} 枚 |"
+        for lec in lectures
+    )
+
+
+def render_readme_urls(lectures: list[Lecture]) -> str:
+    return "\n".join(lec.url for lec in lectures)
+
+
+RENDERERS = {
+    "sitemap": render_sitemap,
+    "llms": render_llms,
+    "index": render_index_html,
+    "readme_table": render_readme_table,
+    "readme_urls": render_readme_urls,
+}
+
+# (path, marker, renderer_key)
+TARGETS: list[tuple[str, str, str]] = [
+    ("sitemap.xml", "listings:auto", "sitemap"),
+    ("llms.txt", "listings:auto", "llms"),
+    ("index.html", "listings:auto", "index"),
+    ("README.md", "listings:auto:lectures-table", "readme_table"),
+    ("README.md", "listings:auto:lectures-urls", "readme_urls"),
+]
+
+
+# --- marker replace ----------------------------------------------------------
+
+def replace_block(text: str, marker: str, replacement: str) -> tuple[str, bool]:
+    """Replace content between marker comments, preserving the end marker's
+    leading indentation. Returns (new_text, changed)."""
+    start_tag = f"<!-- {marker}:start -->"
+    end_tag = f"<!-- {marker}:end -->"
+    s = text.find(start_tag)
+    if s < 0:
+        raise SystemExit(f"ERROR: '{start_tag}' not found")
+    after_start = s + len(start_tag)
+    e = text.find(end_tag, after_start)
+    if e < 0:
+        raise SystemExit(f"ERROR: '{end_tag}' not found (after start marker)")
+    line_start = text.rfind("\n", 0, e) + 1
+    end_indent = text[line_start:e]
+    if end_indent.strip():
+        end_indent = ""  # not pure whitespace; do not preserve
+    current = text[after_start:e]
+    new = f"\n{replacement}\n{end_indent}"
+    if current == new:
+        return text, False
+    return text[:after_start] + new + text[e:], True
+
+
+# --- main --------------------------------------------------------------------
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description=__doc__.splitlines()[0])
+    g = ap.add_mutually_exclusive_group(required=True)
+    g.add_argument("--check", action="store_true",
+                   help="exit 1 if any block drifts")
+    g.add_argument("--write", action="store_true",
+                   help="write drift back to disk")
+    args = ap.parse_args()
+
+    root = repo_root()
+    lectures = discover_lectures(root)
+    if not lectures:
+        print("No lectures discovered.", file=sys.stderr)
+        return 2
+
+    file_text: dict[str, str] = {}
+    drifted: list[tuple[str, str]] = []
+
+    for path_str, marker, key in TARGETS:
+        path = root / path_str
+        if path_str not in file_text:
+            file_text[path_str] = path.read_text(encoding="utf-8")
+        replacement = RENDERERS[key](lectures)
+        new_text, changed = replace_block(file_text[path_str], marker, replacement)
+        file_text[path_str] = new_text
+        if changed:
+            drifted.append((path_str, marker))
+
+    if args.check:
+        if not drifted:
+            print(f"OK: all listings in sync ({len(lectures)} lectures).")
+            return 0
+        print(f"Drift detected in {len(drifted)} block(s):", file=sys.stderr)
+        for path_str, marker in drifted:
+            print(f"  - {path_str} [{marker}]", file=sys.stderr)
+        print(
+            "\nTo fix:\n  python3 scripts/sync_listings.py --write\n"
+            "then commit the result.",
+            file=sys.stderr,
+        )
+        summary_path = os.environ.get("GITHUB_STEP_SUMMARY")
+        if summary_path:
+            with open(summary_path, "a", encoding="utf-8") as f:
+                f.write("### Listings out of sync\n\n")
+                f.write("The following auto-generated blocks need regeneration:\n\n")
+                for path_str, marker in drifted:
+                    f.write(f"- `{path_str}` (`{marker}`)\n")
+                f.write(
+                    "\n**Fix locally:**\n"
+                    "```\npython3 scripts/sync_listings.py --write\n```\n"
+                    "then commit the result.\n"
+                )
+        return 1
+
+    # --write
+    changed_files = {p for p, _ in drifted}
+    for path_str in changed_files:
+        (root / path_str).write_text(file_text[path_str], encoding="utf-8")
+    if changed_files:
+        print(f"Wrote {len(changed_files)} file(s): "
+              f"{', '.join(sorted(changed_files))}")
+    else:
+        print(f"OK: nothing to write ({len(lectures)} lectures, all in sync).")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/sitemap.xml b/sitemap.xml
index 939eb4b..119e7b7 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -6,6 +6,8 @@
     <changefreq>monthly</changefreq>
     <priority>1.0</priority>
   </url>
+  <!-- Lectures below are auto-generated by scripts/sync_listings.py. -->
+  <!-- listings:auto:start -->
   <url>
     <loc>https://co-lect.github.io/lectures/00-about/</loc>
     <lastmod>2026-05-17</lastmod>
@@ -20,14 +22,15 @@
   </url>
   <url>
     <loc>https://co-lect.github.io/lectures/02-setup/</loc>
-    <lastmod>2026-05-20</lastmod>
+    <lastmod>2026-05-21</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://co-lect.github.io/lectures/03-claude-md/</loc>
-    <lastmod>2026-05-20</lastmod>
+    <lastmod>2026-05-21</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
+  <!-- listings:auto:end -->
 </urlset>

From 25bcc9449e84eb1fb53b0a42fa7a2826eedd2145 Mon Sep 17 00:00:00 2001
From: watanabe-kohei-jp <283722319+watanabe-kohei-jp@users.noreply.github.com>
Date: Sat, 23 May 2026 18:22:51 +0900
Subject: [PATCH 3/4] chore(listings): regenerate sitemap lastmod after merge
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

main 取り込み後の各講義 index.html の最終コミット日 (2026-05-19) を
sitemap.xml に反映する。
---
 sitemap.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/sitemap.xml b/sitemap.xml
index 119e7b7..3c8d36f 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -10,25 +10,25 @@
   <!-- listings:auto:start -->
   <url>
     <loc>https://co-lect.github.io/lectures/00-about/</loc>
-    <lastmod>2026-05-17</lastmod>
+    <lastmod>2026-05-19</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://co-lect.github.io/lectures/01-claude-code-intro/</loc>
-    <lastmod>2026-05-17</lastmod>
+    <lastmod>2026-05-19</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://co-lect.github.io/lectures/02-setup/</loc>
-    <lastmod>2026-05-21</lastmod>
+    <lastmod>2026-05-19</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://co-lect.github.io/lectures/03-claude-md/</loc>
-    <lastmod>2026-05-21</lastmod>
+    <lastmod>2026-05-19</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

From db5cedc8a792e6f4be195ae34cf1dd4b1711d356 Mon Sep 17 00:00:00 2001
From: watanabe-kohei-jp <283722319+watanabe-kohei-jp@users.noreply.github.com>
Date: Sun, 24 May 2026 19:02:26 +0900
Subject: [PATCH 4/4] fix(automation): harden listing sync per code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Codex レビュー (PR #36) で出た 6 点を反映:

1. HTML/XML エスケープ: render_sitemap / render_index_html / render_readme_table
   が title / description / dir_name を生で埋めていたため、`<`, `&`, `"` 等が
   入った瞬間に root index.html や sitemap.xml の構造が壊れるリスクがあった。
   html.escape() を出力側で適用。読み込み側は html.unescape() で正規化して
   ダブルエンコードを避ける。
2. Marker injection 対策: title / description に '<!-- listings:auto'、改行、
   '|' (markdown table 破壊要因) のいずれかが入っていたら fail させる
   pre-flight validation (validate_metadata) を追加。
3. README table 破壊対策: 1+2 と同系統。`|` を pre-flight で reject + 角括弧を
   markdown 側でエスケープ。
4. discover_lectures が NN-slug/index.html 不在を silently skip していたのを
   SystemExit に変更。壊れた lecture を見逃さない。
5. sync-listings-check.yml に permissions: contents: read を明示。
6. sync-listings-bot.yml の git add -A を 4 ファイル限定に絞り、
   concurrency group を追加して push race を防止。
---
 .github/workflows/sync-listings-bot.yml   |  6 ++-
 .github/workflows/sync-listings-check.yml |  3 ++
 scripts/sync_listings.py                  | 65 ++++++++++++++++++-----
 3 files changed, 60 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/sync-listings-bot.yml b/.github/workflows/sync-listings-bot.yml
index 85fe6e9..6cc8b0b 100644
--- a/.github/workflows/sync-listings-bot.yml
+++ b/.github/workflows/sync-listings-bot.yml
@@ -13,6 +13,10 @@ on:
 permissions:
   contents: write
 
+concurrency:
+  group: listings-sync-main
+  cancel-in-progress: false
+
 jobs:
   sync:
     if: github.actor != 'github-actions[bot]'
@@ -39,6 +43,6 @@ jobs:
           fi
           git config user.name  "github-actions[bot]"
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          git add -A
+          git add sitemap.xml llms.txt index.html README.md
           git commit -m "chore(listings): auto-sync $(date +%F)"
           git push
diff --git a/.github/workflows/sync-listings-check.yml b/.github/workflows/sync-listings-check.yml
index 80ffc08..38aa042 100644
--- a/.github/workflows/sync-listings-check.yml
+++ b/.github/workflows/sync-listings-check.yml
@@ -10,6 +10,9 @@ name: Listings Sync Check
 on:
   pull_request:
 
+permissions:
+  contents: read
+
 jobs:
   check:
     name: Verify auto-generated listing blocks
diff --git a/scripts/sync_listings.py b/scripts/sync_listings.py
index 47beeca..cfce89b 100644
--- a/scripts/sync_listings.py
+++ b/scripts/sync_listings.py
@@ -20,6 +20,7 @@
 
 import argparse
 import datetime
+import html
 import os
 import re
 import subprocess
@@ -95,11 +96,13 @@ def topic(self) -> str:
         return t
 
 
-def _extract(pattern: re.Pattern, html: str, label: str, path: Path) -> str:
-    m = pattern.search(html)
+def _extract(pattern: re.Pattern, page: str, label: str, path: Path) -> str:
+    m = pattern.search(page)
     if not m:
         raise SystemExit(f"ERROR: missing {label} in {path}")
-    return m.group(1).strip()
+    # HTML entities in the source decode to their characters so that
+    # renderers can re-escape per output format without double-encoding.
+    return html.unescape(m.group(1).strip())
 
 
 def discover_lectures(root: Path) -> list[Lecture]:
@@ -112,28 +115,56 @@ def discover_lectures(root: Path) -> list[Lecture]:
             continue
         idx = child / "index.html"
         if not idx.exists():
-            continue
-        html = idx.read_text(encoding="utf-8")
+            raise SystemExit(
+                f"ERROR: {child.name}/ matches the lecture naming pattern "
+                f"but has no index.html"
+            )
+        page = idx.read_text(encoding="utf-8")
         lectures.append(Lecture(
             num=m.group(1),
             slug=m.group(2),
-            raw_title=_extract(TITLE_RE, html, "<title>", idx),
-            desc=_extract(META_DESC_RE, html, '<meta name="description">', idx),
-            slide_count=len(SECTION_RE.findall(html)),
+            raw_title=_extract(TITLE_RE, page, "<title>", idx),
+            desc=_extract(META_DESC_RE, page, '<meta name="description">', idx),
+            slide_count=len(SECTION_RE.findall(page)),
             lastmod=git_lastmod(f"{child.name}/index.html", root),
         ))
     return lectures
 
 
+# Pre-flight validation. Reject metadata characters that would break the
+# rendered output: newlines collapse listings, "<!-- listings:auto" would
+# corrupt our own marker scan, and pipes break markdown tables. Keep this
+# strict so we fail fast instead of producing a malformed file.
+FORBIDDEN_SUBSTRINGS = ("<!-- listings:auto", "\n", "\r", "|")
+
+
+def validate_metadata(lectures: list[Lecture]) -> None:
+    for lec in lectures:
+        for field_name, value in (("<title>", lec.raw_title),
+                                  ("<meta description>", lec.desc)):
+            for bad in FORBIDDEN_SUBSTRINGS:
+                if bad in value:
+                    label = repr(bad) if bad.strip() else "newline/CR"
+                    raise SystemExit(
+                        f"ERROR: {lec.dir_name}/index.html {field_name} "
+                        f"contains forbidden substring {label}: {value!r}"
+                    )
+
+
 # --- renderers ---------------------------------------------------------------
 
+def _h(value: str) -> str:
+    """Escape for HTML/XML text content and attribute values."""
+    return html.escape(value, quote=True)
+
+
 def render_sitemap(lectures: list[Lecture]) -> str:
     parts = []
     for lec in lectures:
         parts.append(
             "  <url>\n"
-            f"    <loc>{lec.url}</loc>\n"
-            f"    <lastmod>{lec.lastmod}</lastmod>\n"
+            f"    <loc>{_h(lec.url)}</loc>\n"
+            f"    <lastmod>{_h(lec.lastmod)}</lastmod>\n"
             "    <changefreq>monthly</changefreq>\n"
             "    <priority>0.8</priority>\n"
             "  </url>"
@@ -153,17 +184,24 @@ def render_index_html(lectures: list[Lecture]) -> str:
     for lec in lectures:
         blocks.append(
             "    <li>\n"
-            f'      <a class="title" href="{lec.dir_name}/">{lec.num} — {lec.topic}</a>\n'
-            f'      <div class="desc">{lec.desc}</div>\n'
+            f'      <a class="title" href="{_h(lec.dir_name)}/">'
+            f"{_h(lec.num)} — {_h(lec.topic)}</a>\n"
+            f'      <div class="desc">{_h(lec.desc)}</div>\n'
             "    </li>"
         )
     return "\n".join(blocks)
 
 
 def render_readme_table(lectures: list[Lecture]) -> str:
+    # `|` and newlines are blocked at validate_metadata(); escape angle
+    # brackets so values like `<X>` do not get treated as raw HTML by
+    # markdown renderers.
+    def md(v: str) -> str:
+        return v.replace("<", "&lt;").replace(">", "&gt;")
+
     return "\n".join(
         f"| [`{lec.dir_name}/`](./{lec.dir_name}/index.html) "
-        f"| {lec.topic} | {lec.slide_count} 枚 |"
+        f"| {md(lec.topic)} | {lec.slide_count} 枚 |"
         for lec in lectures
     )
 
@@ -231,6 +269,7 @@ def main() -> int:
     if not lectures:
         print("No lectures discovered.", file=sys.stderr)
         return 2
+    validate_metadata(lectures)
 
     file_text: dict[str, str] = {}
     drifted: list[tuple[str, str]] = []