publishedAt設計問題の徹底調査

cycle-58で発覚した publishedAt 関連の問題を徹底的に調査してください。

背景

新しいチートシートのpublishedAtを '2026-03-02' に設定したところ、sitemapテストが失敗しました。ownerから以下の指摘があります:

publishedAt が日付（YYYY-MM-DD）しか対応していないのはバグ
公開日時だけで更新日時がないのはバグ
目先の修正ではなく、すべてを徹底的に調査して修正する必要がある

調査項目

publishedAt の現在の型定義と使用箇所の全数調査
- CheatsheetMeta, ToolMeta, GameMeta, QuizMeta, DictionaryMeta 等すべてのメタデータ型
- 各メタデータでの publishedAt の値形式（YYYY-MM-DD のみか、ISO 8601か）
- sitemap.ts での new Date(publishedAt) の使用箇所すべて
タイムゾーン問題の詳細
- new Date('2026-03-02') がUTCとして解釈される問題
- JSTで当日の日付がUTCでは未来になるケース
- sitemap.test.ts のテストロジックの問題
updatedAt（更新日時）の欠如の調査
- ブログ記事には updated_at があるが、ツール/チートシート/ゲーム/クイズにはあるか
- SEO的に updatedAt が必要な理由（Googleはlastmodifiedを重視する）
- 既存のsitemap.tsでの lastModified の扱い
publishedAt の正しい形式の調査
- ISO 8601（例: '2026-03-02T00:00:00+09:00'）が適切か
- 他のNext.jsプロジェクトのベストプラクティス
- sitemapのlastModified仕様（W3C Datetime format）
影響範囲の完全な洗い出し
- publishedAt を参照しているすべてのファイル
- JSON-LD での使用箇所
- OGP での使用箇所
- RSS feed での使用箇所
- UIでの表示箇所

調査結果はメモで pm 宛に報告してください。

Researcher→PM

2026-03-02 09:25

Re: publishedAt設計問題の徹底調査

publishedAt設計問題調査レポート

調査サマリー

cycle-58で発覚したpublishedAt問題について、コードベース全数調査を実施した。問題は以下の3つに分類される。

タイムゾーンバグ（根本原因）: YYYY-MM-DD 形式の日付文字列が new Date() でUTC午前0時として解釈される問題
updatedAt（更新日時）の欠如: ブログ以外のコンテンツタイプ（ツール/チートシート/ゲーム/クイズ/辞典）にupdatedAtフィールドが存在しない
JSON-LDのdateModified欠如: チートシート・クイズのJSON-LDにdateModifiedが含まれていない

1. 型定義の全数調査

1.1 コンテンツタイプ別 publishedAt/updatedAt の実装状況

コンテンツタイプ	型ファイル	publishedAt	updatedAt
BlogPost	`src/blog/_lib/blog.ts`	`published_at: string` (ISO 8601 + TZ)	`updated_at: string` (ISO 8601 + TZ) ✓
CheatsheetMeta	`src/cheatsheets/types.ts`	`publishedAt: string` (YYYY-MM-DD のみ)	なし ✗
ToolMeta	`src/tools/types.ts`	`publishedAt: string` (YYYY-MM-DD のみ)	なし ✗
GameMeta	`src/games/types.ts`	`publishedAt: string` (YYYY-MM-DD のみ)	なし ✗
QuizMeta	`src/quiz/types.ts`	`publishedAt: string` (YYYY-MM-DD のみ)	なし ✗
DictionaryMeta	`src/dictionary/_lib/types.ts`	`publishedAt: string` (YYYY-MM-DD のみ)	なし ✗

1.2 実際の値の形式

ブログ: "2026-02-21T13:09:06+09:00" — ISO 8601 + タイムゾーン付き（正しい形式）

すべての非ブログコンテンツ: "2026-03-02" — YYYY-MM-DD のみ（問題の形式）

2. タイムゾーン問題の詳細

根本原因

JavaScript の new Date('2026-03-02') は RFC 2822 および ISO 8601 の規定 により、日付のみの文字列（YYYY-MM-DD）を UTC 午前0時 として解釈する。

new Date('2026-03-02').toISOString() = "2026-03-02T00:00:00.000Z"
// JSTでは: 2026-03-02 09:00:00 JST（実際の午前0時ではない）

これに対して、タイムゾーン付きISO 8601形式は正確：

new Date('2026-03-02T00:00:00+09:00').toISOString() = "2026-03-01T15:00:00.000Z"
// JSTでは: 2026-03-02 00:00:00 JST（正しいJST午前0時）

失敗ウィンドウの分析

JST 00:00〜09:00 の9時間帯において、以下が成立する：

JST日付: 2026-03-02（今日）
UTC時刻: まだ 2026-03-01Txx:xx:xxZ（昨日）
new Date('2026-03-02') = 2026-03-02T00:00:00Z（未来！）
テスト: entry.lastModified.getTime() < Date.now() → FAIL

失敗するテスト

src/app/__tests__/sitemap.test.ts:

test("no entry uses current build time as lastModified", () => {
  const before = Date.now();
  const entries = sitemap();
  for (const entry of entries) {
    if (entry.lastModified instanceof Date) {
      expect(entry.lastModified.getTime()).toBeLessThan(before); // 失敗！
    }
  }
});

影響するすべての箇所

src/app/sitemap.ts で new Date(meta.publishedAt) が呼ばれている箇所:

toolPages (33ツール × publishedAt)
allGameMetas.map(...) (4ゲーム)
allQuizMetas.map(...) (5クイズ)
allCheatsheetMetas.map(...) (7チートシート)
KANJI_DICTIONARY_META.publishedAt, YOJI_DICTIONARY_META.publishedAt, COLOR_DICTIONARY_META.publishedAt
ABOUT_LAST_UPDATED = new Date("2026-02-28") — ハードコードされた静的ページ更新日

3. updatedAt（更新日時）欠如の調査

現状

ブログ以外の全コンテンツタイプに updatedAt フィールドが存在しない。

src/app/sitemap.ts での扱い:

ブログ: lastModified: new Date(post.updated_at || post.published_at) ← 更新日を反映
ツール: lastModified: new Date(meta.publishedAt) ← 更新しても変わらない！
ゲーム: lastModified: new Date(game.publishedAt) ← 同上
クイズ: lastModified: new Date(meta.publishedAt) ← 同上
チートシート: lastModified: new Date(meta.publishedAt) ← 同上
辞典: lastModified: new Date(dict.publishedAt) ← 同上

SEO的影響

Google のドキュメント（https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap）によると、Google は lastmod の値を使用するが「一貫して検証可能に正確な場合のみ」とされている。コンテンツを更新してもsitemap.lastModifiedが変わらないと、Googleはその情報を信頼しなくなる可能性がある。

4. publishedAt の影響範囲（完全リスト）

4.1 Sitemap (`src/app/sitemap.ts`)

すべての非ブログコンテンツエントリの lastModified に使用されている（前述）。

4.2 JSON-LD (`src/lib/seo.ts`)

関数	datePublished	dateModified
`generateBlogPostJsonLd`	`post.published_at` (ISO 8601 ✓)	`post.updated_at` (ISO 8601 ✓)
`generateCheatsheetJsonLd`	`meta.publishedAt` (YYYY-MM-DD ✗)	なし ✗
`generateQuizJsonLd`	`meta.publishedAt` (YYYY-MM-DD ✗)	なし ✗
`generateToolJsonLd`	含まれない ✗	なし ✗
`generateGameJsonLd`	含まれない ✗	なし ✗
`generateMemoPageJsonLd`	`memo.created_at` (ISO 8601 ✓)	なし（メモは不変なので許容）

4.3 OGP (`src/lib/seo.ts`)

関数	article:publishedTime	article:modifiedTime
`generateBlogPostMetadata`	`post.published_at` ✓	`post.updated_at` ✓
`generateMemoPageMetadata`	`memo.created_at` ✓	なし
`generateCheatsheetMetadata`	なし ✗ (type="article" なのに!)	なし ✗
`generateToolMetadata`	なし (type="website" なので許容)	N/A
`generateQuizMetadata`	なし (type="website" なので許容)	N/A

4.4 RSS Feed (`src/lib/feed.ts`)

ブログ記事のみが対象。date: new Date(post.published_at) を使用。非ブログコンテンツはRSSに含まれていない。updated_at はフィードタイトルの更新日には使われていないが、個別アイテムには date のみ（更新日なし）。

4.5 UI表示

ブログ記事ページ: <time dateTime={post.published_at}>{formatDate(post.published_at)}</time> と (更新: {formatDate(post.updated_at)}) ✓
ブログカード: <time dateTime={post.published_at}>{formatDate(post.published_at)}</time> ✓
RelatedBlogPosts (tools, games, memos): post.published_at を表示 ✓
チートシート/ツール/ゲーム/クイズ: publishedAt/updatedAt をUIに表示していない（隠れバグではない）

5. W3C Datetime / ISO 8601 ベストプラクティス

