AIによる、AIのためのプロジェクトドキュメント改善 / Improving Project Documentation with AI, for AIstrongest AI agent

チームの知識、ちゃんと残せていますか？ ナレッジ共有の現場ノウハウ
https://uniquevision.connpass.com/event/377047/

開発現場のドキュメントやナレッジには、3つの課題がつきまといます。
・書かれない
・読まれない
・見つからない
ADR・ポストモーテム・社内Wikiの運用など、各社が「チームの知識を残し、活かす」ためにやっている工夫を持ち寄り共有する場です。

Transcript

1. AIによる、AIのための プロジェクトドキュメント改善 チームの知識、ちゃんと残せていますか？ ナレッジ共有の現場ノウハウ Delight Exciting Eager Exceed
2. 2 Copyright © Adways DEEE Inc. All Rights Reserved. self-introduction 自己紹介 友田　直人（Tomoda Naoto） - 株式会社 ADWAYS DEEE - 技術改善ディビジョン バイスゼネラルマネジャー プロダクト開発や自社システムの開発を経て、 プロジェクトリーダーやスクラムマスターを経験。 現在は、複数チームのエンジニアリングマネージャーを務めながら、 組織の開発生産性向上やAI活用にも注力中。
3. 3 Copyright © Adways DEEE Inc. All Rights Reserved. 伝統と革新が融合する、 伝統は革新へ。 長年培ってきた知識や技術を常に変化させることで、 伝統的でありながら革新的なサービス・プロダクトに昇華させます。 Delight ADWAYS DEEE 喜び わくわく 熱⼼ 超える そして、私たちの熱量はステークホルダーの 想像を超えた、喜びやわくわくを生み出します。 About Us あたらしい集合体へ。 アフィリエイト=古い、時代遅れ。 そんな概念を覆し、新しい価値を創造します。 Exciting Eager Exceed この4つが私たちDEEEをカタチづくる言葉です。
4. 4 Copyright © Adways DEEE Inc. All Rights Reserved. introduction ドキュメント管理の悩み - 仕様書・意思決定などがドキュメントとして残らない - チームによってドキュメント管理方法がバラバラ - プロジェクトによっても・・・(涙 この発表で話すこと こんな悩みを持つエンジニアへ
5. 5 Copyright © Adways DEEE Inc. All Rights Reserved. introduction AI活用の悩み - ドキュメントを整備しても、AIでうまく活用できていない - AIが古い情報や断片的なコンテキストをもとに動いてしまう - チームでのAI活用方法が統一されていない この発表で話すこと こんな悩みを持つエンジニアへ
6. 6 Copyright © Adways DEEE Inc. All Rights Reserved. CONTENTS CONTENTS 01｜AIによるドキュメント改善 02｜AIのためのドキュメント整備 03｜まとめ
7. Delight Exciting Eager Exceed Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1 AIによるドキュメント改善
8. 8 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 😵 プロジェクトの記録が残らない 🚨 仕様書・設計書が更新されないまま放置される 🚨 意思決定の経緯が残らず「なぜこうなったか」がわからなくなる 🚨 振り返り(学び)が整理されず、チームの資産にならない 自社でのプロジェクト管理の悩み 😵 チームによってドキュメント管理方法がバラバラ 🚨 ドキュメントの分類・命名・格納場所が統一されていない 🚨 引き継ぎのたびに、属人知識のロスが発生
9. 9 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 取り組み プロジェクトキックオフの標準化 × Claude Code
10. 10 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 プロジェクトキックオフの標準化 × Claude Code 🚨 記録に残らない（何を） → 最初から記録すべき項目をテンプレートで定義 課題へのアプローチ 🚨 管理方法がバラバラ（どこに） → プロジェクトテンプレート（Notion）をチーム共通の型として統一！
11. 11 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 プロジェクトキックオフの標準化 × Claude Code ① テンプレートで必要なドキュメントを固定 Solution(解決策) • ガイドラインの整備 • Notionによるデータベース管理
12. 12 Copyright © Adways DEEE Inc. All Rights Reserved. ② AIでスキル化し、組織で利用 Claude Code 自作スキル /project-kickoff でプロジェクトページを自動生成 →定型作業（ページ作成・構造化）はAIに任せる Solution(解決策) CHAPTER 1｜AIによるドキュメント改善 プロジェクトキックオフの標準化 × Claude Code
13. 13 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 取り組み Project Close Check Listの導入
14. 14 Copyright © Adways DEEE Inc. All Rights Reserved. 🚨 仕様書・設計書が更新されない → ドキュメントの棚卸しで最終状態を確認・整理 CHAPTER 1｜AIによるドキュメント改善 Project Close Check Listの導入 課題へのアプローチ 🚨 振り返り（学び）が記録されない →振り返りの実施をクローズ時の必須イベントに 🚨 管理方法がバラバラ →プロジェクトのクローズの手順をチーム共通の型として統一！
15. 15 Copyright © Adways DEEE Inc. All Rights Reserved. 📌 チェックリスト（6項目） 1. 完了定義の確認 2. OKR・目標の達成確認 3. タスクの整理 4. 振り返りの実施 5. ドキュメントの棚卸し 6. チームの打ち上げ🍻 プロジェクトクローズを、必須のチームイベントにする。 Solution(解決策) CHAPTER 1｜AIによるドキュメント改善 Project Close Check Listの導入
16. 16 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 📊 効果 学びと効果 • スキル展開時に組織の半数近くのメンバーから 👍 12件。「使ってみます」の反応が返ってき た。また、徐々に利用プロジェクトも増加中 • プロジェクトクローズが文化定着。（打ち上げも飲み会も増えた🍺） • 自動化することで残すべきドキュメントのブレや漏れを防げる。 また、10分以上かかっていたプロジェクト開始の準備が1分以内に短縮
17. 17 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 学びと効果 💡 学び 「型」や「テンプレート」 ＋ AIで文化定着を促進 → ガイドライン整備と AI 活用を両輪で進める
18. Delight Exciting Eager Exceed Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 2 AIのためのドキュメント整備
19. 19 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 2｜AIのためのドキュメント整備 ✅ ここまでできたこと • プロジェクト管理の「型」をAI（Claude Code）を使って自動化 • 人のためのドキュメント資産を残す仕組みを改善 next stage 🆕 AI 前提時代の幕開け 人にフォーカスした改善から、一歩踏み込んでAI活用を見据えたAIのための改善が必要に 整備したドキュメントを活用して、AIの価値を最大化していくことが大事
20. 20 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 2｜AIのためのドキュメント整備 📚 Notion：人間の意思決定・ドメイン情報 Notion + リポジトリでのドキュメント管理 AIのため①：ドキュメントの再配置 🗒 GitHub：リポジトリ（コード）の近くにあるべきドキュメント
21. 21 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 2｜AIのためのドキュメント整備 • AIによるPR監視（deploy/定期） → ドキュメントの自動修正・更新 AIのため②：最新情報を保つ仕組み・情報が蓄積される仕組み • 議事録・作業ログ・コミュニケーションログ → 意思決定を自動提案 ・ユビキタス ・ドメイン情報 ・ADR ・SPECファイル（OpenSpec） ・機能仕様 ・API仕様 ・プロジェクト情報 ・Runbook（マニュアル） ・議事録 ・作業ログ ・ユビキタス ・コミュニケーションログ ・作業ログ ・ADR ・PDR(Project Decision Record) ・MDR(Management Decision Record) ・PR情報 ・MR情報
22. 22 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 2｜AIのためのドキュメント整備 AI活用を前提としたガイドラインなどのドキュメント整備。 AIのため③：ガイドラインの整備 技術ガイドラインの作成 - Go/Scala/Python/Perl - Ansible/Terraform ☝ なるべく一般的なプラクティスではなく、組織独自のルールなどをテンプレートに落とし込む テンプレートの拡充 - ADR/意思決定/ストーリー/Runbook/Cookbook
23. 23 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 1｜AIによるドキュメント改善 - AIが参照しやすい → AIの学習効率が上がる - ドキュメントが常に最新 → AIが古い情報を参照するリスクがなくなる - 意思決定が自動記録 → 「なぜこうなったか」が追跡できる - 運用ルールが明確 → チーム全体で一貫したAI活用がスタンダードに 📢見込まれる効果（想定） 🎁 副次効果 - 新メンバーのオンボーディング改善（情報の在り処が明確） - 人間にとっても「なぜそう決めたか」の追跡が容易 ※ まだ構想段階や検証段階。実績は今後共有予定
24. Delight Exciting Eager Exceed Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 3 まとめ
25. 25 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 3｜まとめ ☑「型・テンプレート」＋ AIの自動化が、ドキュメントの文化定着を促進する ☑ AIのためにドキュメントを整備することで、AIの品質と活用が加速する 　 改善サイクルが生まれる ☑ 最終的な意思決定は人が担う。良いドキュメントは人間にもAIにも効果的
26. 26 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 3｜おまけ ✏ プロジェクトの「はじまり」をAIと一緒に効率化した話 https://blog.engineer.adways.net/entry/2026/04/15/120000 ✏ おくりびと。プロジェクトの終活のすすめ https://blog.engineer.adways.net/entry/2025/07/09/120000 今回発表した取り組みのブログです。
27. 27 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER 3｜まとめ ご清聴ありがとうございました。