7. PM・情報共有 | 工程別ドキュメント運用ガイド

主な読者: 経営PMSE

経営層投資対効果とリスク低減の判断材料。全文読む必要はなく、KPIとBefore/Afterで十分。
この章ダッシュボード

PM合意・スコープ・未決の管理。正本が1か所なら炎上の早期検知と説明責任が楽になる。
この章本章が中心

SE構造・IF・例外の設計品質。MD+Mermaid+OpenAPIでレビューとAI支援の精度が上がる。
この章ゲート入力

PG実装の迷いが減る。AGENTS.md・型生成・PRテンプレで「聞き直し」工数が減る。

PMの司令塔：MASTER + ゲート

PM司令塔の主要成果物と役割
成果物	役割
baseline-agreements.md	合意済み / 未決の索引
open-items.md	確認待ち
traceability-matrix	REQ↔設計↔テスト
semantic-drift-audit	版間の意味逸脱検出

公開スキル採用の注意: 人気順だけで .agents/skills/ に取り込まない。データ分類・RACI・社内レビュー後に採用する（例: リポジトリ内スキル同期スクリプトで Codex / Cursor を揃える）。

週次運用（PM）

未決事項を open-items から更新
要件・議事録の drift チェック（AI支援可）
レビュー用HTMLの差分を共有（必要時のみ）
ゲート判定：基本設計着手可否

AI運用ログから正本へ改善を還流する

Human Gateで止めた理由を週次レビューし、改善先を正本・ADR・rules・FAQ・承認ルールへ戻す。着想元は Qiita: AI運用ログを週次レビューし、FAQ・CRM・承認ルールへ戻すGAS実装。GASは必須ではなく、PoC初期は手動記録でよい。

Human Gate / AI利用
  → 理由を4項目で記録
  → 週次で分類・件数確認
  → 改善候補を人間が選択
  → Git正本 / ADR / rules / FAQ / 承認ルールへ反映
  → 次週のログで効果確認

PoCで残す最小ログ
項目	用途	例
`gate`	どの確認点で止まったか	requirements / PR / release
`human_review_reason`	人間へ戻した理由の分類	missing_context / low_confidence / approval_rule
`blocked_reason`	止まった事実を短く記録	対象外範囲が未確定
`improvement_target`	改善候補	REQ / FAQ / CRM / ADR / rule / template

正本境界: ログと確定した改善はGit上のMarkdown/YAMLへ置く。スプレッドシートは一時集計に限り、顧客名・問い合わせ本文・機密情報を保存しない。

自動化条件: 最初の1〜2週間は手動。分類が安定してから集計だけを自動化する。改善チケットの自動起票や未入力による強制ブロックはPoC段階では行わない。

全立場への一言

全立場への要約メッセージ
経営	「正本が1つ」= 説明責任と予測可能性
PM	散らばったExcelより、索引+ゲートの方が楽
SE	図とIDがあるとレビューが早い
PG	型とAGENTS.mdがあると実装が早い

この工程で使う AI（PM・ゲート）

PM — 軽量集約と意味逸脱監査
役割	ツール例	優れている点	典型用途
週次サマリー	Composer 系 · ChatGPT	低コストで open-items 要約	`weekly_*.md` 下書き
drift 監査	requirements-semantic-drift-audit スキル	版間・資料間の意味変化検出	議事録 ↔ REQ の食い違い
工程ゲート	LAO · JumpStart 型オーケストレータ	工程間の人間承認を明示	基本設計着手可否
ドキュメント鮮度	Notion AI · Mintlify 系	長文スレッドの要約・索引	合意索引のメンテナンス補助

成果物サンプル一覧

実際のプロジェクトではファイル名・パスをテンプレに合わせてください。以下は掲載可能な具体イメージ（HTML/CSS埋め込み）です。

reference/baseline-agreements.md

合意索引

合意索引（baseline-agreements）
項目	状態	根拠
スコープ: 受注キャンセル	CONFIRMED	6/10 読み会
非機能: 応答2秒	SHARED	仮置き
返品フロー	UNRESOLVED	OI-12

reports/weekly_2026-W24.md

週次ステータス（PM）

file:///review/weekly_W24.html

週次 — 2026-W24

ゲート: 基本設計 CONDITIONAL GO
未決: 3件（OI-12, OI-15, OI-18）
drift-audit: 議事録↔要件 1件要確認

08_gate-decision.md

ゲート判定（詳細）

✓ 用語集整備 — OK

△ 曖昧語12件 — 要修正

✗ 未決3件 — 確認待ち

判定: CONDITIONAL GO（条件: OI-12 解消後に再判定）

drift-audit_report.md

意味逸脱監査レポート

意味逸脱監査（semantic-drift-audit）レポート例
資料A	資料B	差分	重大度
議事録 6/5	REQ-042	「即時在庫戻し」→「翌営業日」	高
提案書	要件一覧	スコープ外の記述なし	—

オンボーディング — PM コース（ゲート演習 10分）

架空プロジェクトで gate-decision.md を埋める: 着手可 / 条件付き / 停止 — 理由1行。

open-items が 3件未解消
REQ-012 に曖昧語「適宜」残存
トレーサ CSV が空

模範: 停止または条件付き — 曖昧語解消と open-items クローズまで着手不可。

リンク	用途
経営サマリー	ROI
マスタ	RACI・変更マトリクス
driftスキル	意味逸脱監査
要件	合意ログ