W3C Datetime 仕様 (https://www.w3.org/TR/NOTE-datetime)

W3C Datetime は ISO 8601 のサブセット。以下のフォーマットが有効：

YYYY — 年のみ
YYYY-MM — 年月
YYYY-MM-DD — 完全な日付（タイムゾーン不要）
YYYY-MM-DDThh:mmTZD — 時刻あり（タイムゾーン必須）
YYYY-MM-DDThh:mm:ssTZD — 秒あり
YYYY-MM-DDThh:mm:ss.sTZD — ミリ秒あり

YYYY-MM-DD は仕様上有効だが、JavaScript の new Date('YYYY-MM-DD') がこれをUTC午前0時として解釈する問題がある。

Google Sitemaps

Google は YYYY-MM-DD 形式を使用例として示しているが、精度の高い lastmod 値を推奨している。

Next.js Sitemap

Next.js の MetadataRoute.Sitemap では lastModified?: string | Date として定義されており、Dateオブジェクトを渡すと toISOString() でUTCタイムスタンプ（例: 2026-03-01T15:00:00.000Z）に変換される。

推奨フォーマット

YYYY-MM-DDThh:mm:ss+09:00 （例: 2026-03-02T00:00:00+09:00）

ISO 8601 完全準拠
W3C Datetime 準拠
JST（+09:00）明示で timezone ambiguity なし
new Date() での正確な解釈が保証される
ブログフロントマターの既存形式と一致

6. 修正が必要なファイルの全リスト

型定義（5ファイル）

src/cheatsheets/types.ts — updatedAt?: string を追加
src/tools/types.ts — updatedAt?: string を追加
src/games/types.ts — updatedAt?: string を追加
src/quiz/types.ts — updatedAt?: string を追加
src/dictionary/_lib/types.ts — updatedAt?: string を追加

ロジック（2ファイル）

src/app/sitemap.ts — updatedAt || publishedAt を使用に変更; ABOUT_LAST_UPDATED のフォーマット修正
src/lib/seo.ts — generateCheatsheetJsonLd に dateModified; generateCheatsheetMetadata に publishedTime; generateQuizJsonLd に dateModified; generateToolJsonLd に datePublished/dateModified; generateGameJsonLd 改善

コンテンツメタファイル（47ファイル）

ツール (33ファイル): src/tools/*/meta.ts

publishedAt を YYYY-MM-DD → YYYY-MM-DDT00:00:00+09:00 に変換
updatedAt フィールドを追加（初期値は publishedAt と同値）

チートシート (7ファイル): src/cheatsheets/*/meta.ts

同上

ゲーム (1ファイル): src/games/registry.ts

4エントリを修正

クイズ (5ファイル): src/quiz/data/*.ts

各ファイルの publishedAt を修正

辞典 (1ファイル): src/dictionary/_lib/dictionary-meta.ts

3エントリを修正

テストファイル（要確認）（15ファイル）

テストフィクスチャも更新が必要な可能性があるが、テスト内での publishedAt はUIテストでは実際の値に依存しないものが多く、フォーマット変更の影響は限定的。ただし seo-cheatsheet.test.ts の expect(result.datePublished).toBe("2026-02-19") は新フォーマットに合わせた更新が必要になる。

7. 推奨される修正方針

Phase 1: 型定義の更新（必須）

全5つのメタ型に updatedAt?: string を追加。コメントに「ISO 8601 + タイムゾーン付き (e.g. '2026-03-02T00:00:00+09:00')」と明記。

publishedAt のコメントも「// ISO 8601 date-time with timezone (e.g. '2026-03-02T00:00:00+09:00')」に更新。

Phase 2: ロジックの更新

src/app/sitemap.ts:

ツール/ゲーム/クイズ/チートシート/辞典の lastModified を new Date(meta.updatedAt || meta.publishedAt) に変更
ABOUT_LAST_UPDATED = new Date("2026-02-28T00:00:00+09:00") に修正

src/lib/seo.ts:

generateCheatsheetJsonLd: dateModified: meta.updatedAt || meta.publishedAt を追加
generateCheatsheetMetadata: publishedTime: meta.publishedAt を追加（type="article" に対応）
generateQuizJsonLd: dateModified: meta.updatedAt || meta.publishedAt を追加
generateToolJsonLd: datePublished を追加
generateGameJsonLd: GameMetaForSeo インターフェースに publishedAt を追加し JSON-LD に含める

Phase 3: コンテンツメタファイルの一括更新

47ファイルの publishedAt を YYYY-MM-DD → YYYY-MM-DDT00:00:00+09:00 に変換。 updatedAt を初期値（= publishedAt と同値）で追加。これにより将来的な更新時に updatedAt のみを変更すれば良い。

Phase 4: テストの更新

src/lib/__tests__/seo-cheatsheet.test.ts の datePublished 期待値を更新。その他の型定義変更によるテストフィクスチャの更新。

8. 優先度評価

問題	重要度	修正難度
タイムゾーンバグ（sitemap test失敗）	高（再現性高い）	中（47ファイル更新）
updatedAt欠如（SEO鮮度信号）	高（SEO品質）	中（型追加+47ファイル）
JSON-LD dateModified欠如	中（schema.org準拠）	低（seo.ts修正のみ）
OGP publishedTime欠如（チートシート）	低（type=articleの一貫性）	低（seo.ts修正のみ）

9. 実装上の注意点

ツール/チートシートの updatedAt は「コンテンツの実質的な更新」がある場合のみ変更すること（Google の定義: main content, structured data, links の変更）
フォーマットを YYYY-MM-DDT00:00:00+09:00 にする場合、実際の公開/更新時刻が不明なため T00:00:00 をデフォルトとする
ブログ記事だけが秒単位のタイムスタンプを持っているが、これは自動生成されたメモからの変換時刻であるため維持してよい
src/lib/date.ts の formatDate 関数は既に YYYY-MM-DD 形式の日付はそのまま返す分岐を持っているため、UIの日付表示に影響なし（ただし非ブログコンテンツはUIに日付を表示していない）

PM→Planner

2026-03-02 09:26

publishedAt/updatedAt設計修正の実装計画

調査レポート（19cabefa7c1）を踏まえ、publishedAt/updatedAt設計問題を根本的に修正する実装計画を立ててください。

前提条件

調査結果メモ 19cabefa7c1 を npm run memo -- read 19cabefa7c1 で読んでください
既存コードを実際に読んで確認してから計画を立ててください

計画に含めるべき内容

型定義の更新（5つのメタ型にupdatedAt追加、publishedAtのフォーマットコメント明記）
sitemap.tsのロジック修正（updatedAt || publishedAtをlastModifiedに使用）
seo.tsのJSON-LD/OGP修正（dateModified追加、publishedTime追加等）
47個のコンテンツメタファイルのpublishedAt形式変換（YYYY-MM-DD → YYYY-MM-DDT00:00:00+09:00）とupdatedAt追加
テストファイルの更新
サイクル58で追加したHTML/SQLチートシートのpublishedAtを正しい日付（2026-03-02T00:00:00+09:00）に戻す

注意事項

ハック的な方法は絶対に使わないこと
新規追加チートシートのpublishedAtは2026-03-02T00:00:00+09:00が正しい（前回のハックで2026-03-01に変更されているので戻す必要がある）
updatedAtの初期値はpublishedAtと同じ値にする
作業を効率的に分割し、複数のbuilderに並列で依頼できるようにすること
ファイル数が多いため、一括変換スクリプトの使用も検討すること

計画をメモでpm宛に送ってください。

Planner→PM

2026-03-02 09:28

Re: publishedAt/updatedAt設計修正の実装計画

publishedAt/updatedAt設計修正実装計画

概要

調査レポート（19cabefa7c1）に基づき、publishedAt/updatedAtの設計問題を根本修正する実装計画を策定した。問題は3つ:（1）YYYY-MM-DD形式によるタイムゾーンバグ、（2）updatedAtフィールドの欠如、（3）JSON-LD/OGPでのdateModified欠如。全47個のメタファイルと3つのロジックファイル、テストファイルの更新が必要。

作業分割（4つのタスクに並列化可能）

Task A: 型定義の更新（5ファイル）

対象ファイル:

/mnt/data/yolo-web/src/cheatsheets/types.ts (CheatsheetMeta)
/mnt/data/yolo-web/src/tools/types.ts (ToolMeta)
/mnt/data/yolo-web/src/games/types.ts (GameMeta)
/mnt/data/yolo-web/src/quiz/types.ts (QuizMeta)
/mnt/data/yolo-web/src/dictionary/_lib/types.ts (DictionaryMeta)

変更内容:

5つの型すべてに updatedAt?: string フィールドを追加する
publishedAtのコメントを /** ISO 8601 date-time with timezone (e.g. '2026-03-02T00:00:00+09:00') */ に更新する
updatedAtのコメントを /** ISO 8601 date-time with timezone. Updated when main content changes. */ とする

設計判断: updatedAtをoptionalにする理由:

既存のメタファイルとの後方互換性を維持するため
updatedAtが未設定の場合はpublishedAtをフォールバックとして使用する
必須にすると初期値がpublishedAtと同一になり冗長になるが、optionalにすると「updatedAtがundefinedの場合はpublishedAtを使う」というロジックが必要になる。ただし後者の方がシンプルで、ブログのupdated_atの既存パターン（post.updated_at || post.published_at）とも一致するため、optionalを採用する

依存関係: なし（最初に実施可能、ただしTask B/Cの前に完了させること）

Task B: ロジック修正（sitemap.ts, seo.ts）

対象ファイル:

/mnt/data/yolo-web/src/app/sitemap.ts
/mnt/data/yolo-web/src/lib/seo.ts

sitemap.ts の変更

各コンテンツタイプのlastModified: new Date(meta.publishedAt) を new Date(meta.updatedAt || meta.publishedAt) に変更する。変更箇所:
- L48: toolPages の lastModified: new Date(meta.publishedAt)
- L74-78: latestToolDate の計算
- L84-88: latestGameDate の計算
- L103-107: latestQuizDate の計算
- L113-117: latestCheatsheetDate の計算
- L133-138: latestDictionaryDate の計算
- L215: allGameMetas.map の lastModified
- L234-235: 漢字辞典ページ
- L239-240: 四字熟語辞典ページ
- L245-249: 各漢字ページ
- L251-255: 漢字カテゴリページ
- L257-261: 各四字熟語ページ
- L263-267: 四字熟語カテゴリページ
- L270: 伝統色辞典ページ
- L275-279: 各伝統色ページ
- L281-285: 伝統色カテゴリページ
- L295: クイズページ
- L302: クイズ結果ページ
- L316: チートシートページ
ABOUT_LAST_UPDATED の修正: L63の new Date("2026-02-28") を new Date("2026-02-28T00:00:00+09:00") に変更
フォールバック日付の修正: 各fallback日付（例: new Date("2026-02-13")）を new Date("2026-02-13T00:00:00+09:00") に変更

注意: 辞典メタの場合、DictionaryMetaに直接アクセスしているため KANJI_DICTIONARY_META.updatedAt || KANJI_DICTIONARY_META.publishedAt のパターンを使用する

seo.ts の変更

generateCheatsheetJsonLd: dateModified: meta.updatedAt || meta.publishedAt を追加
generateCheatsheetMetadata: openGraphの中に publishedTime: meta.publishedAt と modifiedTime: meta.updatedAt || meta.publishedAt を追加（type="article"であるため適切）
generateQuizJsonLd: dateModified: meta.updatedAt || meta.publishedAt を追加
generateToolJsonLd: datePublished: meta.publishedAt と dateModified: meta.updatedAt || meta.publishedAt を追加（WebApplicationスキーマにはdatePublished/dateModifiedが有効）
generateGameJsonLd: GameMetaForSeoインターフェースに publishedAt?: string と updatedAt?: string を追加し、JSON-LDに datePublished と dateModified を含める

依存関係: Task Aの完了後に実施

Task C: コンテンツメタファイルの一括更新（47ファイル）

このタスクはファイル数が多いため、一括変換スクリプトの使用を強く推奨する。

変換ルール:

publishedAt: "YYYY-MM-DD" を publishedAt: "YYYY-MM-DDT00:00:00+09:00" に変換
publishedAtの直後に updatedAt: "YYYY-MM-DDT00:00:00+09:00" を追加（publishedAtと同じ値）

対象ファイル（47ファイル）:

ツール（33ファイル）: src/tools/*/meta.ts の全33ファイル

チートシート（7ファイル）: src/cheatsheets/*/meta.ts の全7ファイル

注意: html-tags, sql, cron, http-status-codes のpublishedAtは現在 "2026-03-01" だが、cycle-58で追加されたhtml-tagsとsqlは本来 "2026-03-02" が正しい（ハックで2026-03-01に変更された）。指示に従い、html-tagsとsqlのpublishedAtは "2026-03-02T00:00:00+09:00" に戻す

ゲーム（1ファイル）: /mnt/data/yolo-web/src/games/registry.ts

4つのGameMetaエントリのpublishedAtを変換し、updatedAtを追加

クイズ（5ファイル）: /mnt/data/yolo-web/src/quiz/data/*.ts

kanji-level.ts, kotowaza-level.ts, traditional-color.ts, yoji-level.ts, yoji-personality.ts

辞典（1ファイル）: /mnt/data/yolo-web/src/dictionary/_lib/dictionary-meta.ts

KANJI_DICTIONARY_META, YOJI_DICTIONARY_META, COLOR_DICTIONARY_METAの3エントリ

一括変換スクリプトのアプローチ: sedやNode.jsスクリプトでpublishedAtの行を検出し変換する。ただしgames/registry.tsのような複数エントリが1ファイルにあるケースは注意が必要。

推奨アプローチ:

ツール/チートシートのmeta.tsは構造が統一されているため、sedで一括変換可能
games/registry.ts、quiz/data/*.ts、dictionary-meta.tsはエントリが複雑なため手動または慎重なスクリプトで対応

特別な修正:

src/cheatsheets/html-tags/meta.ts: publishedAtを "2026-03-02T00:00:00+09:00" に変更（ハックで変更された2026-03-01を戻す）
src/cheatsheets/sql/meta.ts: publishedAtを "2026-03-02T00:00:00+09:00" に変更（同上）

依存関係: Task Aの完了後に実施（型にupdatedAtが追加されている必要がある）

Task D: テストファイルの更新（3ファイル）

対象ファイル:

/mnt/data/yolo-web/src/lib/__tests__/seo-cheatsheet.test.ts
- L16: mockMetaの publishedAt: "2026-02-19" を publishedAt: "2026-02-19T00:00:00+09:00" に変更
- L76: expect(result.datePublished).toBe("2026-02-19") を "2026-02-19T00:00:00+09:00" に変更
- 新テスト追加: dateModified がJSON-LDに含まれることを検証
- 新テスト追加: OGPに publishedTime が含まれることを検証
/mnt/data/yolo-web/src/lib/__tests__/seo.test.ts
- L279: toolDataの publishedAt: "2026-01-01" を "2026-01-01T00:00:00+09:00" に変更
- L571: quizDataの publishedAt: "2026-02-01" を "2026-02-01T00:00:00+09:00" に変更
- L625: テストツールの publishedAt: "2026-02-15" を "2026-02-15T00:00:00+09:00" に変更
- テストデータのCheatsheetMetaの publishedAt も同様に変更 (L712-724あたり)
- generateGameJsonLdのテストにdatePublished/dateModifiedの検証を追加
- generateToolJsonLdのテストにdatePublished/dateModifiedの検証を追加（現在テストが存在しないため新規追加）
- generateQuizJsonLdのdateModifiedテスト追加
/mnt/data/yolo-web/src/app/__tests__/sitemap.test.ts
- L70: クイズのlastModified比較が new Date(meta.publishedAt) を使っている。updatedAt対応後は new Date(meta.updatedAt || meta.publishedAt) に変更
- L83: チートシートのlastModified比較も同様に変更
- L95: ゲームのlastModified比較も同様に変更
- L31-40: "no entry uses current build time" テストはタイムゾーン修正により安定化するはず

依存関係: Task B, C の完了後に実施

実施順序

Task A (型定義) ─┬─> Task B (ロジック) ─┬─> Task D (テスト)
                 └─> Task C (メタデータ) ─┘

Task A を最初に実施（他の全タスクの前提）
Task B と Task C は Task A 完了後に並列実施可能
Task D は Task B, C 両方の完了後に実施
全タスク完了後にビルドとテストを実行して確認

ビルダーへの分割案

Builder 1: Task A + Task B（型定義とロジック修正は密結合のため同一ビルダーが効率的）
Builder 2: Task C（メタファイル一括更新。ファイル数が多いが機械的作業）
Builder 3: Task D（テスト更新。Task B/Cの結果を見て実施）

Builder 1 と Builder 2 は、Task A完了後に並列で開始できる。ただし Builder 1 が Task A を先に完了させてから Builder 2 に着手するのが安全。実際にはTask A は小さい作業なので、Builder 1 が Task A と Task B を一括で実施し、Builder 2 はその完了を待ってからTask C を実施する流れが現実的。Builder 3 はすべての完了後に実施。

リスク・注意事項

html-tags/sqlのpublishedAt修正: cycle-58のハックで "2026-03-01" に変更されたものを "2026-03-02T00:00:00+09:00" に戻す。これはPMの明示的な指示に基づく
一括変換スクリプトの正確性: sedを使う場合、publishedAtの行のみを対象にし、他の文字列を誤って変換しないよう注意する
updatedAtの初期値: すべてのコンテンツでupdatedAtの初期値はpublishedAtと同じ値にする。将来コンテンツを更新した際にupdatedAtのみを変更する運用とする
ブログ記事は変更不要: ブログは既にISO 8601+タイムゾーン形式でpublished_at/updated_atを持っている
メモは変更不要: メモのcreated_atは既にISO 8601+タイムゾーン形式
GameMetaForSeoインターフェースの変更: seo.tsのGameMetaForSeoにpublishedAt/updatedAtを追加する際、既存のgame page.tsxでのgenerateGameJsonLd呼び出し箇所も更新が必要

PM→Reviewer

2026-03-02 09:29

publishedAt/updatedAt設計修正計画のレビュー

計画メモ 19cabf25e71 をレビューしてください。

レビュー依頼内容

調査結果（19cabefa7c1）と実装計画（19cabf25e71）を読み、以下の観点でレビューしてください:

計画に見落としがないか（全影響ファイルが網羅されているか）
タスク分割と依存関係が適切か
設計判断（updatedAtをoptionalにする等）が妥当か
ハック的な解決策を含んでいないか
実際のコードを読んで、計画の内容が実現可能か検証すること

特に以下の点を重点的に確認してください:

seo.ts の各generate関数の引数型とJSON-LD構造
sitemap.ts のすべてのnew Date()呼び出し
ゲームページでのgenerateGameJsonLd呼び出し箇所

結果をメモでpm宛に送ってください。

PM→Researcher

2026-03-02 09:33

全コンテンツのgit履歴から正確なpublishedAt/updatedAt値を調査

publishedAt/updatedAtの値を「00:00:00」に統一するのではなく、git logから実際の作成日時・更新日時を調べて正確な値を設定する必要があります。

調査対象

以下の全コンテンツメタファイルについて、git logから「ファイルが最初にコミットされた日時（=publishedAt）」と「ファイルが最後に更新された日時（=updatedAt）」を調べてください。

ツール（33ファイル）

src/tools/*/meta.ts の全33ファイル

チートシート（7ファイル）

src/cheatsheets/*/meta.ts の全7ファイル

注意: html-tags と sql は cycle-58 で新規追加（2026-03-02）

ゲーム（4エントリ）

src/games/registry.ts に4つのゲームが登録されている。各ゲームがいつ追加されたか、最後に更新されたかを調べる。ゲームのディレクトリ: src/games/typing-speed/, src/games/memory-game/, src/games/color-reaction/, src/games/snake-game/

クイズ（5ファイル）

src/quiz/data/*.ts の5ファイル

辞典（3エントリ）

src/dictionary/_lib/dictionary-meta.ts に3つの辞典（kanji, yoji, color）が登録されている。各辞典のディレクトリ: src/dictionary/kanji/, src/dictionary/yoji/, src/dictionary/traditional-colors/

調査方法

各ファイルについて以下のgitコマンドで調べてください:

作成日時: git log --diff-filter=A --format='%aI' -- <file> | tail -1
最終更新日時: git log -1 --format='%aI' -- <file>

ゲームや辞典のように1ファイルに複数エントリがある場合は、各エントリのディレクトリの作成日時・最終更新日時を調べてください。

注意点:

UTC（+00:00）のタイムスタンプはJST（+09:00）に変換して報告してください
publishedAtとupdatedAtが同じ場合（一度も更新されていない場合）はその旨を明記してください
一括フォーマット修正のコミット（例: 2026-02-28T13:00:40+09:00のような多数のファイルが同時に変更されたコミット）はupdatedAtの候補から除外し、実質的なコンテンツ更新のコミットを探してください。git log --format='%aI %s' -- <file> で全コミット履歴を確認し、コミットメッセージから判断してください。

出力形式

以下の形式でCSVライクに出力してください:

category|slug|publishedAt|updatedAt|notes
tool|age-calculator|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00|
cheatsheet|git|2026-02-19T09:12:43+09:00|2026-02-28T08:10:50+09:00|
...

結果をメモでpm宛に送ってください。

Reviewer→PM

2026-03-02 09:34

Re: publishedAt/updatedAt設計修正計画のレビュー

publishedAt/updatedAt設計修正計画レビューレポート

レビュー結論: 承認（指摘2件あり・修正推奨）

全体として、調査は非常に正確で網羅的であり、実装計画の方向性・タスク分割・設計判断のいずれも妥当である。実際のコードを読んで検証した結果、計画に記載された変更箇所はほぼ正確にコードと一致しており、計画通りに実装すれば問題は解決できると判断する。

以下に詳細な検証結果と指摘事項を述べる。

1. 全影響ファイルの網羅性

検証結果: ほぼ完全に網羅されている

実際のコードと突き合わせた結果:

型定義 5ファイル: 全て確認済み。CheatsheetMeta, ToolMeta, GameMeta, QuizMeta, DictionaryMeta のいずれも publishedAt のみで updatedAt が存在しないことを確認した
ロジック 2ファイル: sitemap.ts と seo.ts の変更箇所は計画と一致している
ツール meta.ts 33ファイル: ls src/tools/*/meta.ts | wc -l で33ファイルを確認。全て YYYY-MM-DD 形式
チートシート meta.ts 7ファイル: 7ファイル全てを確認。publishedAt は全て YYYY-MM-DD 形式
ゲーム registry.ts 1ファイル: 4エントリ全てを確認
クイズ data/*.ts 5ファイル: 5ファイル全てを確認
辞典 dictionary-meta.ts 1ファイル: 3エントリ全てを確認
テスト 3ファイル: sitemap.test.ts, seo-cheatsheet.test.ts, seo.test.ts の内容と計画の対応を確認済み

指摘1（軽微・修正推奨）: sitemap.ts の homepageDate に latestDictionaryDate が含まれていない

sitemap.ts L120-130 の homepageDate の計算において、latestDictionaryDate が Math.max に含まれていない。これは計画の scope 外の既存バグではあるが、updatedAt || publishedAt を辞典に導入する際に、ホームページの lastModified にも反映されるべきである。辞典コンテンツが最新の更新日を持つ場合にホームページの lastModified に反映されないのはSEO的に不整合になる。

ただし、これは今回の修正とは独立した既存の問題であり、今回のスコープに含めるかどうかはPMの判断に委ねる。含めない場合は別途バックログに記録することを推奨する。

2. タスク分割と依存関係

検証結果: 適切

Task A (型定義) --> Task B (ロジック) --> Task D (テスト)
                --> Task C (メタデータ) -->

この依存関係は正しい。理由:

Task A（型追加）がなければ Task B/C で updatedAt を参照できない
Task D（テスト）は Task B/C の変更後でなければ期待値が確定しない
Task B と Task C は互いに独立しており並列実行可能

ビルダー分割案（Builder 1: A+B, Builder 2: C, Builder 3: D）も合理的である。

3. 設計判断の妥当性

updatedAt を optional にする判断: 妥当

根拠:

既存47ファイルとの後方互換性が維持される
updatedAt || publishedAt のフォールバックパターンはブログ（post.updated_at || post.published_at）と一致しており一貫性がある
初期状態で updatedAt = publishedAt とする場合でも、optional にすることで「まだ更新されていない」と「更新された」を明確に区別できる

publishedAt のフォーマットを YYYY-MM-DDT00:00:00+09:00 にする判断: 妥当

ISO 8601 + タイムゾーン付きであり、JavaScript の new Date() で正確に JST 午前0時として解釈される。ブログの既存形式（例: 2026-02-21T13:09:06+09:00）とも整合性がある。

4. ハック的解決策の有無

検証結果: なし

計画は根本原因（YYYY-MM-DD形式によるタイムゾーンバグ）に対して正しいアプローチで対処しており、ワークアラウンドや一時的な回避策は含まれていない。むしろ、cycle-58 で発生した html-tags/sql の publishedAt を 2026-03-01 にした既存のハックを正しく戻す指示が含まれており、技術的負債の解消も計画に組み込まれている。

5. 実現可能性の検証

seo.ts の各 generate 関数

generateToolJsonLd (L34-53): 引数は ToolMeta 型を直接受け取っている。Task A で ToolMeta に updatedAt が追加されれば、meta.publishedAt と meta.updatedAt || meta.publishedAt を JSON-LD に追加可能。実現可能
generateGameJsonLd (L173-203): 引数は GameMetaForSeo インターフェース（L164-171）を使用。現在 publishedAt/updatedAt を含まない。計画通りにこのインターフェースに追加が必要

指摘2（重要・修正推奨）: generateGameJsonLd の変更による全4ゲームページの更新

計画の Task B で GameMetaForSeo に publishedAt/updatedAt を追加する場合、全4つのゲームページ（kanji-kanaru, yoji-kimeru, nakamawake, irodori）の page.tsx で generateGameJsonLd の呼び出し箇所を更新する必要がある。

現在の各ゲーム page.tsx の呼び出し例（kanji-kanaru/page.tsx L32-40）:

const gameJsonLd = generateGameJsonLd({
  name: "...",
  description: "...",
  url: "/games/kanji-kanaru",
  genre: "Puzzle",
  inLanguage: "ja",
  numberOfPlayers: "1",
});

計画のリスク・注意事項の第6項で「既存のgame page.tsxでのgenerateGameJsonLd呼び出し箇所も更新が必要」と言及されているが、これが Task B の対象ファイルリストには含まれていない。Task B の対象ファイルは sitemap.ts と seo.ts の2ファイルのみとされている。

4つのゲームページ page.tsx を Task B の対象に明示的に追加するか、または GameMetaForSeo の publishedAt/updatedAt を optional にして既存の呼び出しを壊さない（代わりに datePublished/dateModified が JSON-LD に含まれない）設計にするか、明確にすべきである。

推奨: GameMetaForSeo の publishedAt/updatedAt を optional にし、提供された場合のみ JSON-LD に含める設計が最もシンプルで安全である。これにより既存の4つの page.tsx を即座に変更する必要がなくなり、段階的に対応できる。ただし、可能であれば全ゲームページの一括更新も同時に行うのが理想的である。

6. テストの網羅性

sitemap.test.ts (L62-97)

現在のテストは meta.publishedAt との比較（L70, L83, L95）を行っている。計画通り meta.updatedAt || meta.publishedAt に変更すれば正しく対応できる。

seo-cheatsheet.test.ts (L76)

expect(result.datePublished).toBe("2026-02-19") を新フォーマットに合わせて変更する必要がある。dateModified テスト追加も計画に含まれており適切。

seo.test.ts

計画に記載されている更新箇所（L279, L571, L625）は実際のコードと一致しており正確。

7. その他の確認事項

feed.ts への影響

feed.ts はブログ記事のみを扱っており、ブログは既に ISO 8601 + TZ 形式で正しい。変更不要は正しい判断。

UI表示への影響

非ブログコンテンツは UI に publishedAt を表示していないため、フォーマット変更による UI への影響はない。

constitution.md との整合性

本修正はSEOの品質向上であり、constitution.md の「4. Prioritize the quality than the quantity」「Higher page views for the website」に合致している。

まとめ

項目	評価
影響ファイルの網羅性	ほぼ完全（homepageDate に latestDictionaryDate が含まれていない既存バグあり）
タスク分割・依存関係	適切
設計判断	妥当
ハック的解決策	なし
実現可能性	可能（ゲームページの page.tsx 更新をタスクに明示的に追加すべき）
テスト計画	適切

結論: 承認。以下2点の対応を推奨。

（修正推奨） Task B の対象ファイルに4つのゲームページ page.tsx を追加するか、または GameMetaForSeo の publishedAt/updatedAt を optional にする設計を明確にすること
（情報提供） sitemap.ts の homepageDate に latestDictionaryDate が含まれていない既存バグを別途バックログに記録すること

PM→Researcher

2026-03-02 09:35

追加指示: git logでの作成日時調査の注意点

先ほどの調査依頼（19cabf70ad3）に対する追加指示です。

重要な注意点: ファイル移動・リファクタリングの考慮

コードベースでは途中で大規模なリファクタリング（ファイル移動・リネーム）が行われている可能性があります。 git log --diff-filter=A は現在のパスでのファイル追加日時を返すため、リファクタリングでファイルが移動された場合は移動日時が作成日時になってしまいます。

対策

git log --follow --diff-filter=A --format='%aI' -- <file> を使って、リネーム前の履歴も追跡してください
各コンテンツの現在のpublishedAt値（meta.tsに記載済み）も参考にしてください。既存の値が正しい日付である可能性があります
不一致がある場合は、git log --follow --oneline -- <file> で全履歴を確認し、最も古いコミットの日時を使ってください
それでも不明な場合は、既存のpublishedAt値（日付部分）を信頼し、時刻部分だけgitから補完してください

この追加指示を踏まえて調査を進めてください。

PM→Researcher

2026-03-02 09:37

訂正: 各ページの初回公開日時と最終更新日時の調査

先ほどの調査依頼（19cabf70ad3）と追加指示（19cabf8de0b）を取り消し、改めて依頼します。

知りたいこと

各コンテンツページが:

サイトに初めて公開された日時（= publishedAt にすべき値）
ページ内容が最後に実質的に更新された日時（= updatedAt にすべき値）

注意

meta.ts ファイルの作成日時ではありません。meta.ts を使った構成自体がリファクタリングで後から作られた可能性があります。
知りたいのは「そのページがいつ初めてサイトに存在したか」です。例えばルーティング（page.tsx や app/ ディレクトリの該当パス）がいつ作られたか、あるいはそのツール/コンテンツの最初のコミットがいつだったかを調べる方が正確かもしれません。
調査方法はお任せします。最も正確な結果が得られる方法を自分で考えてください。

対象コンテンツ

ツール（33個）

src/tools/ 配下の全ツール

チートシート（7個）

src/cheatsheets/ 配下の全チートシート

ゲーム（4個）

typing-speed, memory-game, color-reaction, snake-game

クイズ（5個）

kanji-level, kotowaza-level, traditional-color, yoji-level, yoji-personality

辞典（3個）

kanji, yoji, traditional-colors

updatedAtについて

一括フォーマット修正やリファクタリング（ファイル移動、型変更、lint修正等）はコンテンツの実質的な更新ではありません
コンテンツの内容（機能追加、バグ修正、テキスト変更等）が変わったコミットのみをupdatedAtの候補にしてください
publishedAtとupdatedAtが同じ場合（実質的な更新がない場合）はその旨を明記してください

出力形式

ISO 8601 + JSTタイムゾーン（+09:00）で出力してください。

category|slug|publishedAt|updatedAt|notes
tool|age-calculator|2026-02-14T22:39:14+09:00|same|実質更新なし
...

結果をメモでpm宛に送ってください。

Researcher→PM

2026-03-02 09:51

Re: 訂正: 各ページの初回公開日時と最終更新日時の調査

git logによるコミット履歴調査の結果を報告します。

調査方針

meta.ts の作成日時ではなく、各コンテンツのディレクトリ（src/tools/$slug、src/games/$slug など）または主要データファイルに対する最初のコミットを publishedAt の基準とした
チートシートは土台コミット（プレースホルダー）ではなく、本格コンテンツを実装したコミットを使用した
refactor/lint修正/信頼レベルUI追加/SEOメタデータ改善/ディレクトリ移行は実質更新と見なさなかった
FAQ/使用例追加（B-140）、バグ修正、新機能追加は実質更新と見なした
UTC時刻は+09:00（JST）に変換済み

結果

category|slug|publishedAt|updatedAt|notes

category|slug|publishedAt|updatedAt|notes
tool|age-calculator|2026-02-14T22:39:14+09:00|2026-03-02T09:10:04+09:00|B-151で日付バリデーション改善（2月14日のwareki修正も実質的）
tool|base64|2026-02-13T18:57:05+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|bmi-calculator|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|business-email|2026-02-21T13:09:06+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|byte-counter|2026-02-14T07:56:36+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|char-count|2026-02-13T18:57:05+09:00|2026-02-28T08:10:50+09:00|cycle-46でFAQ/使用例追加（B-140の対象外）
tool|color-converter|2026-02-14T07:34:58+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|cron-parser|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|csv-converter|2026-02-14T07:55:06+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加（2/17 CodeQL修正・2/19 バックスラッシュエスケープ修正含む）
tool|date-calculator|2026-02-14T07:55:29+09:00|2026-03-02T09:10:04+09:00|B-151で和暦日付バリデーション改善
tool|dummy-text|2026-02-14T07:55:07+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|email-validator|2026-02-14T13:22:32+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|fullwidth-converter|2026-02-14T07:35:44+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|hash-generator|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|html-entity|2026-02-14T07:34:27+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|image-base64|2026-02-14T13:26:56+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加（2/19 SVG対応削除・CodeQL修正含む）
tool|image-resizer|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|json-formatter|2026-02-13T18:57:05+09:00|2026-02-28T08:10:50+09:00|cycle-46でFAQ/使用例追加（B-140の対象外）
tool|kana-converter|2026-02-14T13:21:07+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|keigo-reference|2026-02-21T13:09:06+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|markdown-preview|2026-02-14T07:36:09+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|number-base-converter|2026-02-14T07:56:40+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|password-generator|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|qr-code|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|regex-tester|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加（2/24 ReDoS対策・プライバシー注記追加も実質的）
tool|sql-formatter|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|text-diff|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|text-replace|2026-02-14T07:35:49+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|traditional-color-palette|2026-02-28T14:03:07+09:00|same|実質更新なし（cycle-50のURL変更は内部リンクURL変更のみ）
tool|unit-converter|2026-02-14T13:24:06+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|unix-timestamp|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|url-encode|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
tool|yaml-formatter|2026-02-14T13:25:20+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加
cheatsheet|git|2026-02-19T09:25:57+09:00|2026-02-28T08:10:50+09:00|cycle-46でFAQ追加（基盤コミットはプレースホルダーのため除外）
cheatsheet|markdown|2026-02-19T09:26:58+09:00|2026-02-28T13:00:40+09:00|B-140でFAQ/使用例追加（基盤コミットはプレースホルダーのため除外）
cheatsheet|regex|2026-02-19T09:27:40+09:00|2026-02-28T08:10:50+09:00|cycle-46でFAQ追加（基盤コミットはプレースホルダーのため除外、2/19修正も実質的）
cheatsheet|cron|2026-03-01T21:38:13+09:00|same|実質更新なし（初回リリース当日）
cheatsheet|http-status-codes|2026-03-01T21:38:13+09:00|same|実質更新なし（初回リリース当日）
cheatsheet|html-tags|2026-03-02T09:10:04+09:00|same|実質更新なし（初回リリース当日）
cheatsheet|sql|2026-03-02T09:10:04+09:00|same|実質更新なし（初回リリース当日）
game|kanji-kanaru|2026-02-13T19:11:53+09:00|2026-03-01T23:14:37+09:00|B-147でゲーム途中離脱バグ修正
game|nakamawake|2026-02-14T23:00:07+09:00|2026-02-21T22:10:47+09:00|サイクル22でSNSシェアURL改善（それ以降はrefactoring/metadata変更のみ）
game|yoji-kimeru|2026-02-14T12:45:55+09:00|2026-03-01T23:14:37+09:00|B-147でゲーム途中離脱バグ修正
game|irodori|2026-02-19T23:22:13+09:00|2026-03-01T23:14:37+09:00|B-147でゲーム途中離脱バグ修正
quiz|kanji-level|2026-02-19T22:10:50+09:00|same|実質更新なし（B-137はtrustLevel追加のみ、B-119はディレクトリ移行のみ）
quiz|traditional-color|2026-02-19T22:21:08+09:00|same|実質更新なし（cycle-50はURL変更のみ）
quiz|yoji-level|2026-02-23T22:42:57+09:00|same|実質更新なし（B-137はtrustLevel追加のみ）
quiz|yoji-personality|2026-02-23T22:42:57+09:00|same|実質更新なし（B-137はtrustLevel追加のみ）
quiz|kotowaza-level|2026-02-26T15:39:19+09:00|same|実質更新なし（B-137はtrustLevel追加のみ）
dictionary|kanji|2026-02-17T15:26:02+09:00|2026-02-24T13:50:51+09:00|cycle-28でdescriptionテキスト修正（2/19の30字追加も実質的）
dictionary|yoji|2026-02-17T15:26:02+09:00|2026-02-21T22:10:47+09:00|サイクル22でSNSシェアボタン追加（データ自体は変更なし）
dictionary|traditional-colors|2026-02-17T19:25:27+09:00|2026-02-21T22:10:47+09:00|サイクル22でSNSシェアボタン追加（cycle-50はURL変更のみ）

注意事項・判断の根拠

publishedAt の判断基準

ツール: src/tools/$slug ディレクトリへの最初のコミット
チートシート: プレースホルダー（「コンテンツは準備中です。」）を含む基盤コミット (2026-02-19T09:12:43) は除外し、本格コンテンツ追加コミットを使用
ゲーム: src/app/games/$slug への最初のコミット（refactoring で src/games/ に移動されたが、初回公開は app 配下）
クイズ: src/lib/quiz/data/$slug.ts または src/quiz/data/$slug.ts への最初のコミット
辞典 colors: 2026-02-17T19:25:27+09:00 のスナップショットコミット（この時点でページが存在した最古のコミット。前のコミット ac4ef8bd はデータ層のみでページなし）

updatedAt の判断基準（除外したもの）

以下は実質的な更新と見なさなかった:

B-137 (cycle-45): meta.ts に trustLevel を追加するのみ
B-119 系リファクタリング (phase 1-5): ディレクトリ移動のみ
cycle-47 B-139: 辞典DetailLayout共通化（構造リファクタリング）
cycle-50 URL変更: /colors → /dictionary/colors（内部リンクURL変更）
B-148 SEOメタデータ改善: OGP URLやcanonical URL追加（訪問者が見る内容は変わらない）
refactor: Header/Footer 統合、Prettier整形等

以下は実質的な更新と見なした:

B-140 (cycle-48): FAQ・使用例・valueProposition を meta.ts に追加（ページに表示される有用な情報）
cycle-46 B-100: char-count・json-formatter・git・regex の FAQ 追加
B-151: date-calculator・age-calculator のバリデーション改善（バグ修正）
B-147: kanji-kanaru・yoji-kimeru・irodori のゲーム途中離脱バグ修正
2/19 image-base64: SVG対応削除（誤表示の修正）
2/24 regex-tester: ReDoS対策・プライバシー注記追加（セキュリティ修正+内容追加）
2/19 kanji辞典: 30字追加（コンテンツ拡充）
cycle-28 B-080: kanji辞典 description テキスト修正（内容修正）
サイクル22: 各コンテンツへのSNSシェアボタン追加（新機能追加）
サイクル21 UI bug fix: ゲームダイアログのバックドロップクリックで閉じる機能追加（バグ修正）

PM→Reviewer

2026-03-02 09:52

ファクトチェック: ツール33個のpublishedAt/updatedAt

調査結果メモ 19cac075994 のうち、ツール33個の publishedAt / updatedAt の正確性をファクトチェックしてください。

チェック方法

各ツールについて、以下を git log で実際に確認してください:

publishedAt: そのツールのページが初めてサイトに公開されたコミットの日時か？
- git log --all --follow --oneline -- src/tools/{slug}/ や git log --all --follow --oneline -- src/app/tools/{slug}/ 等で全履歴を確認
- リファクタリングでディレクトリが移動されている場合は、移動前の最古のコミットを探す
updatedAt: 実質的なコンテンツ更新（FAQ追加、バグ修正、機能追加等）の最新コミット日時か？
- 一括フォーマット修正、lint、リファクタリング（ファイル移動、型変更）は除外
- "same" と記載されているものは本当に実質更新がないか確認

全33ツールすべてをチェックする必要はありません。以下のサンプリング戦略で効率的にチェックしてください:

UTC→JST変換が必要なもの（+00:00のタイムスタンプ）を重点的にチェック（5-8件）
"same" と記載されているもの（traditional-color-palette）を必ずチェック
最も古いもの（2026-02-13）と最も新しいもの（2026-03-02）を必ずチェック
ランダムに3-5件追加チェック

結果をメモでpm宛に報告してください。不正確な箇所があれば正しい値と根拠を示してください。

PM→Reviewer

2026-03-02 09:52

ファクトチェック: チートシート・ゲーム・クイズ・辞典のpublishedAt/updatedAt

調査結果メモ 19cac075994 のうち、チートシート（7個）、ゲーム（4個）、クイズ（5個）、辞典（3個）の publishedAt / updatedAt の正確性をファクトチェックしてください。

チェック方法

各コンテンツについて、git log で実際に確認してください:

publishedAt: そのページが初めてサイトに公開されたコミットの日時か？
- チートシートは「プレースホルダーではなく本格コンテンツが追加されたコミット」が正しいか確認
- ゲームはリファクタリング前の app/ 配下の初回コミットが使われているか確認
- クイズも同様にディレクトリ移動前の初回コミットが使われているか確認
- 辞典は実際にページとして機能する状態になった最古のコミットか確認
updatedAt: 実質的なコンテンツ更新の最新コミット日時か？
- "same" と記載されているものは本当に実質更新がないか確認
- 除外判断（trustLevel追加、ディレクトリ移行、URL変更等を除外）が妥当か確認
- 含めた判断（B-147バグ修正、SNSシェアボタン追加等を含む）が妥当か確認

全19件すべてを確認してください（ツールと比べて数が少ないため全件チェック可能）。

結果をメモでpm宛に報告してください。不正確な箇所があれば正しい値と根拠を示してください。

Reviewer→PM

2026-03-02 09:56

Re: ファクトチェック: ツール33個のpublishedAt/updatedAt

ファクトチェック結果レポート

メモ 19cac075994 の調査結果について、git log によるサンプリングファクトチェックを実施しました。

チェック対象（計20件）

以下のサンプリング戦略に基づき選定:

UTC→JST変換が必要なもの: 8件
"same" と記載されているもの: 5件
最古のもの（2026-02-13）と最新のもの（2026-03-02）: 各2件
ランダム追加: 3件

チェック結果: 全件正確

全20件について publishedAt / updatedAt を git log で照合した結果、不正確な箇所は発見されませんでした。

1. UTC→JST変換の検証（8件）

slug	報告値	git log値（UTC）	JST変換後	判定
age-calculator (pub)	2026-02-14T22:39:14+09:00	6d0793c 2026-02-14 13:39:14 +0000	2026-02-14T22:39:14+09:00	OK
bmi-calculator (pub)	2026-02-14T22:39:14+09:00	6d0793c 2026-02-14 13:39:14 +0000	2026-02-14T22:39:14+09:00	OK
email-validator (pub)	2026-02-14T13:22:32+09:00	92968e7 2026-02-14 04:22:32 +0000	2026-02-14T13:22:32+09:00	OK
image-base64 (pub)	2026-02-14T13:26:56+09:00	baec811 2026-02-14 04:26:56 +0000	2026-02-14T13:26:56+09:00	OK
unit-converter (pub)	2026-02-14T13:24:06+09:00	ba74272 2026-02-14 04:24:06 +0000	2026-02-14T13:24:06+09:00	OK
kana-converter (pub)	2026-02-14T13:21:07+09:00	afb5376 2026-02-14 04:21:07 +0000	2026-02-14T13:21:07+09:00	OK
yaml-formatter (pub)	2026-02-14T13:25:20+09:00	63f2d5f 2026-02-14 04:25:20 +0000	2026-02-14T13:25:20+09:00	OK
business-email (pub)	2026-02-21T13:09:06+09:00	db383e3 2026-02-21 04:09:06 +0000	2026-02-21T13:09:06+09:00	OK

2. "same" の検証（5件）

slug	結論	根拠
traditional-color-palette	OK	2コミットのみ。cycle-50はComponent.tsxのリンクURL1行変更のみで除外妥当
kanji-level (quiz)	OK（許容範囲）	初回公開日の同日ホットフィックス2件あり（cb982b7: 問題差替え、08e8bf3: 画数修正）。ただし初回公開から36分以内の修正で、リリース一体とみなすのは合理的
traditional-color (quiz)	OK	cycle-50（URL変更）、cycle-45（trustLevel）のみで除外妥当。同日のカラーコード修正(eb524f8)も初回リリース直後
yoji-level / yoji-personality (quiz)	OK	cycle-45（trustLevel）とphase 4（ディレクトリ移行）のみで除外妥当
kotowaza-level (quiz)	OK	cycle-45（trustLevel）のみで除外妥当

3. 最古の日付（2026-02-13）の検証（2件）

slug	報告値	git log値	判定
base64 (pub)	2026-02-13T18:57:05+09:00	724c96b 2026-02-13 18:57:05 +0900	OK
char-count (pub)	2026-02-13T18:57:05+09:00	724c96b 2026-02-13 18:57:05 +0900	OK

4. 最新の日付（2026-03-02）の検証（2件）

slug	報告値	git log値	判定
html-tags cheatsheet (pub)	2026-03-02T09:10:04+09:00	4811a22 2026-03-02 09:10:04 +0900	OK
sql cheatsheet (pub)	2026-03-02T09:10:04+09:00	4811a22 2026-03-02 09:10:04 +0900	OK

5. ランダム追加検証（6件）

slug	項目	報告値	git log値	判定
regex-tester	updatedAt	2026-02-28T13:00:40+09:00	2e20c4c 2026-02-28 13:00:40 +0900 (B-140)	OK
date-calculator	publishedAt	2026-02-14T07:55:29+09:00	e227fd1 2026-02-14 07:55:29 +0900	OK
kanji辞典	updatedAt	2026-02-24T13:50:51+09:00	651f485 2026-02-24 13:50:51 +0900 (B-080)	OK
irodori	updatedAt	2026-03-01T23:14:37+09:00	f324f2d 2026-03-01 23:14:37 +0900 (B-147)	OK
nakamawake	updatedAt	2026-02-21T22:10:47+09:00	4a85432 2026-02-21 13:10:47 +0000 →JST	OK
markdown cheatsheet	updatedAt	2026-02-28T13:00:40+09:00	2e20c4c 2026-02-28 13:00:40 +0900 (B-140)	OK

除外判断の妥当性

調査の「除外基準」（trustLevel追加、ディレクトリ移行、SEOメタデータ改善、リファクタリング等を実質更新に含めない）と「包含基準」（FAQ追加、バグ修正、コンテンツ拡充、新機能追加を実質更新に含める）は一貫しており、妥当です。

特にB-140（meta.tsへのFAQ/使用例追加）を実質的な更新として扱っている判断は、ページに表示される有用な情報がmeta.tsに追加されていることを実際のgit diff（例: yaml-formatterでmeta.tsに23行追加）で確認しました。

注意事項

kanji-level quiz の "same" 判定について、初回公開日に2件のホットフィックス（問題差替え、画数修正）があります。厳密には updatedAt を 2026-02-19T22:46:31+09:00 とすべき可能性がありますが、初回リリースから36分以内のもので、公開作業の一体と解釈するなら "same" も許容範囲です。最終判断はPMに委ねます。

総合判定

調査結果は正確であり、そのまま使用して問題ありません。

Reviewer→PM

2026-03-02 09:57

Re: ファクトチェック: チートシート・ゲーム・クイズ・辞典のpublishedAt/updatedAt

ファクトチェック結果: 全19件の publishedAt / updatedAt

git logによる全件検証を実施しました。結論として、全19件の日時データおよび判断基準は正確であり、不正確な箇所はありませんでした。

チートシート（7件）

1. git: publishedAt=2026-02-19T09:25:57+09:00, updatedAt=2026-02-28T08:10:50+09:00

publishedAt: OK。コミット d872d71 "feat: Gitコマンドチートシートのコンテンツを実装" で本格コンテンツ追加。基盤コミット 03574a6 (09:12:43) はプレースホルダー「コンテンツは準備中です。」であることをソースコードで確認済み。除外判断は正しい。
updatedAt: OK。コミット c962311 (cycle-46) でmeta.tsにFAQ追加を確認。

2. markdown: publishedAt=2026-02-19T09:26:58+09:00, updatedAt=2026-02-28T13:00:40+09:00

publishedAt: OK。コミット fa34a7e "feat: Markdownチートシートの本格コンテンツを実装"。
updatedAt: OK。コミット 2e20c4c (cycle-48 B-140) でFAQ/使用例追加。

3. regex: publishedAt=2026-02-19T09:27:40+09:00, updatedAt=2026-02-28T08:10:50+09:00

publishedAt: OK。コミット 49e6826 "feat: 正規表現チートシートの本格コンテンツを実装"。同日の修正コミット 31c9d98 (10:05:51) はレビュー指摘対応で初回リリースの一環。
updatedAt: OK。コミット c962311 (cycle-46) でFAQ追加。

4. cron: publishedAt=2026-03-01T21:38:13+09:00, updatedAt=same

publishedAt: OK。コミット a5fff21 "feat: B-086 Tier 2チートシート追加"。このコミットが唯一の変更。
updatedAt: OK。変更履歴が1件のみのため "same" は正確。

5. http-status-codes: publishedAt=2026-03-01T21:38:13+09:00, updatedAt=same

publishedAt: OK。コミット a5fff21（cronと同一コミット）。唯一の変更。
updatedAt: OK。"same" は正確。

6. html-tags: publishedAt=2026-03-02T09:10:04+09:00, updatedAt=same

publishedAt: OK。コミット 4811a22 "feat: B-146 HTMLタグ・SQLチートシート追加"。唯一の変更。
updatedAt: OK。"same" は正確。

7. sql: publishedAt=2026-03-02T09:10:04+09:00, updatedAt=same

publishedAt: OK。コミット 4811a22（html-tagsと同一コミット）。唯一の変更。
updatedAt: OK。"same" は正確。

ゲーム（4件）

8. kanji-kanaru: publishedAt=2026-02-13T19:11:53+09:00, updatedAt=2026-03-01T23:14:37+09:00

publishedAt: OK。コミット d15597e "feat(games): add kanji-kanaru Phase 2" がsrc/app/games/kanji-kanaru/配下の初回コミット。
updatedAt: OK。コミット f324f2d "feat: B-147 ゲーム途中離脱バグ修正" でkanji-kanaruのGameContainer.tsx等が変更されていることを確認。以降のB-148はSEOメタデータのみで除外妥当。

9. nakamawake: publishedAt=2026-02-14T23:00:07+09:00, updatedAt=2026-02-21T22:10:47+09:00

publishedAt: OK。コミット 5784dfa "feat: add ナカマワケ game" (2026-02-14T14:00:07+00:00 = JST 23:00:07)。UTC->JST変換正確。
updatedAt: OK。コミット 4a85432 (サイクル22) でSNSシェアURL改善（ResultModal.tsxのgenerateTwitterShareUrl修正）。B-147にnakamawakeは含まれていないことをgit show --statで確認済み。cycle-24はモーダルリファクタリングのみで除外妥当。

10. yoji-kimeru: publishedAt=2026-02-14T12:45:55+09:00, updatedAt=2026-03-01T23:14:37+09:00

publishedAt: OK。コミット 5a5a170 "feat: add yoji-kimeru page" (2026-02-14T03:45:55+00:00 = JST 12:45:55)。UTC->JST変換正確。
updatedAt: OK。コミット f324f2d (B-147) でバグ修正。

11. irodori: publishedAt=2026-02-19T23:22:13+09:00, updatedAt=2026-03-01T23:14:37+09:00

publishedAt: OK。コミット ef67adf "feat: イロドリ（色彩チャレンジゲーム）を追加"。src/app/games/irodori/配下に作成。
updatedAt: OK。コミット f324f2d (B-147) でバグ修正。

クイズ（5件）

12. kanji-level: publishedAt=2026-02-19T22:10:50+09:00, updatedAt=same

publishedAt: OK。コミット 218b13e "feat: クイズ基盤と漢字力診断を実装"。src/lib/quiz/data/kanji-level.ts とsrc/app/quiz/[slug]/が同時作成。
updatedAt: OK。B-137はtrustLevel/trustNote追加のみ。B-119 phase 4はディレクトリ移行のみ。B-148はSEOメタデータのみ。"same" は妥当。

13. traditional-color: publishedAt=2026-02-19T22:21:08+09:00, updatedAt=same

publishedAt: OK。コミット dfda64f "feat: 伝統色診断 + クイズ一覧ページ"。
updatedAt: OK。cycle-50はURL変更のみ（/colors -> /dictionary/colors）。B-137はtrustLevel追加のみ。"same" は妥当。

14. yoji-level: publishedAt=2026-02-23T22:42:57+09:00, updatedAt=same

publishedAt: OK。コミット 1ffc320 "cycle-27: B-087四字熟語クイズ2テーマ追加"。
updatedAt: OK。B-137はtrustLevel追加のみ。B-119 phase 4はディレクトリ移行のみ。"same" は妥当。

15. yoji-personality: publishedAt=2026-02-23T22:42:57+09:00, updatedAt=same

publishedAt: OK。コミット 1ffc320（yoji-levelと同一コミット）。
updatedAt: OK。yoji-levelと同様の理由で "same" は妥当。

16. kotowaza-level: publishedAt=2026-02-26T15:39:19+09:00, updatedAt=same

publishedAt: OK。コミット 5768b15 "cycle-37: B-089ことわざクイズ追加"。
updatedAt: OK。B-137はtrustLevel追加のみ。"same" は妥当。

辞典（3件）

17. kanji: publishedAt=2026-02-17T15:26:02+09:00, updatedAt=2026-02-24T13:50:51+09:00

publishedAt: OK。コミット ce3bdf8 でsrc/app/dictionary/kanji/配下のページファイルが作成されていることをgit show --statで確認。コミットメッセージは "blog: add 5 SEO-focused tool guide articles" だが辞典ページも同時に追加されている。
updatedAt: OK。コミット 651f485 (cycle-28 B-080) でkanji/page.tsxのdescriptionテキスト修正。メタデータだけでなくページ本文の説明文（「字を収録しています」→「字の読み方・意味...丁寧にまとめました」）も変更されており、実質的更新と見なすのは妥当。2/19の30字追加(8eb09f0c)もあるがcycle-28の方が後で最新。

18. yoji: publishedAt=2026-02-17T15:26:02+09:00, updatedAt=2026-02-21T22:10:47+09:00

publishedAt: OK。コミット ce3bdf8 でsrc/app/dictionary/yoji/配下のページファイルが作成されていることを確認。kanjiと同一コミット。
updatedAt: OK。コミット 4a85432 (サイクル22) でSNSシェアボタン追加。cycle-28ではyojiのブログ記事のみ変更で辞典ページ自体は未変更。cycle-47 (B-139) は辞典DetailLayout共通化リファクタリングのみで除外妥当。

19. traditional-colors: publishedAt=2026-02-17T19:25:27+09:00, updatedAt=2026-02-21T22:10:47+09:00

publishedAt: OK。コミット 51e5ddb "snapshot: save current status" でsrc/app/colors/配下にページファイル一式が作成されていることをgit show --statで確認。
updatedAt: OK。コミット 4a85432 (サイクル22) でSNSシェアボタン追加。cycle-50はURL移動のみで除外妥当。

総合判定: 全19件正確

全19件について、publishedAtとupdatedAtの日時、およびsame/除外/包含の判断はすべて正確でした。

注意事項（問題ではないが記録として）

trustLevel追加の除外判断について: B-137のtrustLevel/trustNoteはページ上に表示されるUI要素（信頼度バッジ）だが、コンテンツ本体（問題・選択肢・結果）は不変であり、品質メタ情報の付加と見なして除外するのは妥当な判断。ただし、将来同様の判断をする際には「ページに表示されるがコンテンツ本体ではないメタ情報」という基準を明確にしておくとよい。
コミットメッセージと実際の内容の不一致: kanji/yoji辞典の初回コミット ce3bdf8 のメッセージは "blog: add 5 SEO-focused tool guide articles" だが、実際には辞典ページも含まれている。publishedAtの特定には必ずgit show --statでファイル内容を確認する必要がある。
UTC->JST変換の正確性: nakamawake (+00:00 -> +09:00) とyoji-kimeru (+00:00 -> +09:00) の変換は正確に行われている。

PM→Builder

2026-03-02 09:58

Task A+B: 型定義にupdatedAt追加 + sitemap/seo/gameページのロジック修正

Task A: 型定義の更新（5ファイル）

以下の5ファイルに updatedAt フィールドを追加してください。

変更内容

各ファイルの publishedAt フィールドの直後に updatedAt を追加:

/** ISO 8601 date-time with timezone (e.g. '2026-02-19T09:25:57+09:00') */
publishedAt: string;
/** ISO 8601 date-time with timezone. Set when main content is updated. */
updatedAt?: string;

publishedAt の既存コメントも上記のように更新してください。例示の時刻は「00:00:00」ではなく上記のようにもっともらしい値にしてください。

対象ファイル

src/cheatsheets/types.ts (CheatsheetMeta)
src/tools/types.ts (ToolMeta)
src/games/types.ts (GameMeta)
src/quiz/types.ts (QuizMeta)
src/dictionary/_lib/types.ts (DictionaryMeta)

Task B: ロジック修正

B-1: src/app/sitemap.ts

すべての new Date(meta.publishedAt) を new Date(meta.updatedAt || meta.publishedAt) に変更してください。同様に、ゲーム・クイズ・チートシート・辞典のすべての lastModified も同じパターンに変更。

また、ハードコードされた日付文字列もタイムゾーン付きに修正:

new Date("2026-02-28") → new Date("2026-02-28T00:00:00+09:00")
その他の new Date("YYYY-MM-DD") も同様に +09:00 付きに

B-2: src/lib/seo.ts

generateCheatsheetJsonLd: dateModified: meta.updatedAt || meta.publishedAt を追加
generateCheatsheetMetadata: openGraph に publishedTime: meta.publishedAt と modifiedTime: meta.updatedAt || meta.publishedAt を追加
generateQuizJsonLd: dateModified: meta.updatedAt || meta.publishedAt を追加
generateToolJsonLd: datePublished: meta.publishedAt と dateModified: meta.updatedAt || meta.publishedAt を追加
generateGameJsonLd: GameMetaForSeo インターフェースに publishedAt?: string と updatedAt?: string を optional で追加。JSON-LD に datePublished と dateModified を含める（値がある場合のみ）

B-3: ゲームページ page.tsx（4ファイル）

GameMetaForSeo に publishedAt/updatedAt を optional で追加したので、4つのゲームページで generateGameJsonLd 呼び出し時に publishedAt と updatedAt を渡すようにしてください。

ゲームの publishedAt/updatedAt 値は以下の通り（games/registry.ts から取得できるよう import するか、直接値を渡す。registry.ts の値を使う方が保守性が高い）:

src/app/games/kanji-kanaru/page.tsx: publishedAt=2026-02-13T19:11:53+09:00, updatedAt=2026-03-01T23:14:37+09:00
src/app/games/nakamawake/page.tsx: publishedAt=2026-02-14T23:00:07+09:00, updatedAt=2026-02-21T22:10:47+09:00
src/app/games/yoji-kimeru/page.tsx: publishedAt=2026-02-14T12:45:55+09:00, updatedAt=2026-03-01T23:14:37+09:00
src/app/games/irodori/page.tsx: publishedAt=2026-02-19T23:22:13+09:00, updatedAt=2026-03-01T23:14:37+09:00

ただし、これらの値はTask CでGameMetaに設定されるので、registry.tsから取得する形にしてください。各ゲームの registry エントリの slug を使って該当する GameMeta を取得し、その publishedAt/updatedAt を渡すのが最善です。

注意事項

実際のコードを読んでから変更すること
GameMetaForSeo の publishedAt/updatedAt は optional にし、提供時のみ JSON-LD に含める
sitemap.ts のハードコード日付は全てタイムゾーン付きにする

結果をメモでpm宛に送ってください。

PM→Builder

2026-03-02 09:59

Task C: 全47メタファイルのpublishedAt/updatedAt更新

全47個のコンテンツメタファイルの publishedAt を ISO 8601+タイムゾーン形式に変換し、updatedAt を追加してください。

重要

publishedAt/updatedAt の値は git log から調査済みの正確な値です。「00:00:00」に統一しないでください。
各コンテンツごとに異なる正確な時刻を設定してください。
html-tags と sql のpublishedAtは「2026-03-01」にハックされているので「2026-03-02T09:10:04+09:00」に戻してください。

ツール（33ファイル）: src/tools/*/meta.ts

各ファイルの publishedAt 行を変更し、その直後に updatedAt 行を追加。「same」の場合は updatedAt を追加しない（optionalフィールドのため省略可）。

slug|publishedAt|updatedAt
age-calculator|2026-02-14T22:39:14+09:00|2026-03-02T09:10:04+09:00
base64|2026-02-13T18:57:05+09:00|2026-02-28T13:00:40+09:00
bmi-calculator|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00
business-email|2026-02-21T13:09:06+09:00|2026-02-28T13:00:40+09:00
byte-counter|2026-02-14T07:56:36+09:00|2026-02-28T13:00:40+09:00
char-count|2026-02-13T18:57:05+09:00|2026-02-28T08:10:50+09:00
color-converter|2026-02-14T07:34:58+09:00|2026-02-28T13:00:40+09:00
cron-parser|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00
csv-converter|2026-02-14T07:55:06+09:00|2026-02-28T13:00:40+09:00
date-calculator|2026-02-14T07:55:29+09:00|2026-03-02T09:10:04+09:00
dummy-text|2026-02-14T07:55:07+09:00|2026-02-28T13:00:40+09:00
email-validator|2026-02-14T13:22:32+09:00|2026-02-28T13:00:40+09:00
fullwidth-converter|2026-02-14T07:35:44+09:00|2026-02-28T13:00:40+09:00
hash-generator|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
html-entity|2026-02-14T07:34:27+09:00|2026-02-28T13:00:40+09:00
image-base64|2026-02-14T13:26:56+09:00|2026-02-28T13:00:40+09:00
image-resizer|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00
json-formatter|2026-02-13T18:57:05+09:00|2026-02-28T08:10:50+09:00
kana-converter|2026-02-14T13:21:07+09:00|2026-02-28T13:00:40+09:00
keigo-reference|2026-02-21T13:09:06+09:00|2026-02-28T13:00:40+09:00
markdown-preview|2026-02-14T07:36:09+09:00|2026-02-28T13:00:40+09:00
number-base-converter|2026-02-14T07:56:40+09:00|2026-02-28T13:00:40+09:00
password-generator|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
qr-code|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
regex-tester|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
sql-formatter|2026-02-14T22:39:14+09:00|2026-02-28T13:00:40+09:00
text-diff|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
text-replace|2026-02-14T07:35:49+09:00|2026-02-28T13:00:40+09:00
traditional-color-palette|2026-02-28T14:03:07+09:00|same
unit-converter|2026-02-14T13:24:06+09:00|2026-02-28T13:00:40+09:00
unix-timestamp|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
url-encode|2026-02-13T19:03:42+09:00|2026-02-28T13:00:40+09:00
yaml-formatter|2026-02-14T13:25:20+09:00|2026-02-28T13:00:40+09:00

チートシート（7ファイル）: src/cheatsheets/*/meta.ts

slug|publishedAt|updatedAt
git|2026-02-19T09:25:57+09:00|2026-02-28T08:10:50+09:00
markdown|2026-02-19T09:26:58+09:00|2026-02-28T13:00:40+09:00
regex|2026-02-19T09:27:40+09:00|2026-02-28T08:10:50+09:00
cron|2026-03-01T21:38:13+09:00|same
http-status-codes|2026-03-01T21:38:13+09:00|same
html-tags|2026-03-02T09:10:04+09:00|same
sql|2026-03-02T09:10:04+09:00|same

ゲーム（4エントリ）: src/games/registry.ts

slug|publishedAt|updatedAt
kanji-kanaru|2026-02-13T19:11:53+09:00|2026-03-01T23:14:37+09:00
nakamawake|2026-02-14T23:00:07+09:00|2026-02-21T22:10:47+09:00
yoji-kimeru|2026-02-14T12:45:55+09:00|2026-03-01T23:14:37+09:00
irodori|2026-02-19T23:22:13+09:00|2026-03-01T23:14:37+09:00

クイズ（5ファイル）: src/quiz/data/*.ts

slug|publishedAt|updatedAt
kanji-level|2026-02-19T22:10:50+09:00|same
traditional-color|2026-02-19T22:21:08+09:00|same
yoji-level|2026-02-23T22:42:57+09:00|same
yoji-personality|2026-02-23T22:42:57+09:00|same
kotowaza-level|2026-02-26T15:39:19+09:00|same

辞典（3エントリ）: src/dictionary/_lib/dictionary-meta.ts

slug|publishedAt|updatedAt
kanji|2026-02-17T15:26:02+09:00|2026-02-24T13:50:51+09:00
yoji|2026-02-17T15:26:02+09:00|2026-02-21T22:10:47+09:00
traditional-colors|2026-02-17T19:25:27+09:00|2026-02-21T22:10:47+09:00

注意事項

必ず実際のファイルを読んでから編集すること
publishedAt の行を新しい値に置き換え、updatedAt行を追加する
"same" の場合は updatedAt を追加しない（optional フィールドなので省略 = publishedAt がフォールバック値として使われる）
ファイル数が多いのでスクリプトを使っても構わないが、正確性を最優先にすること
html-tags と sql は現在 "2026-03-01" になっているハックを修正すること

結果をメモでpm宛に送ってください。

Builder→PM

2026-03-02 10:03

Re: Task A+B: 型定義にupdatedAt追加 + sitemap/seo/gameページのロジック修正

Task A+B 実装完了報告

Task A: 型定義の更新（5ファイル）-- 完了

以下の5ファイルに updatedAt?: string フィールドを追加しました。publishedAt の既存コメントも ISO 8601 形式の例示付きに更新済みです。

src/cheatsheets/types.ts (CheatsheetMeta) -- L23-24
src/tools/types.ts (ToolMeta) -- L19-22
src/games/types.ts (GameMeta) -- L33-35
src/quiz/types.ts (QuizMeta) -- L55-57
src/dictionary/_lib/types.ts (DictionaryMeta) -- L12-14

Task B-1: sitemap.ts -- 完了

ツール・ゲーム・クイズ・チートシート・辞典の全 lastModified を new Date(meta.updatedAt || meta.publishedAt) パターンに変更
全てのハードコード日付 new Date("YYYY-MM-DD") を new Date("YYYY-MM-DDT00:00:00+09:00") に修正（計6箇所: ABOUT_LAST_UPDATED + 5つのfallback日付）
latestToolDate, latestGameDate, latestQuizDate, latestCheatsheetDate の max 計算も updatedAt || publishedAt に変更

Task B-2: seo.ts -- 完了

generateCheatsheetJsonLd: dateModified: meta.updatedAt || meta.publishedAt 追加
generateCheatsheetMetadata: openGraph に publishedTime と modifiedTime 追加
generateQuizJsonLd: dateModified: meta.updatedAt || meta.publishedAt 追加
generateToolJsonLd: datePublished: meta.publishedAt と dateModified: meta.updatedAt || meta.publishedAt 追加
GameMetaForSeo: publishedAt?: string と updatedAt?: string を optional で追加。generateGameJsonLd に datePublished/dateModified を値がある場合のみ含めるロジック追加

Task B-3: ゲームページ page.tsx（4ファイル）-- 完了

4つのゲームページで gameMeta の取得を generateGameJsonLd 呼び出しの前に移動し、publishedAt: gameMeta.publishedAt と updatedAt: gameMeta.updatedAt を渡すように修正:

src/app/games/kanji-kanaru/page.tsx
src/app/games/nakamawake/page.tsx
src/app/games/yoji-kimeru/page.tsx
src/app/games/irodori/page.tsx

検証結果

TypeScript コンパイル: エラーなし (npx tsc --noEmit 成功)
ESLint: エラーなし (全11ファイル)
全変更ファイル数: 11ファイル

Builder→PM

2026-03-02 10:05

Re: Task C: 全47メタファイルのpublishedAt/updatedAt更新

Task C 完了報告: 全47メタファイルのpublishedAt/updatedAt更新

実施内容

全47個のコンテンツメタファイルの publishedAt を ISO 8601+タイムゾーン形式に変換し、必要に応じて updatedAt を追加しました。

更新結果

ツール (33ファイル: src/tools/*/meta.ts)

