docs(v1.2): README/CONTRIBUTING に 404 ページの動作確認セクション追加（Issue #198 補完）

[shunei-web]

概要

Issue #198「preview server 404 fallback 追加 + 404 動作の README 明記」の README/CONTRIBUTING ドキュメント補完 PR。

vite.config.ts の preview-404-fallback plugin 実装は PR #199（feat）+ PR #200（hotfix）で v1.2 にマージ済。一方で Issue #198 の完了条件のうち 「README または CONTRIBUTING に 404 動作明記」が未完遂 だった（PR #199 body には記載があったが実 commit には含まれていない partial misreport パターン）ため、本 PR で補完する。

検出経緯

• PR feat(v1.2): preview server 404 fallback 追加 + README 明記（Issue #198） #199 changed files = vite.config.ts のみ（gh pr view 199 --json files で確認）
• README.md / CONTRIBUTING.md grep で 404 動作確認に関する記述ゼロを確認
• Issue [v1.0] preview server 404 fallback 追加 + 404 動作の README 明記 #198 が state: OPEN のまま残っており、ドキュメント補完が必要と判定

変更内容

README.md

「ビルドと納品」セクション末尾に 「404 ページの動作確認」サブセクション を追加:

• 本番ホスティング（Cloudflare Pages / Netlify / Vercel / GitHub Pages いずれも root の 404.html を自動配信）
• ローカル preview（vite.config.ts の preview-404-fallback plugin が再現）
• 直接アクセス（/404.html でデザイン確認）

CONTRIBUTING.md

「基本フロー」に pnpm run preview での動作確認手順を追加し、README の「404 ページの動作確認」セクションへ相対リンク。

CHANGELOG.md

## [Unreleased] の Added に preview-404-fallback plugin の動作を追記（PR #199 / #200 で更新漏れていた分の補完）。

動作確認

npm run build && npm run preview 後:

URL	期待	実測
/	200	✅ 200
/privacy/	200	✅ 200
/nonexistent	404	✅ 404
/nonexistent/deep	404	✅ 404（既存 plugin 動作）
/404.html（直接）	200	✅ 200
/assets/notfound.css	404	✅ 404

pnpm run build ✅ PASS

AR レポート

スコープ

• B 段階（周辺 8 軸）: 軽量 AR（README + CONTRIBUTING + CHANGELOG の数行追記のみ、新規ロジック無し）
• completeness-criteria 観点段階: 🟠 Guardian（変更完全性 / 情報公開範囲）+ 🟢 Essential（教材性 / ドキュメント整合）
• リリース前 7 条件: 該当（v1.0 P0 リリース判定の必須要件、Issue [v1.0] preview server 404 fallback 追加 + 404 動作の README 明記 #198 完了に直結）

チェック結果

観点	判定	根拠
🟠 変更完全性	✅	Issue #198 完了条件のうち未完遂分（README/CONTRIBUTING 明記）を全て満たす
🟠 情報公開範囲	✅	パブリック情報のみ。秘密情報・内部 URL なし
🟢 教材性	✅	template 利用者（README）+ contributor（CONTRIBUTING）両者向けに 3 確認パターンを表形式で提示
🟢 事実の妥当性	✅	Cloudflare Pages / Netlify / Vercel / GitHub Pages 4 社とも root の 404.html 自動配信は公式仕様（一次ソース確認済）
🟢 既存実装との整合	✅	vite.config.ts の plugin 名 preview-404-fallback を文書側で正確に参照
🟢 npm/pnpm 表記の整合	✅	README は npm 表記基本（既存方針）、CONTRIBUTING は pnpm 表記（contributor 開発環境）
🟢 リンク整合	✅	CONTRIBUTING → README#404-ページの動作確認 アンカー有効（GitHub flavored markdown 仕様、日本語アンカー対応）
⚪ ブラウザ互換	N/A	ドキュメントのみの変更

副次的 bug 検出

• なし

関連

Closes #198

• 既存実装: PR feat(v1.2): preview server 404 fallback 追加 + README 明記（Issue #198） #199（feat） + PR hotfix(v1.2): preview-404-fallback plugin の / と /privacy/ 404 副作用修正 #200（hotfix）
• 親方針: v1.0 一斉リリース P0 残課題
• 過去経緯: セッション 33 観察ログ「動作確認できない実装は教材性低い」（しゅんえい判断 2026-05-01）

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying starter with    Cloudflare Pages

Latest commit:	cf12fd0
Status:	✅  Deploy successful!
Preview URL:	https://fb7fb078.starter-20t.pages.dev
Branch Preview URL:	https://docs-issue-198-404-readme-co.starter-20t.pages.dev

View logs