Upgrade to Pro — share decks privately, control downloads, hide ads and more …

AIによる、AIのためのプロジェクトドキュメント改善 / Improving Project ...

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.

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

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

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

Avatar for naoto

naoto

May 25, 2026

Other Decks in Technology

Transcript

  1. 2 Copyright © Adways DEEE Inc. All Rights Reserved. self-introduction

    自己紹介 友田 直人(Tomoda Naoto) - 株式会社 ADWAYS DEEE - 技術改善ディビジョン バイスゼネラルマネジャー プロダクト開発や自社システムの開発を経て、 プロジェクトリーダーやスクラムマスターを経験。 現在は、複数チームのエンジニアリングマネージャーを務めながら、 組織の開発生産性向上やAI活用にも注力中。
  2. 3 Copyright © Adways DEEE Inc. All Rights Reserved. 伝統と革新が融合する、

    伝統は革新へ。 長年培ってきた知識や技術を常に変化させることで、 伝統的でありながら革新的なサービス・プロダクトに昇華させます。 Delight ADWAYS DEEE 喜び わくわく 熱⼼ 超える そして、私たちの熱量はステークホルダーの 想像を超えた、喜びやわくわくを生み出します。 About Us あたらしい集合体へ。 アフィリエイト=古い、時代遅れ。 そんな概念を覆し、新しい価値を創造します。 Exciting Eager Exceed この4つが私たちDEEEをカタチづくる言葉です。
  3. 4 Copyright © Adways DEEE Inc. All Rights Reserved. introduction

    ドキュメント管理の悩み - 仕様書・意思決定などがドキュメントとして残らない - チームによってドキュメント管理方法がバラバラ - プロジェクトによっても・・・(涙 この発表で話すこと こんな悩みを持つエンジニアへ
  4. 5 Copyright © Adways DEEE Inc. All Rights Reserved. introduction

    AI活用の悩み - ドキュメントを整備しても、AIでうまく活用できていない - AIが古い情報や断片的なコンテキストをもとに動いてしまう - チームでのAI活用方法が統一されていない この発表で話すこと こんな悩みを持つエンジニアへ
  5. 6 Copyright © Adways DEEE Inc. All Rights Reserved. CONTENTS

    CONTENTS 01|AIによるドキュメント改善 02|AIのためのドキュメント整備 03|まとめ
  6. Delight Exciting Eager Exceed Copyright © Adways DEEE Inc. All

    Rights Reserved. CHAPTER 1 AIによるドキュメント改善
  7. 8 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 😵 プロジェクトの記録が残らない 🚨 仕様書・設計書が更新されないまま放置される 🚨 意思決定の経緯が残らず「なぜこうなったか」がわからなくなる 🚨 振り返り(学び)が整理されず、チームの資産にならない 自社でのプロジェクト管理の悩み 😵 チームによってドキュメント管理方法がバラバラ 🚨 ドキュメントの分類・命名・格納場所が統一されていない 🚨 引き継ぎのたびに、属人知識のロスが発生
  8. 9 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 取り組み プロジェクトキックオフの標準化 × Claude Code
  9. 10 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 プロジェクトキックオフの標準化 × Claude Code 🚨 記録に残らない(何を) → 最初から記録すべき項目をテンプレートで定義 課題へのアプローチ 🚨 管理方法がバラバラ(どこに) → プロジェクトテンプレート(Notion)をチーム共通の型として統一!
  10. 11 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 プロジェクトキックオフの標準化 × Claude Code ① テンプレートで必要なドキュメントを固定 Solution(解決策) • ガイドラインの整備 • Notionによるデータベース管理
  11. 12 Copyright © Adways DEEE Inc. All Rights Reserved. ②

    AIでスキル化し、組織で利用 Claude Code 自作スキル /project-kickoff でプロジェクトページを自動生成 →定型作業(ページ作成・構造化)はAIに任せる Solution(解決策) CHAPTER 1|AIによるドキュメント改善 プロジェクトキックオフの標準化 × Claude Code
  12. 13 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 取り組み Project Close Check Listの導入
  13. 14 Copyright © Adways DEEE Inc. All Rights Reserved. 🚨

    仕様書・設計書が更新されない → ドキュメントの棚卸しで最終状態を確認・整理 CHAPTER 1|AIによるドキュメント改善 Project Close Check Listの導入 課題へのアプローチ 🚨 振り返り(学び)が記録されない →振り返りの実施をクローズ時の必須イベントに 🚨 管理方法がバラバラ →プロジェクトのクローズの手順をチーム共通の型として統一!
  14. 15 Copyright © Adways DEEE Inc. All Rights Reserved. 📌

    チェックリスト(6項目) 1. 完了定義の確認 2. OKR・目標の達成確認 3. タスクの整理 4. 振り返りの実施 5. ドキュメントの棚卸し 6. チームの打ち上げ🍻 プロジェクトクローズを、必須のチームイベントにする。 Solution(解決策) CHAPTER 1|AIによるドキュメント改善 Project Close Check Listの導入
  15. 16 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 📊 効果 学びと効果 • スキル展開時に組織の半数近くのメンバーから 👍 12件。「使ってみます」の反応が返ってき た。また、徐々に利用プロジェクトも増加中 • プロジェクトクローズが文化定着。(打ち上げも飲み会も増えた🍺) • 自動化することで残すべきドキュメントのブレや漏れを防げる。 また、10分以上かかっていたプロジェクト開始の準備が1分以内に短縮
  16. 17 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 学びと効果 💡 学び 「型」や「テンプレート」 + AIで文化定着を促進 → ガイドライン整備と AI 活用を両輪で進める
  17. Delight Exciting Eager Exceed Copyright © Adways DEEE Inc. All

    Rights Reserved. CHAPTER 2 AIのためのドキュメント整備
  18. 19 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    2|AIのためのドキュメント整備 ✅ ここまでできたこと • プロジェクト管理の「型」をAI(Claude Code)を使って自動化 • 人のためのドキュメント資産を残す仕組みを改善 next stage 🆕 AI 前提時代の幕開け 人にフォーカスした改善から、一歩踏み込んでAI活用を見据えたAIのための改善が必要に 整備したドキュメントを活用して、AIの価値を最大化していくことが大事
  19. 20 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    2|AIのためのドキュメント整備 📚 Notion:人間の意思決定・ドメイン情報 Notion + リポジトリでのドキュメント管理 AIのため①:ドキュメントの再配置 🗒 GitHub:リポジトリ(コード)の近くにあるべきドキュメント
  20. 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情報
  21. 22 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    2|AIのためのドキュメント整備 AI活用を前提としたガイドラインなどのドキュメント整備。 AIのため③:ガイドラインの整備 技術ガイドラインの作成 - Go/Scala/Python/Perl - Ansible/Terraform ☝ なるべく一般的なプラクティスではなく、組織独自のルールなどをテンプレートに落とし込む テンプレートの拡充 - ADR/意思決定/ストーリー/Runbook/Cookbook
  22. 23 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    1|AIによるドキュメント改善 - AIが参照しやすい → AIの学習効率が上がる - ドキュメントが常に最新 → AIが古い情報を参照するリスクがなくなる - 意思決定が自動記録 → 「なぜこうなったか」が追跡できる - 運用ルールが明確 → チーム全体で一貫したAI活用がスタンダードに 📢見込まれる効果(想定) 🎁 副次効果 - 新メンバーのオンボーディング改善(情報の在り処が明確) - 人間にとっても「なぜそう決めたか」の追跡が容易 ※ まだ構想段階や検証段階。実績は今後共有予定
  23. 25 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    3|まとめ ☑「型・テンプレート」+ AIの自動化が、ドキュメントの文化定着を促進する ☑ AIのためにドキュメントを整備することで、AIの品質と活用が加速する   改善サイクルが生まれる ☑ 最終的な意思決定は人が担う。良いドキュメントは人間にもAIにも効果的
  24. 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 今回発表した取り組みのブログです。
  25. 27 Copyright © Adways DEEE Inc. All Rights Reserved. CHAPTER

    3|まとめ ご清聴ありがとうございました。