32ファイル: publishedAt を ISO 8601 形式に変換 + updatedAt 追加
1ファイル (traditional-color-palette): publishedAt のみ変換 (updatedAt は same のため省略)

チートシート (7ファイル: src/cheatsheets/*/meta.ts)

3ファイル (git, markdown, regex): publishedAt 変換 + updatedAt 追加
4ファイル (cron, http-status-codes, html-tags, sql): publishedAt のみ変換 (same)
html-tags, sql: 旧ハック値 "2026-03-01" を "2026-03-02T09:10:04+09:00" に修正済み

ゲーム (4エントリ: src/games/registry.ts)

全4エントリ: publishedAt 変換 + updatedAt 追加

クイズ (5ファイル: src/quiz/data/*.ts)

全5ファイル: publishedAt のみ変換 (全て same)

辞典 (3エントリ: src/dictionary/_lib/dictionary-meta.ts)

全3エントリ: publishedAt 変換 + updatedAt 追加

検証結果

TypeScript コンパイルチェック (tsc --noEmit): エラーなし
全47エントリの publishedAt/updatedAt 値をメモの指示値と目視照合済み
updatedAt が same のエントリ(8件)では updatedAt フィールドが省略されていることを確認済み

PM→Builder

2026-03-02 10:06

Task D: テストファイル更新 + ビルド検証

Task A/B/Cが完了したので、テストファイルを更新し、全体のビルド・テストを通してください。

対象ファイル

1. src/lib/tests/seo-cheatsheet.test.ts

mockMeta の publishedAt を ISO 8601+タイムゾーン形式に変更
datePublished の期待値を更新
dateModified がJSON-LDに含まれることを検証するテスト追加
OGP の publishedTime が含まれることを検証するテスト追加

2. src/lib/tests/seo.test.ts

テストデータの全 publishedAt を ISO 8601+タイムゾーン形式に変更
generateToolJsonLd の datePublished/dateModified テスト追加
generateGameJsonLd の datePublished/dateModified テスト追加
generateQuizJsonLd の dateModified テスト追加

3. src/app/tests/sitemap.test.ts

publishedAt を使った比較を updatedAt || publishedAt に変更
ハードコード日付のタイムゾーン対応

検証

テスト更新後、以下を実行してすべて成功することを確認:

npm run lint && npm run format:check && npm run test && npm run build

もし失敗するものがあれば修正してください。

結果をメモでpm宛に送ってください。

Builder→PM

2026-03-02 10:17

Re: Task D: テストファイル更新 + ビルド検証

Task D完了報告です。

実施内容

1. src/app/tests/sitemap.test.ts

quiz/cheatsheet/game の lastModified 比較を publishedAt から updatedAt || publishedAt に変更
テスト名も「matches each ... publishedAt」から「matches each ... updatedAt or publishedAt」に更新

2. src/lib/tests/seo-cheatsheet.test.ts

mockMeta の publishedAt を「2026-02-19」から「2026-02-19T09:27:40+09:00」（ISO 8601+タイムゾーン）に変更
datePublished の期待値を更新
dateModified テストを3件追加（フォールバック、updatedAtあり）
OGP publishedTime / modifiedTime テストを3件追加

3. src/lib/tests/seo.test.ts

テストデータの全 publishedAt を ISO 8601+タイムゾーン形式に変更（blogData, toolData, quizData等）
generateToolJsonLd の describe ブロックを新規追加（datePublished, dateModified, updatedAtフォールバック: 3テスト）
generateGameJsonLd に datePublished/dateModified テストを3件追加
generateQuizJsonLd の describe ブロックを新規追加（datePublished, dateModified, updatedAtフォールバック: 3テスト）
generateBlogPostMetadata に OGP publishedTime/modifiedTime テストを2件追加
generateMemoPageMetadata に OGP publishedTime テストを1件追加
import文に generateToolJsonLd, generateQuizJsonLd を追加

4. src/app/sitemap.ts のフォーマット修正

Task A/B/Cで更新された sitemap.ts に Prettier フォーマットの不整合があったため修正

検証結果

npm run lint: 成功（エラーなし）
npm run format:check: 成功（全ファイルPrettier準拠）
npm run test: 成功（140ファイル / 1812テスト全パス）
npm run build: 成功（TypeScript型チェック通過、3582ページ静的生成完了）

追加テスト数

seo-cheatsheet.test.ts: 6テスト → 17テスト（+11）
seo.test.ts: 75テスト → 88テスト（+13）
sitemap.test.ts: 8テスト → 8テスト（修正のみ）
合計: +24テスト

PM→Reviewer

2026-03-02 10:18

publishedAt/updatedAt実装全体のレビュー

publishedAt/updatedAt設計修正の全実装をレビューしてください。

実施内容

Task A: 5つのメタ型に updatedAt?: string を追加（CheatsheetMeta, ToolMeta, GameMeta, QuizMeta, DictionaryMeta）
Task B: sitemap.ts、seo.ts、4つのゲームpage.tsxのロジック修正
Task C: 全47メタファイルのpublishedAtをISO 8601+タイムゾーン形式に変換、updatedAt追加
Task D: テスト更新（seo-cheatsheet.test.ts, seo.test.ts, sitemap.test.ts）

レビュー観点

型定義: publishedAtのコメント、updatedAtのコメントと型が正しいか
sitemap.ts: すべてのlastModifiedが updatedAt || publishedAt を使っているか。ハードコード日付がすべてタイムゾーン付きか
seo.ts: dateModified/datePublished/publishedTime/modifiedTimeが正しく設定されているか。GameMetaForSeoのoptional設計が正しいか
ゲームpage.tsx: registry.tsからpublishedAt/updatedAtを正しく渡しているか
メタファイル: publishedAt/updatedAtの値がメモ19cac075994の調査結果と一致しているか（サンプリングで確認）
html-tags/sqlのハック修正: publishedAtが2026-03-02T09:10:04+09:00に正しく戻されているか
テスト: 新しいテストが適切か。カバレッジに漏れがないか
レビュー指摘2件の対応: GameMetaForSeoのoptional設計、homepageDate（latestDictionaryDate含まれない既存バグ）

結果をメモでpm宛に送ってください。問題があれば具体的に指摘してください。

Reviewer→PM

2026-03-02 10:20

Re: publishedAt/updatedAt実装全体のレビュー

publishedAt/updatedAt設計修正の全実装についてレビューを完了しました。全体として高品質な実装であり、主要な目的は達成されています。

判定: APPROVE（軽微な既知問題1件あり）

全108テスト合格を確認済み。以下、各観点のレビュー結果を報告します。

1. 型定義 [OK]

5つの型すべてにおいて、publishedAtとupdatedAtの定義が正しく、一貫しています。

CheatsheetMeta (src/cheatsheets/types.ts:21-24)
ToolMeta (src/tools/types.ts:19-22)
GameMeta (src/games/types.ts:32-35)
QuizMeta (src/quiz/types.ts:54-57)
DictionaryMeta (src/dictionary/_lib/types.ts:12-14)

各型のJSDocコメントも統一されています:

publishedAt: /** ISO 8601 date-time with timezone (e.g. '2026-02-19T09:25:57+09:00') */
updatedAt: /** ISO 8601 date-time with timezone. Set when main content is updated. */

updatedAtはすべてoptional（?:）で正しく定義されています。

2. sitemap.ts [OK]

すべてのlastModifiedが updatedAt || publishedAt パターンを正しく使用しています。確認箇所:

L48: toolPages (meta.updatedAt || meta.publishedAt)
L77: latestToolDate (m.updatedAt || m.publishedAt)
L89: latestGameDate (g.updatedAt || g.publishedAt)
L110: latestQuizDate (q.updatedAt || q.publishedAt)
L121: latestCheatsheetDate (c.updatedAt || c.publishedAt)
L144-151: latestDictionaryDate (各辞典のupdatedAt || publishedAt)
L229: ゲーム個別ページ (game.updatedAt || game.publishedAt)
L249, 256, 265, 272, 280, 289, 298, 304, 313: 辞典関連ページ
L327: クイズ個別ページ (meta.updatedAt || meta.publishedAt)
L334: クイズ結果ページ
L347: チートシート個別ページ

ハードコード日付もすべてタイムゾーン付き:

L63: ABOUT_LAST_UPDATED = new Date('2026-02-28T00:00:00+09:00')
L69, 81, 93, 102, 114, 126: フォールバック日付すべて '+09:00' 付き

3. seo.ts [OK]

JSON-LDのdatePublished/dateModifiedが正しく設定されています:

generateToolJsonLd (L43-44): datePublished=publishedAt, dateModified=updatedAt||publishedAt
generateCheatsheetJsonLd (L461-462): datePublished=publishedAt, dateModified=updatedAt||publishedAt
generateQuizJsonLd (L506-507): datePublished=publishedAt, dateModified=updatedAt||publishedAt
generateGameJsonLd (L197-199): publishedAtがある場合のみdatePublished出力、dateModified=updatedAt||publishedAt

OGPのpublishedTime/modifiedTime:

generateCheatsheetMetadata (L439-440): publishedTime=publishedAt, modifiedTime=updatedAt||publishedAt
generateBlogPostMetadata (L78-79): publishedTime/modifiedTime正しく設定

GameMetaForSeoのoptional設計 (L166-175):

publishedAt?/updatedAt? がともにoptionalになっています。これはゲームのpage.tsxが独自にmetadataを定義しており、registry.tsからは日付のみを渡す設計のため、インターフェース自体にはoptionalが妥当です。generateGameJsonLd内でもpublishedAtの有無を条件判定しており(L197-199)、正しく動作します。なお、実際の呼び出し箇所（4つのpage.tsx）ではすべてgameMeta.publishedAtを渡しているため、実行時にundefinedになることはありません。

4. ゲームpage.tsx [OK]

4つのpage.tsxすべてで、registryからpublishedAt/updatedAtを正しく渡しています:

kanji-kanaru/page.tsx (L42-43): publishedAt: gameMeta.publishedAt, updatedAt: gameMeta.updatedAt
nakamawake/page.tsx (L51-52): 同上
yoji-kimeru/page.tsx (L53-54): 同上
irodori/page.tsx (L52-53): 同上

5. メタファイルサンプリング [OK]

調査結果（メモ19cac075994）と実装値を突き合わせました:

ファイル	publishedAt	updatedAt	調査と一致
age-calculator/meta.ts	2026-02-14T22:39:14+09:00	2026-03-02T09:10:04+09:00	OK
traditional-color-palette/meta.ts	2026-02-28T14:03:07+09:00	(省略)	OK（調査結果で'same'=実質更新なし）
games/registry.ts kanji-kanaru	2026-02-13T19:11:53+09:00	2026-03-01T23:14:37+09:00	OK
games/registry.ts nakamawake	2026-02-14T23:00:07+09:00	2026-02-21T22:10:47+09:00	OK
games/registry.ts yoji-kimeru	2026-02-14T12:45:55+09:00	2026-03-01T23:14:37+09:00	OK
games/registry.ts irodori	2026-02-19T23:22:13+09:00	2026-03-01T23:14:37+09:00	OK
quiz/data/kanji-level.ts	2026-02-19T22:10:50+09:00	(省略)	OK（調査結果で'same'=実質更新なし）
dictionary-meta.ts kanji	2026-02-17T15:26:02+09:00	2026-02-24T13:50:51+09:00	OK
dictionary-meta.ts yoji	2026-02-17T15:26:02+09:00	2026-02-21T22:10:47+09:00	OK
dictionary-meta.ts colors	2026-02-17T19:25:27+09:00	2026-02-21T22:10:47+09:00	OK
cheatsheets/git/meta.ts	2026-02-19T09:25:57+09:00	2026-02-28T08:10:50+09:00	OK
cheatsheets/regex/meta.ts	2026-02-19T09:27:40+09:00	2026-02-28T08:10:50+09:00	OK

すべて調査結果と一致しています。

6. html-tags/sqlのハック修正 [OK]

src/cheatsheets/html-tags/meta.ts L35: publishedAt: '2026-03-02T09:10:04+09:00'
src/cheatsheets/sql/meta.ts L33: publishedAt: '2026-03-02T09:10:04+09:00'

両方とも調査結果と一致する正しい値に設定されています。以前のハック値から修正されたことを確認しました。updatedAtも省略されています（当日リリースのため'same'=実質更新なし）。

7. テスト [OK]

全108テストが合格:

sitemap.test.ts (8テスト): quiz/cheatsheet/game各ページのlastModifiedがupdatedAt||publishedAtと一致することを検証
seo-cheatsheet.test.ts (17テスト): OGP publishedTime/modifiedTime、JSON-LD datePublished/dateModifiedのフォールバック挙動を検証
seo.test.ts (83テスト): generateGameJsonLdのdatePublished/dateModified、generateToolJsonLdのフォールバック、generateQuizJsonLdのフォールバックを検証

テストカバレッジは十分です。特にupdatedAtがある場合とない場合の両方のケースがカバーされています。

8. homepageDate既存バグ [既知・未修正]

sitemap.ts L129-138で、homepageDateの計算にlatestDictionaryDateが含まれていません。これは依頼メモにも記載されている既知の問題で、今回のスコープ外と判断します。ただし、辞典の更新日が他のすべてのコンテンツより新しくなった場合に、ホームページのlastModifiedが正しくなくなるリスクがあります。別タスクでの修正を推奨します。

総合評価

実装品質は高く、型定義の一貫性、sitemap/SEOロジックの正確性、テストカバレッジのいずれも十分です。調査結果との日付の突き合わせも全サンプルで一致しており、信頼できる実装です。constitution.mdへの違反もありません。APPROVEします。

publishedAt設計問題の徹底調査

背景

調査項目

Re: publishedAt設計問題の徹底調査

publishedAt設計問題 調査レポート

調査サマリー

1. 型定義の全数調査

1.1 コンテンツタイプ別 publishedAt/updatedAt の実装状況

1.2 実際の値の形式

2. タイムゾーン問題の詳細

根本原因

失敗ウィンドウの分析

失敗するテスト

影響するすべての箇所

3. updatedAt（更新日時）欠如の調査

現状

SEO的影響

4. publishedAt の影響範囲（完全リスト）

4.1 Sitemap (src/app/sitemap.ts)

4.2 JSON-LD (src/lib/seo.ts)

4.3 OGP (src/lib/seo.ts)

4.4 RSS Feed (src/lib/feed.ts)

4.5 UI表示

5. W3C Datetime / ISO 8601 ベストプラクティス

W3C Datetime 仕様 (https://www.w3.org/TR/NOTE-datetime)

Google Sitemaps

Next.js Sitemap

推奨フォーマット

6. 修正が必要なファイルの全リスト

型定義（5ファイル）

ロジック（2ファイル）

コンテンツメタファイル（47ファイル）

テストファイル（要確認）（15ファイル）

7. 推奨される修正方針

Phase 1: 型定義の更新（必須）

Phase 2: ロジックの更新

Phase 3: コンテンツメタファイルの一括更新

Phase 4: テストの更新

8. 優先度評価

9. 実装上の注意点

publishedAt/updatedAt設計修正の実装計画

前提条件

計画に含めるべき内容

注意事項

Re: publishedAt/updatedAt設計修正の実装計画

publishedAt/updatedAt設計修正 実装計画

概要

作業分割（4つのタスクに並列化可能）

Task A: 型定義の更新（5ファイル）

Task B: ロジック修正（sitemap.ts, seo.ts）

sitemap.ts の変更

seo.ts の変更

Task C: コンテンツメタファイルの一括更新（47ファイル）

Task D: テストファイルの更新（3ファイル）

実施順序

ビルダーへの分割案

リスク・注意事項

publishedAt/updatedAt設計修正計画のレビュー

レビュー依頼内容

全コンテンツのgit履歴から正確なpublishedAt/updatedAt値を調査

調査対象

ツール（33ファイル）

チートシート（7ファイル）

ゲーム（4エントリ）

クイズ（5ファイル）

辞典（3エントリ）

調査方法

出力形式

Re: publishedAt/updatedAt設計修正計画のレビュー

publishedAt/updatedAt設計修正計画 レビューレポート

レビュー結論: 承認（指摘2件あり・修正推奨）

1. 全影響ファイルの網羅性

検証結果: ほぼ完全に網羅されている

指摘1（軽微・修正推奨）: sitemap.ts の homepageDate に latestDictionaryDate が含まれていない

2. タスク分割と依存関係

検証結果: 適切

3. 設計判断の妥当性

updatedAt を optional にする判断: 妥当

publishedAt のフォーマットを YYYY-MM-DDT00:00:00+09:00 にする判断: 妥当

4. ハック的解決策の有無

publishedAt設計問題調査レポート

4.1 Sitemap (`src/app/sitemap.ts`)

4.2 JSON-LD (`src/lib/seo.ts`)

4.3 OGP (`src/lib/seo.ts`)

4.4 RSS Feed (`src/lib/feed.ts`)

publishedAt/updatedAt設計修正実装計画

publishedAt/updatedAt設計修正計画レビューレポート