30秒でわかる — このパックで何ができるか
AIに「開発を全部任せる」のではなく、要件・設計・PR・テストの手前に品質チェックを差し込むための調査・提案・PoCキットです。読むだけで終わらず、bonus_kit をコピーすればその日から試せます。
- 社内説明 — 15分で「なぜ今・何を測る・いつやめるか」を説明できる資料（第0章・第19章）
- PoC設計 — 3か月・テーマ1〜3本・KPI・中止条件までテンプレ付き（第11〜13章）
- すぐ試す — PR前レビュー・要件ゲート・週次KPI記録などスキル8本＋Cursorルール同梱（bonus_kit）
- 続くか判断 — 数値とガバナンスで継続 / 限定 / 中止を合意（第12章・19.5b）
dev_docs_guide との違い: 本パックは導入可否と効果の検証が主題。PoC成功後に REQ/ADR/OpenAPI の常時運用が必要になったら、姉妹資料 工程別ドキュメント運用ガイド（定着フェーズ）へ。
導入の魅力 — Before / After（想定）
数値はPoC前の仮説です。自社 baseline を取ってから比較してください（第12章）。
Before（よくある状態）
- AI出力をそのまま採用 → 仕様ズレ・手戻り
- 個人のプロンプト頼み → 再現性なし
- 「AI入れた」だけで KPI 不明 → 続ける/やめるが議論できない
- レビューは人間のみ → ボトルネック化
After（本パックで目指す姿）
- 工程内ゲート — 曖昧語・diff・観点漏れを AI が下書きチェック、人間が採否
- Git管理スキル — 手順を
.agents/skills/に固定、属人化を減らす - 週次KPI — レビュー時間・採用率・手戻りを記録し、3か月で判定
- 実装≠レビューAI — 別モデルで一次チェック（第17章 17.0）
3本柱 — 具体的にやること
柱1 · 工程内品質ゲート
提出前に AI チェックを1段挟む。仕様を補完させず、曖昧語・未決・diff 指摘に限定。
$requirements-definition-gate · $ai-quality-pr-review · 曖昧語スクリプト
柱2 · 標準スキル＋ルール
「うまい人のプロンプト」から、リポジトリ同梱の呼び出し可能スキルへ。組織横断の蓄積は PMO AIPC（社内ノウハウ蓄積 MCP Server）が担う。
bonus_kit: 8スキル · Cursor ai-quality-*.mdc 2本
PMO AIPC — 社内ノウハウ蓄積地（Hermes + Ollama · MCP Server）
PMO AIPC は「別 PC」一般論ではなく、セキュリティ担保エリアに置く Hermes + Ollama の MCP Server — 組織の社内ノウハウ蓄積地です。Skill · 手順 · レビュー観点 · プロンプト型 · 失敗パターンをここに集約し、開発 PC は MCP Client として参照・依頼するだけ。Hermes は Cursor/Codex の代替ではなく整流・記憶レイヤー（Cursor LLM 透明中継は不可）。
推奨: ノウハウ蓄積 MCP Server
- セキュアゾーン内に MCP Server（Hermes + Ollama）を PMO/インフラが運用
- 蓄積: approved/draft Skill · 手順型 · 観点 · lessons-learned（非機密のみ）
- 開発 PC: Cursor 実装 · Codex レビュー — ソース・鍵は手元
- MCP ツール:
search_skill·format_cursor_prompt·submit_lesson_draft等（allowlist）
非推奨: 開発 PC 直置き Hermes
- ソース + 資格情報 + 自律 Agent のblast radius 同居
- ノウハウが個人 PC に散在 — 組織の蓄積地にならない
- 「Cursor チャット → Hermes → Cursor LLM 枠」の幻想
| 観点 | メリット | 注意 |
|---|---|---|
| セキュリティ | ノウハウサーバをセキュアゾーンに閉じ、開発 PC からは MCP のみ | ツール定義が広いと再び全権限化 |
| 理念 | 個人プロンプト → 組織の蓄積地。Hermes=整流 · Cursor=実装 · Codex=レビュー | draft/approved 昇格と月次棚卸し必須 |
| 標準化 | 全員が同じ Skill · 観点を MCP 経由で取得 → Git 正本へ approved 反映 | Ollama 単体では高度推論弱い — 整形/検索に限定 |
| PoC | Phase1=指示整形 → Phase2=Codex観点 → Phase3=lesson draft 蓄積 | ゾーン要件 · MCP 実装方式は UNRESOLVED |
詳細: 第20章 Hermes / PMO AIPC · 第17章 17.0a · 第9章 · dev_docs_guide 第10章
職種別 — あなたに何があるか
| 職種 | このパックでできること（具体） | まず開く章 | 同梱スキル例 |
|---|---|---|---|
| 経営 · 提案 | 3本柱・PoC投資・中止条件の説明。15分ピッチ用 | 00 → 19 | — |
| PG | PR前に別モデルで diff レビュー。TDD観点の下書き（採否は人間） | 3.7 · 6 | $ai-quality-pr-review |
| SE · 設計 | 要件・設計の曖昧語・未決・意味逸脱を検出のみ | 4.0b | $requirements-definition-gate |
| QA | テスト観点表の下書き。期待値は人間確定（無審査採用禁止） | 5.0b | 第10章プロンプト |
| レビュー · TL | 敵対的レビューで「食い違い箇所」だけ人が判断 | 6.0b | $ai-quality-pr-review |
| PM · PMO | 週次 KPI 集約・open-items 整理・PoC 継続判定 | 8 · 11 | $ai-poc-weekly-kpi |
| インフラ · PMO | PMO AIPC（ノウハウ蓄積 MCP Server）構築 · Hermes/Ollama 運用 | 第20章 · 9.0b | 第17章 17.0a |
PoCテーマ例 — 1〜3本に絞る
全部やらない。主テーマを決め、KPI と中止条件を第19章に書く（poc-theme-register.md 連動）。
| ID | テーマ | 何を測るか（例） | 週次で見ること |
|---|---|---|---|
| P1 | PR前セルフレビュー | レビュー時間 · AI指摘の採用率 · 手戻り件数 | 第12章 P-1 / R-1 |
| P2 | 要件・設計レビュー | 曖昧語件数 · 未決（open-items）滞留 | 第12章 S-1 |
| P3 | （空欄 — 自社で1本追加） | TDD / 単体テスト観点 等 | 第11章で合意 |
3か月後: 継続 / 限定継続 / 改善後再試行 / 中止 を第19章 19.5b の条件で判定。測定できなかったテーマは「効果不明」として中止候補。
読み方ルート — 時間の目安付き
研修入口 · まずここ到達目標、確認テスト、演習期待結果。第17章以降は上級編として整理。
15分 · 社内説明00 提案 → 19 マスタ。投資判断の材料だけ欲しいとき。
45分 · PoC設計11 PoC → 12 KPI → 13 ガバナンス。テーマと中止条件まで。
30分 · その日から試すbonus_kit を試行ブランチへ。PR前スキルを1本実行。
20分 · AI役割分担17.0 4役割 · 17.0b Agent-native CI/CD · 17.0a Hermes（限定）。
深掘り · 全20章職種別第3〜9章 · プロンプト第10章 · 参照第16章。
定着後PoC成功後の REQ/ADR/OpenAPI 常時運用は dev_docs_guide へ。
第1週 — 迷わない進め方
- 読む（1時間） — 本ページ → 00 提案 → 19 マスタ。PoCテーマ候補を1〜3本メモ。
- 決める（30分） — 第13章 で禁止事項・データ分類を確認。試行リポジトリを決める。
- 置く（30分） — bonus_kit を試行ブランチにコピー。Cursor ルール有効化。
- 試す（1 PR） — 小さな PR で
$ai-quality-pr-reviewまたは$requirements-definition-gateを1回。結果を PR テンプレに記録。 - 測る（週末15分） —
$ai-poc-weekly-kpiで第12章の指標を1行記録。第19章とknowledge/metrics.yamlを更新。
bonus_kit — コピーしたらすぐ使えるもの
| 種別 | パス / 呼び出し | いつ使うか |
|---|---|---|
| Cursor ルール | .cursor/rules/ai-quality-*.mdc | 常時 — AI利用範囲・証跡の制約 |
| PR前品質 | $ai-quality-pr-review | PR 作成前 · diff 一次チェック |
| 要件ゲート | $requirements-definition-gate | 要件着手前 · 曖昧語・BLOCKER |
| 意味逸脱 | $requirements-semantic-drift-audit | 版間・資料間の食い違い検出 |
| 週次 KPI | $ai-poc-weekly-kpi | 毎週 — PoC 数値の記録 |
| 軽量ゲート他 | $dev-docs-gate-lite 等 | 小規模案件 · ドキュメント PR |
手順詳細: bonus_kit/AGENTS.md · 軽量版は starter_kit（PoCたたき台）。
配布物の構成
| パス | 内容 | いつ使う |
|---|---|---|
| ai_quality_research_html/ | 調査 HTML 全20章（00提案〜19マスタ） | 社内説明 · 深掘り |
| notes/ | Obsidian 用 Markdown（章別・正本） | 更新 · 版管理 |
| knowledge/ | 施策 · KPI · スキル · PoC の YAML 索引 | トレーサ · レポート |
| starter_kit/ | PoC試行のたたき台（軽量） | 最初の1週間 |
| bonus_kit/ | Cursor ルール + スキル8本 + PR/KPI 様式 | 本番級の試行（推奨） |
articles/ | Qiita/Zenn向け公開記事 | 外部発信用の下書き |
Markdown 正本 + YAML 索引（更新するとき）
notes/ が章の Markdown 正本、knowledge/*.yaml が PoC トレーサ用の構造化索引です。HTML 第19章は読み物、数値・採否の機械可読版は YAML と同期します。
| パス | 用途 |
|---|---|
notes/19_総評一覧.md | スキル · 施策 · KPI の文章正本 |
knowledge/traceability.yaml | 施策 ↔ KPI ↔ スキル ↔ リスク |
bonus_kit/reference/poc-theme-register.md | PoC テーマ ID（P1/P2/P3）登録 |
tools/ · reports/ | 抽出手順 · レビューチェックリスト |
よくある不安 — 短く答える
- AIに開発を任せる提案ですか？
- いいえ。品質確認の副操縦士です。仕様の最終判断・本番変更は人間（第1章）。
- すぐ全社展開が必要？
- 不要。3か月 PoC・1〜3テーマ・試行ブランチから（第11章）。
- スキルは GitHub の人気順で入れる？
- しません。第19章一覧 → 第13章 13.2d チェック → PoC試用。Installs/Stars は参考値のみ。
- PoC が成功したら？
- REQ/ADR/OpenAPI の常時運用は dev_docs_guide（定着フェーズ）。
- Hermes Agent も入れる？
- 常時稼働はRunbook下書き限定。第9章・第13章審査後。IDE内4役割（第17章 17.0）とは別物。
参考リンク
- 調査トップ（index） — 2026-06 追記のエージェント運用入口あり
- 第19章 総評シート — 判断マスタ
- note: AI役割分担の参考事例
- 定着フェーズ: 工程別ドキュメント運用ガイド
