[#153] Phase 2: GitHub / AI 開発プロセス系 7冊の内容レビュー計画

[ootakazuhiko]

背景

親ロードマップ: #153

Phase 1「基礎リテラシー系」が完了したため、次に Phase 2「GitHub / AI 開発プロセス系」7冊について、書籍別レビュー Issue、PR、GitHub Copilot review、CI、merge 後確認、公開反映確認を束ねる。

対象書籍

• github-guide-for-beginners-book
• github-workflow-book
• GitHub-AgentOps-book
• ai-agent-engineering-book
• ai-testing-strategy-book
• formal-methods-book
• small-webapp-software-design-book

推奨順

1. github-guide-for-beginners-book
   • 理由: GitHub UI、Issue、PR、Actions の入口であり、以後の書籍レビュー運用の前提になるため。
2. github-workflow-book
   • 理由: Branch / PR / review / CI / release の実務運用を、初心者ガイドの次に整えるため。
3. GitHub-AgentOps-book
   • 理由: AI agent を GitHub 上で運用する際の Issue / PR / CI / review 設計に直結するため。
4. ai-agent-engineering-book
   • 理由: agent、prompt、context、tool、eval などの用語と設計原則を Phase 2 全体で揃えるため。
5. ai-testing-strategy-book
   • 理由: AI agent / AI 実装の品質保証、評価、回帰検知を前段の用語に接続するため。
6. formal-methods-book
   • 理由: テスト戦略だけでなく、仕様、検証、形式手法の接続を明確にするため。
7. small-webapp-software-design-book
   • 理由: GitHub / AI / テスト / 形式手法を、小規模 Web アプリ設計の実務例へ統合するため。

書籍別 Issue

• github-guide-for-beginners-book — [#153/#155] GitHub 初心者ガイドを深掘りレビューする github-guide-for-beginners-book#218
• github-workflow-book — [#153/#155] GitHub ワークフロー実践を深掘りレビューする github-workflow-book#228
• GitHub-AgentOps-book — [#153/#155] GitHub AgentOps を深掘りレビューする GitHub-AgentOps-book#38
• ai-agent-engineering-book — [#153/#155] AI Agent Engineering を深掘りレビューする ai-agent-engineering-book#240
• ai-testing-strategy-book — [#153/#155] AI Testing Strategy を深掘りレビューする ai-testing-strategy-book#165
• formal-methods-book — [#153/#155] 形式手法とテスト戦略の接続を深掘りレビューする formal-methods-book#289
• small-webapp-software-design-book — [#153/#155] 小規模Webアプリ設計を深掘りレビューする small-webapp-software-design-book#113

横断確認観点

• GitHub UI / Actions / PR / Issue の記述が現行仕様と整合している。
• AI agent / prompt / context / harness / eval の用語が書籍間で整合している。
• テスト戦略と形式的手法の接続が明確である。
• Node.js / TypeScript / Playwright などの時点依存記述を必要に応じて公式情報で確認している。
• AI 関連のモデル名、API、ベンダー依存の記述に確認日または時点表現がある。
• セキュリティ/プライバシー、秘密情報、ログ、外部サービス投入の注意が Phase 1 と矛盾しない。
• 初心者向け、実務ワークフロー、AgentOps、設計、テスト、形式手法の責務分界が明確である。

各書籍レビューの完了条件

• 書籍別 Issue に確認範囲、変更判断、検証結果が記録されている。
• 本文変更がある場合は適切な粒度で PR が作成されている。
• PR で GitHub Copilot review を受けている。
• review 本文・inline comment・suggestion を全件確認し、必要な修正または不要理由を返信している。
• 未解決 review thread が 0 である。
• CI が green である。
• merge 後 main checks と公開サイト反映を確認している。
• ブランチ cleanup が完了している。

このカテゴリ Issue の完了条件

• 上記 7冊の書籍別 Issue がすべて close されている。
• 必要な PR がすべて merge 済みである。
• Phase 2 内の主要な用語・責務分界・学習順序の矛盾が解消されている。
• 既存書籍群の内容レビュー・改善ロードマップ #153 に Phase 2 完了証跡をコメントしている。
• 残課題がある場合は Phase 3 以降または各書籍の follow-up Issue に分離済みである。

[ootakazuhiko]

Phase 2 の 1冊目 github-guide-for-beginners-book が完了しました。

• 書籍 Issue: [#153/#155] GitHub 初心者ガイドを深掘りレビューする github-guide-for-beginners-book#218
• PR: [codex] セキュリティとPR完了ゲートを現行運用に合わせる github-guide-for-beginners-book#219
• merge commit: ba8961be66648c2f270c8d6be687cdcc4453adb7
• Review: GitHub Copilot 3 comments + Codex 1 comment を全件修正・返信・resolve 済み
• review completeness: status=ok, unresolved_threads=0
• PR CI: qa, docs-forbidden, docs-quality-gate が成功
• merge 後 main checks: Docs Forbidden Check, Docs Quality Gate, Book QA, pages build and deployment が成功
• 公開サイト反映: 第4章、第7章、第9章、第10章、付録Cで確認済み
• branch cleanup: 完了

#155 の書籍別チェックリストで github-guide-for-beginners-book を完了に更新しました。

次の推奨順: github-workflow-book（https://github.com/itdojp/github-workflow-book/issues/228）

[ootakazuhiko]

Phase 2 の 2冊目 github-workflow-book を完了しました。

• 書籍別 Issue: [#153/#155] GitHub ワークフロー実践を深掘りレビューする github-workflow-book#228
• PR: [codex] PR完了ゲートとリリース運用証跡を強化する github-workflow-book#229
• merge commit: 11c3ffc35505fffa22fbc06ca9cf55829b93e472
• review 完全性: status: ok, unresolved_threads: 0, generated_count_mismatches: 0, missing_review_ids: 0
• PR CI: docs-forbidden / qa success
• merge 後 main checks: Docs Forbidden Check / Book QA / pages build and deployment success
• 公開サイト: Chapter 12 / Chapter 13 の追加内容を確認済み

#155 のチェックリストで github-workflow-book を完了済みに更新しました。

次の推奨対象は GitHub-AgentOps-book（https://github.com/itdojp/GitHub-AgentOps-book/issues/38）です。

[ootakazuhiko]

Phase 2 の 3冊目 GitHub-AgentOps-book を完了しました。

• 書籍別 Issue: [#153/#155] GitHub AgentOps を深掘りレビューする GitHub-AgentOps-book#38
• PR: [codex] AgentOpsのレビュー・外部投入・評価ゲートを強化する GitHub-AgentOps-book#39
• merge commit: 27fe1f4e60fafeafefbcc5435378c0720ac0a05c
• review 完全性: status: ok, review_threads: 3, unresolved_threads: 0, generated_count_mismatches: 0, missing_review_ids: 0
• PR CI: docs-forbidden / test / qa success
• merge 後 main checks: Docs Forbidden Check / validate / Book QA / pages build and deployment success
• 公開サイト: Chapter 6 / 10 / 11 の追加内容を確認済み

#155 のチェックリストで GitHub-AgentOps-book を完了済みに更新しました。

次の推奨対象は ai-agent-engineering-book（https://github.com/itdojp/ai-agent-engineering-book/issues/240）です。

[ootakazuhiko]

Phase 2 の 4冊目 ai-agent-engineering-book が完了しました。

• 書籍別 Issue: [#153/#155] AI Agent Engineering を深掘りレビューする ai-agent-engineering-book#240
• 対応 PR: [codex] AI agentの評価・外部投入・レビューゲートを強化する ai-agent-engineering-book#241
• Merge commit: b1e5ebf764f0c0e53b7b9d73e43a6ebb2a7747d5
• Review 対応: Copilot 5件、Codex Review 2件を全件確認・修正・返信・resolve 済み。
• Review completeness: status: ok, unresolved_threads: 0, generated_count_mismatches: 0, missing_review_ids: 0。
• CI: PR head ba991be の verify-book / verify-pages / verify-sample が success。merge 後 main commit b1e5ebf の verify / pages workflow も success。
• 公開サイト反映: CH04 / CH09 / CH12 / Appendix D の主要 marker を HTTP 200 ページ上で確認済み。

Issue 本文の ai-agent-engineering-book チェックを完了に更新しました。次の推奨対象は ai-testing-strategy-book（https://github.com/itdojp/ai-testing-strategy-book/issues/165）です。

[ootakazuhiko]

Phase 2 の ai-testing-strategy-book を完了として更新しました。

証跡

• 書籍別Issue: [#153/#155] AI Testing Strategy を深掘りレビューする ai-testing-strategy-book#165
• 本文・eval/review gate強化 PR: [codex] AI testingのeval・review gateを強化する ai-testing-strategy-book#166
  • Merge commit: beb424e0001f26e7c097202f0ea76082b6fc1bc1
• deploy-preview workflow修正 PR: [codex] deploy-preview workflow の式評価を修正する ai-testing-strategy-book#167
  • Merge commit: dd47fb83f9da4fc2b9ad65cb27d5ac3c213ef0c0

完了条件の確認

• GitHub Copilot review を受領し、docs: sync dashboard after sprint cleanup #166 の2件、[Quality Sprint] 2026-06-01 #167 の1件の inline comment を修正・返信・resolve 済み。
• pr-review-completeness は docs: sync dashboard after sprint cleanup #166/[Quality Sprint] 2026-06-01 #167 ともに status: ok、未解決 thread 0。
• [Quality Sprint] 2026-06-01 #167 merge 後 main checks は Docs Forbidden Check, Validate Build (Light), Examples CI, Book QA, pages-build-deployment が success。
• 公開サイトで対象ページの HTTP 200 と主要反映マーカーを確認済み。

次の推奨タスクは、推奨順 6 の formal-methods-book（https://github.com/itdojp/formal-methods-book/issues/289）です。

[ootakazuhiko]

Phase 2 の formal-methods-book を完了として更新しました。

証跡

• 書籍別Issue: [#153/#155] 形式手法とテスト戦略の接続を深掘りレビューする formal-methods-book#289
• PR: [codex] 形式手法とテスト戦略の責務分界を明確化する formal-methods-book#290
• Merge commit: 2b5ab382b5ada352231e008efa2a26e602a99bb0

完了条件の確認

• GitHub Copilot review: 8/8 files reviewed, generated comments 0。
• pr-review-completeness: status: ok, 未解決 thread 0。
• PR checks: lint-and-links, pr-quick, qa が success。nightly-deep は pull_request では expected skip。
• merge 後 main checks: Pages, Book QA, CI が success。
• 公開サイトで日本語/英語トップページと付録Fの HTTP 200 および主要反映マーカーを確認済み。

次の推奨タスクは、推奨順 7 の small-webapp-software-design-book（https://github.com/itdojp/small-webapp-software-design-book/issues/113）です。

[ootakazuhiko]

Phase 2 の完了証跡を記録します（2026-05-23 Asia/Tokyo）。

完了範囲

Phase 2「GitHub / AI 開発プロセス系」7冊を完了しました。

• github-guide-for-beginners-book — #218 / PR #219 merged
• github-workflow-book — #228 / PR #229 merged
• GitHub-AgentOps-book — ci(dashboard): add weekly auto-update #38 / PR docs(dashboard): add recently closed unification list #39 merged
• ai-agent-engineering-book — #240 / PR #241 merged
• ai-testing-strategy-book — docs: add operations dashboard snapshot #165 / PR docs: sync dashboard after sprint cleanup #166, [Quality Sprint] 2026-06-01 #167 merged
• formal-methods-book — #289 / PR #290 merged
• small-webapp-software-design-book — Add candidates for AI-era infra knowledge gaps (Issue #83) #113 / PR GitHub Pages 表示確認の自動化（Playwright） #114 merged

最終 item の証跡

• small-webapp-software-design-book PR GitHub Pages 表示確認の自動化（Playwright） #114: [codex] 小規模Webアプリ設計の横断レビュー証跡を明確化する small-webapp-software-design-book#114
• Merge commit: 16e4cec06004480c19e7140199f48104c7dbac36
• Review completeness: status: ok, unresolved threads 0
• PR checks / main checks / Pages 公開反映: success
• Book Issue evidence: [#153/#155] 小規模Webアプリ設計を深掘りレビューする small-webapp-software-design-book#113 (comment)

判断

• Phase 2 の主要な用語・責務分界・学習順序の矛盾は、各書籍 PR の範囲で解消済みです。
• 既知の残課題は、各書籍の依存関係監査や既存 lint baseline など、Phase 2 の内容レビュー本体とは分離済みです。
• 親ロードマップ 既存書籍群の内容レビュー・改善ロードマップ #153 に Phase 2 完了証跡をコメントします。