myoshi2891 · Aug 8, 2026 · Aug 3, 2026 · Aug 3, 2026 · Aug 4, 2026 · Aug 4, 2026
diff --git a/.claude/rules/tdd-commit-workflow.md b/.claude/rules/tdd-commit-workflow.md
@@ -21,8 +21,9 @@ LLMエージェントがコードを実装する際、要件漏れや意図し
 **AI エージェントへの厳格な指示**:
 
 1. **Red（テスト失敗）フェーズを経ないコード実装は「未完了」とみなす。** 実装コード（プロダクションコード）を書く前に、必ず失敗するテストを作成・実行し、その状態をコミットすること。
-2. **一括コミットの厳禁。** 「テスト + 実装 + ドキュメント」を一つのコミットにまとめることは重大な規約違反である。1つの論理的なフェーズが完了するごとに、必ず `git commit` を実行すること。
-3. **違反検知時は即時報告。** サイクルを飛ばしたことに気づいた場合、独断で `git reset` 等を実行せず、直ちにユーザーへ報告し、承認を得たうえでリカバリ手順を実施すること（詳細は「違反時の対応」を参照）。
+2. **甘いテスト（スモークテスト程度・大枠見出しのみチェック）の厳禁。** 「コンポーネントが描画されるか」「h1タイトルがあるか」程度の浅いテストの作成は固く禁止する。テストは要件・仕様・元コンテンツの全量（全セクションの見出し・表の各セル文言・スキル項目・全出典リンク・Mermaid図のariaLabel等）を網羅的にアサーションする厳格なものでなければならない。
+3. **一括コミットの厳禁。** 「テスト + 実装 + ドキュメント」を一つのコミットにまとめることは重大な規約違反である。1つの論理的なフェーズが完了するごとに、必ず `git commit` を実行すること。
+4. **違反検知時は即時報告。** サイクルを飛ばしたことに気づいた場合、独断で `git reset` 等を実行せず、直ちにユーザーへ報告し、承認を得たうえでリカバリ手順を実施すること（詳細は「違反時の対応」を参照）。
 </ai_agent_directive>
 
 ---
@@ -31,14 +32,29 @@ LLMエージェントがコードを実装する際、要件漏れや意図し
 
 エージェントは以下のサイクルを厳格に繰り返すこと。
 
-### Step 1: Red（テストの作成と失敗）
+### Step 1: Red（テストの作成と失敗） — 高強度テストの作成
 
 作業種別に応じて以下を選択する:
 
-- **新機能の場合**: 実装する機能の仕様を反映したテストファイルを `__tests__/` 下に作成する。
-- **バグ修正の場合**: 現在の不具合を再現する失敗テストを追加する。テストがパスしてしまう場合は再現条件を見直す。
-- **機能改善の場合**: 期待する新しい振る舞いを記述した失敗テストを追加する。
-- **リファクタリングのみの場合**: 既存テストをそのまま実行してすべてパスすることを確認する。新規テストの作成は不要。
+- **学習ガイド/HTML移行の場合**: 移行元コンテンツの全量網羅性を保証する強固なテストを作成する。
+  - 元コンテンツの全セクションの見出し (`h2`, `h3`)
+  - 表のヘッダーと全データセル内文言 (`td`, `th` を漏れなく対象)
+  - 補足スキル項目 (`スキル: ...`) の存在
+  - 外部出典リンク (`blockquote` 内に限定せず事前インベントリに含まれる全リンクと URL)
+  - Mermaid / SVG 図解の存在とアクセシビリティ属性 (`ariaLabel` または `decorative={true}` のいずれか必須)
+- **新機能の場合**: 機能の全要求仕様・エッジケースを包括する失敗テストを `__tests__/` 下に作成する。
+- **バグ修正の場合**: 不具合を正確に再現する失敗テストを追加する。
+- **機能改善の場合**: 期待する新しい振る舞いを網羅した失敗テストを追加する。
+
+**🚨 テスト品質の自己検証ゲート (Test Quality Gate)**:
+コミット前に以下を確認すること。1つでも該当する場合はテストを追加・強化すること。
+- [ ] タイトルや見出しが1つあるか確認するだけの「スモークテスト」になっていないか？
+- [ ] 本文中の重要な解説・表内のセルテキスト・スキル項目が含まれているか？
+- [ ] 事前インベントリに含まれる全出典リンクが含まれているか？
+- [ ] Mermaid / SVG に `ariaLabel` または `decorative={true}` が適切に指定されているか？
+- [ ] 移行前に作成した件数インベントリが保持されているか？
+- [ ] Green 完了時に元資料と TSX の文字数・行数・内容を照合し、大幅な乖離がないか？
+- [ ] 意図的な要約や一部省略コードを実装してもテストが Pass してしまうような抜け穴がないか？
 
 - **実行**: `bun test` または `bun run test` で失敗（またはコンパイルエラー）を確認する（リファクタリングはパスを確認）。
 - **コミット**: `test(<scope>): add failing tests for [機能名/バグID]` (または `test: add failing tests for ...`) — **テスト作成直後に必ずコミットすること。Step 2への繰り越しは禁止。**