Issue #194: テンプレ/CODEOWNERS/章7-8の整合

Author: ootakazuhiko

.github/CODEOWNERS

@@ -1,16 +1,21 @@
-# CODEOWNERS (standardized for book repos)
-# 共同フォーマッタ資産・下部ナビ共通インクルード
-/book-formatter-contrib/**            @itdojp/book-formatter
-/docs/_includes/page-navigation.html  @itdojp/book-formatter
+# CODEOWNERS
+#
+# NOTE:
+# - Order matters. The last matching pattern takes precedence.
+# - 本文の正（Single Source of Truth）は `manuscript/**`。
 
-# 本文（GitHub Pages）
-/docs/src/**                          @itdojp/book-editors
-/docs/index.md                        @itdojp/book-editors
+# Default owners (repo-wide)
+*                                     @itdojp/book-editors
 
-# 書籍の元原稿（必要なら運用）
-/src/**                               @itdojp/book-editors
+# GitHub Pages（公開サイト）
+/docs/**                               @itdojp/book-editors
 
-# 上記以外（コンテンツ/設定/CI含む全般）
+# 共同フォーマッタ資産・下部ナビ共通インクルード
+/.book-formatter/**                    @itdojp/book-formatter
+/docs/_includes/page-navigation.html   @itdojp/book-formatter
 
-/.book-formatter/**                   @itdojp/book-formatter
-*                                     @itdojp/book-editors
+# 本文（正）
+/manuscript/**                         @itdojp/book-editors
+
+# 書籍の元原稿（互換/残骸。必要な場合のみ運用）
+/src/**                                @itdojp/book-editors

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -47,6 +47,39 @@ body:
     validations:
       required: true
 
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: 受入基準（任意）
+      description: 修正が完了したと判断できる条件（チェック可能な形）を記載してください
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
+    validations:
+      required: false
+
+  - type: textarea
+    id: constraints
+    attributes:
+      label: 制約・変更禁止領域（任意）
+      description: 触ってはいけないファイル/設定や制約があれば明記してください
+      placeholder: |
+        - 変更してよい:
+        - 変更してはいけない:
+    validations:
+      required: false
+
+  - type: textarea
+    id: test
+    attributes:
+      label: テスト方法（任意）
+      description: 最低限の確認コマンドや手動確認手順を書いてください
+      placeholder: |
+        - コマンド:
+        - 手動確認:
+    validations:
+      required: false
+
   - type: textarea
     id: environment
     attributes:
@@ -67,4 +100,3 @@ body:
       description: スクリーンショット、関連リンク、原因の見当など
     validations:
       required: false
-

.github/ISSUE_TEMPLATE/docs_change.yml

@@ -33,11 +33,43 @@ body:
     validations:
       required: true
 
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: 受入基準（DoD）
+      description: 変更が完了したと判断できる条件を、チェック可能な形で箇条書きにしてください
+      placeholder: |
+        - [ ] （例）誤字が修正されている
+        - [ ] （例）リンク先が有効で、意図したページに到達する
+    validations:
+      required: true
+
+  - type: textarea
+    id: constraints
+    attributes:
+      label: 制約・変更禁止領域（任意）
+      description: 触ってはいけないファイル/設定や、変更方針の制約があれば明記してください
+      placeholder: |
+        - 変更してよい:
+        - 変更してはいけない:
+    validations:
+      required: false
+
+  - type: textarea
+    id: test
+    attributes:
+      label: テスト方法（任意）
+      description: 最低限の確認コマンドや手動確認手順（例：CI/リンク確認）を書いてください
+      placeholder: |
+        - コマンド:
+        - 手動確認:
+    validations:
+      required: false
+
   - type: textarea
     id: additional
     attributes:
       label: 補足（任意）
       description: スクリーンショット、関連Issue/PR、参考リンクなど
     validations:
       required: false
-

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -25,6 +25,51 @@ body:
     validations:
       required: true
 
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: 受入基準（DoD）
+      description: 変更が完了したと判断できる条件を、チェック可能な形で箇条書きにしてください
+      placeholder: |
+        - [ ] ...
+        - [ ] ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: nonfunctional
+    attributes:
+      label: 非機能要件（任意）
+      description: 性能/セキュリティ/互換性など、必要があれば記載してください
+      placeholder: |
+        - セキュリティ:
+        - 互換性:
+        - 性能:
+    validations:
+      required: false
+
+  - type: textarea
+    id: constraints
+    attributes:
+      label: 制約・変更禁止領域（任意）
+      description: 触ってはいけないファイル/設定や、変更方針の制約があれば明記してください
+      placeholder: |
+        - 変更してよい:
+        - 変更してはいけない:
+    validations:
+      required: false
+
+  - type: textarea
+    id: test
+    attributes:
+      label: テスト方法（任意）
+      description: 最低限の確認コマンドや手動確認手順を書いてください
+      placeholder: |
+        - コマンド:
+        - 手動確認:
+    validations:
+      required: false
+
   - type: textarea
     id: scope
     attributes:
@@ -48,4 +93,3 @@ body:
       description: 参考リンク、画面例、関連Issue/PRなど
     validations:
       required: false
-

manuscript/chapter-issue-management/index.md

@@ -99,7 +99,9 @@ Issueテンプレートが用意されているリポジトリでは、作成時
 - **トリアージがしやすい**：`bug` / `documentation` / `question` など、分類と初動が揃う
 - **やりとりの往復が減る**：「情報が足りないので聞き返す」回数が減り、解決が早くなる
 
-このリポジトリでは例として、`bug` / `enhancement` / `documentation` / `question` のIssue Formsを `.github/ISSUE_TEMPLATE/` に同梱しています。自分のプロジェクトで使う場合は、まずは「バグ報告」と「ドキュメント改善」だけ導入するのがおすすめです。
+このリポジトリでは例として、`bug` / `enhancement` / `documentation` / `question` に対応する Issue Forms を `.github/ISSUE_TEMPLATE/` に同梱しています（例：`bug_report.yml` / `feature_request.yml` / `docs_change.yml` / `question.yml`）。
+
+AI/エージェント支援で PR を作る前提の場合は、Issue の情報不足が運用事故や手戻りに直結します。最低限、**受入基準（DoD）**・**制約（変更禁止領域）**・**テスト方法** を埋める運用にすると安全です（本リポジトリのフォームにも同観点の欄を入れています）。
 
 **Step 2: タイトルの設定**
 
@@ -129,6 +131,9 @@ Issueテンプレートが用意されているリポジトリでは、作成時
 ## 期待する動作
 メニューが画面内に収まって表示される
 
+## 実際の動作
+メニューが画面外にはみ出し、右端が見切れる
+
 ## 環境情報
 - デバイス: iPhone 12
 - ブラウザ: Safari 15.0

manuscript/chapter-pull-requests/index.md

@@ -204,7 +204,7 @@ Pull Requestの作成からマージまでの一連の流れを理解し、効
 
 ---
 
-## 7.4 コンフリクト（競合）の理解と解決
+## 7.4 PRレビューと運用（テンプレート / CODEOWNERS）
 
 ### PRテンプレートの構造
 
@@ -228,6 +228,18 @@ AI 支援の運用ルール（機密入力の禁止、確認観点など）は
 
 - AI利用ポリシー（テンプレ）：https://github.com/{{ site.repository }}/blob/main/AI_USAGE_POLICY.md
 
+### PRレビュー状態
+
+![PRレビュー状態]({{ '/assets/images/diagrams/chapter08/05_pr_review_states.svg' | relative_url }})
+
+Pull Requestのレビュープロセスでは、様々な状態があります。各状態の意味を理解し、適切なアクションを取ることが重要です。
+
+### PRディスカッション管理
+
+![PRディスカッション管理]({{ '/assets/images/diagrams/chapter08/06_pr_discussion_management.svg' | relative_url }})
+
+Pull Requestでのディスカッションを効果的に管理することで、チーム全体のコミュニケーション品質と開発効率を向上させましょう。
+
 ### AI生成PRのレビュー観点（最小セット）
 
 AI生成のPull Requestは「速く作れる」一方で、意図・検証・安全性が省略されがちです。レビューでは「AIが作ったか」ではなく、次の観点で確認すると、主観ではなく手順として運用できます。
@@ -248,17 +260,39 @@ AI生成のPull Requestは「速く作れる」一方で、意図・検証・安
 - 設定ファイル: `.github/CODEOWNERS`
 - できること: 特定のパス（例：`docs/`）の変更が入ったときに、担当者（ユーザー/チーム）へレビュー依頼を自動化できる
 
-このリポジトリでは、`manuscript/**`（本文）と `src/**`（元原稿）を例として `CODEOWNERS` に記載しています。自分のプロジェクトで使う場合は、まずは **「docs/ は文書担当」** だけ決めると運用しやすくなります。
+このリポジトリでは、例として `manuscript/**`（本文）・`docs/**`（公開サイト）・`src/**`（元原稿）を `CODEOWNERS` に記載しています。自分のプロジェクトで使う場合は、まずは **「docs/ は文書担当」** だけ決めると運用しやすくなります。
+
+また、`CODEOWNERS` は **パターンの順序が重要**で、複数マッチする場合は「最後にマッチした行」が優先されます。
 
 **レビューが詰まるときの対処（例）**
 - 代替担当（バックアップ）を決め、CODEOWNERSに追加する
 - ローテーション（当番表）で担当を回す（人に依存しない）
 - 必須レビュー数や必須チェック（CI）と組み合わせ、例外運用の手順も決める
 
-### コンフリクトが発生する原因
+### PRマージ戦略
+
+![PRマージ戦略]({{ '/assets/images/diagrams/chapter08/07_pr_merge_strategies.svg' | relative_url }})
+
+Pull Requestをマージする際には、様々な戦略があります。プロジェクトのポリシーや履歴管理の方針に応じて、適切なマージ戦略を選択しましょう。
+
+### PR自動化ツール
+
+![PR自動化ツール]({{ '/assets/images/diagrams/chapter08/08_pr_automation_tools.svg' | relative_url }})
+
+効率的なチーム開発のために、PRプロセスの一部を自動化することができます。CI/CD、自動テスト、コード品質チェックなどのツールを活用しましょう。
+
+### ブランチワークフローパターン（参考）
+
+![ブランチワークフローパターン]({{ '/assets/images/diagrams/chapter06/16_branch_workflow_patterns.svg' | relative_url }})
+
+---
+
+## 7.5 コンフリクト（競合）の理解と解決
 
 コンフリクト（競合）は、同じファイルの同じ箇所が、異なるブランチで別々の内容に変更された場合に発生します。
 
+### コンフリクトが発生する原因
+
 **発生例：**
 ```text
 main ブランチ：
@@ -326,18 +360,6 @@ Welcome to Our Website (mainブランチの内容)
 - GitHub Desktopで「Mark as resolved」
 - 「Continue merge」でマージ完了
 
-### PRレビュー状態
-
-![PRレビュー状態]({{ '/assets/images/diagrams/chapter08/05_pr_review_states.svg' | relative_url }})
-
-Pull Requestのレビュープロセスでは、様々な状態があります。各状態の意味を理解し、適切なアクションを取ることが重要です。
-
-### PRディスカッション管理
-
-![PRディスカッション管理]({{ '/assets/images/diagrams/chapter08/06_pr_discussion_management.svg' | relative_url }})
-
-Pull Requestでのディスカッションを効果的に管理することで、チーム全体のコミュニケーション品質と開発効率を向上させましょう。
-
 ### コンフリクト予防のベストプラクティス
 
 **1. 頻繁なマージ**
@@ -356,20 +378,6 @@ Pull Requestでのディスカッションを効果的に管理することで
 - 機能ごとにファイルを分離
 - 共通部分の変更は慎重に
 
-### PRマージ戦略
-
-![PRマージ戦略]({{ '/assets/images/diagrams/chapter08/07_pr_merge_strategies.svg' | relative_url }})
-
-Pull Requestをマージする際には、様々な戦略があります。プロジェクトのポリシーや履歴管理の方針に応じて、適切なマージ戦略を選択しましょう。
-
-### PR自動化ツール
-
-![PR自動化ツール]({{ '/assets/images/diagrams/chapter08/08_pr_automation_tools.svg' | relative_url }})
-
-効率的なチーム開発のために、PRプロセスの一部を自動化することができます。CI/CD、自動テスト、コード品質チェックなどのツールを活用しましょう。
-
-![ブランチワークフローパターン]({{ '/assets/images/diagrams/chapter06/16_branch_workflow_patterns.svg' | relative_url }})
-
 ---
 
 ## まとめ