エンジニアのためのドキュメント力基礎講座～構造化思考から始めよう～

by 中野康雄（ARI）

Slide 1

Slide 1 text

エンジニアのためのドキュメント力基礎講座～構造化思考から始めよう～ 2025年11月29日ＡＲアドバンストテクノロジ株式会社中野康雄（@yasuoyasuo） Backlog World 2025

Slide 2

Slide 2 text

自己紹介 2 中野康雄（51） @yasuoyasuo ＡＲアドバンストテクノロジ株式会社（ARI）取締役執行役員元BacklogWorld運営（2020～2024） ➢ 略歴 1999 ITエンジニア＆コンサルタント（10年） 2009 Webサービス企画＆開発管理（2年） 2011 マネジメントコーチとして独立（1.5年） 2012 現職へジョイン ➢ 趣味食べ歩き、筋トレ、LEGO ➢ 最近はまっていること昭和平成の名作巡り（北の国から、白い巨塔等）

Slide 3

Slide 3 text

（PR）仲間を絶賛募集中です！ 3 DM開放しておりますカジュアル面談お待ちしております！

Slide 4

Slide 4 text

エンジニアとして必要なドキュメンテーション力とは？今日のテーマ 4 元々若手向けの研修メニューであるため経験ある皆さまにはやや釈迦に説法感がある旨ご了承ください

Slide 5

Slide 5 text

そもそもエンジニアにとってドキュメント力って必要？ 5 →これからますます重要になると思う

Slide 6

Slide 6 text

アジャイル時代はドキュメントは書かなくて良いドキュメントの必要性重要性は色褪せない合意形成や情報共有のためにドキュメントは一定数必要 6

Slide 7

Slide 7 text

プロジェクト工数の7割はドキュメント作成 7 引用： » 2019年度調査『ソフトウェアメトリックス調査2020 システム開発・保守調査』の報告資料 JUAS 一般社団法人日本情報システムユーザー協会 https://juas.or.jp/news/topics/2823/ 実はシステム開発でプログラミングなど実装は約 3割しかない

Slide 8

Slide 8 text

今後AI駆動が広がれば更に重要に 8 設計実装テストリリース AI Suite 選択・設計品質・効果レビュー効果測定方法の設計非機能テスト効果検証ドメイン知識ペインポイントの理解ビジネス効果の設計ユーザー体験の設計非機能の明確化効果の明確化要求分析要件定義 AI駆動開発ツール(Cursol, Claude Code, GitHub Copilot, Devin etc) ライフサイクルの継続的なアップデート人の領域 AIの領域参考：https://www.creationline.com/tech-blog/chatgpt-ai/ai/71718

Slide 9

Slide 9 text

AIをさらに賢くするインテリジェンスとしてのドキュメント 9 ドキュメントの価値はフローからストックへ AIエージェント時代には更にレバレッジがかかる拙稿：【参加レポート】Microsoft Ignite 2025 in San Francisco｜https://qiita.com/yasuoyasuo/items/5d61c81021387ab27a3d より

Slide 10

Slide 10 text

ドキュメント作成力はキャリア構築上も資産価値が高い 10 小手先のテクニック模倣されにくく長期的に発揮できる競争力誰でもできる作業参入障壁が低いスキル履歴書に書ける実績プロフェッショナルな能力短期的に築ける長期的に築く目に見えない目に見える

Slide 11

Slide 11 text

ヌーラボさんの提唱する「チームワークマネジメント」 11 https://nulab.com/ja/teamwork-management/ https://toyokeizai.net/articles/-/877554

Slide 12

Slide 12 text

Slide 13

Slide 13 text

今日のアジェンダ • ドキュメント作成に求められるスキル • 構造化思考とは？ • 構造化思考の説明と演習 • 構造化思考を効率的に進めるために • 構造化思考を踏まえたアプローチ • その他のスキル • 最後に 13

Slide 14

Slide 14 text

ドキュメント作成に求められるスキル 14

Slide 15

Slide 15 text

システム開発系ドキュメントの特徴 • 自分以外の誰かが読み、更新されることが前提とされる ➢ レビュワー ➢ 後工程の担当者 ➢ 保守担当者 ➢ AI • 抜け漏れや、読み手によって解釈が異なることは許されない ➢ 検討すべきことの抜け漏れは手戻り（工数増）につながる ➢ 解釈が異なる記述をしてしまった場合も同様 • 納期があり生産性が求められる ➢ 書き手が納得いくまで時間をかけて良いわけではない ➢ 事前に作成工数の見積りが求められる 15

Slide 16

Slide 16 text

システム開発系ドキュメントに求められること • 当たり前品質をクリアしていること ➢ 誤字脱字、最低限の体裁、表記の統一 ➢ 書くべき項目がすべて書かれている ➢ 内容が正確 • 読み手（特にAI！）にわかりやすいこと ➢ 全体構成、見出しの粒度、順序が適切 ➢ 各文章がわかりやすい ➢ 体裁が適切に「デザイン」されていること（タイトル、表紙、インデント、ページ番号など） • 生産性や作業管理性が高いこと ➢ 標準化され一定のルールがある方が書きやすく、レビューもしやすい ➢ 作成にかかるタスクが分解できている（見積りの精度が上がる） ➢ 完了までの段取りが出来ている（アウトライン化） 16

Slide 17

Slide 17 text

そもそもシステム開発とはどういった行為なのか？まずその本質を理解することからはじめたい効果的なドキュメンテーション力を得るために 17

Slide 18

Slide 18 text

システム開発の時間軸システム開発の大きな流れ要件人間の世界システムの世界設計実装（ソフトウェア/基盤）要求要望仕様要件 1.要望要求から要件に選別する 2.要件に対する仕様を記述する 3.仕様を満たすように設計する 4.設計通りに実装する 5.仕様＆要件の実現を確認する 18

Slide 19

Slide 19 text

システム開発の時間軸要件は仕様化されなければ実現できない要件人間の世界システムの世界氏名を表示できたらいいなその他多くの要望各ページに氏名を表示できること各ページのヘッダ部分に「○○[半角スペース]●●」と表示する。 ○○は姓、●●は名を表す。ユーザー内整理 QCD制約踏まえた要求精査各ページに氏名を表示したい網羅的かつ誤解を与えない言語化仕様の網羅的かつ誤解なき言語化がシステム開発の最初の勘所設計実装（コード）要求要望仕様要件 • あったらいいなだよね？目的は？本当に必要？ • 個人の意見？みんなの意見？ • 要求の優先順位は？ • 予算や納期踏まえて今回どれやる？ • ページのどこ？ • どんな風に表示するの？参考： https://qiita.com/digdagdag/items/2808205d89344ab8a3a1 イメージ 19

Slide 20

Slide 20 text

システム開発ドキュメントの勘所網羅的かつ誤解なき言語化 20

Slide 21

Slide 21 text

効果的なドキュメント作成に必要なスキル知識構造化思考力作文/表現技術記述対象に関する知識特にここがポイント！ 21

Slide 22

Slide 22 text

ユーザー向けドキュメントについてはどうか？ 22 エンジニアのためのドキュメントライティング / Docs for Developers and Paragraph Writing https://speakerdeck.com/nttcom/docs-for-developers-and-paragraph-writing

Slide 23

Slide 23 text

ドキュメントジャーニーは読み手理解から 23 エンジニアのためのドキュメントライティング / Docs for Developers and Paragraph Writing https://speakerdeck.com/nttcom/docs-for-developers-and-paragraph-writing

Slide 24

Slide 24 text

読み手理解と計画立てから始めることを推奨 24 構造化思考が肝になる

Slide 25

Slide 25 text

今回は構造化思考に絞ってお話します 25

Slide 26

Slide 26 text

構造化思考とは？ 26

Slide 27

Slide 27 text

構造化思考とは？全体を分解したり個別を集約することで情報を整理する考え方注：私の定義 27

Slide 28

Slide 28 text

構造化思考２つのアプローチ１．全体を分解する２．個別を集約する大きなテーマを分解して整理する思考の補助線を引き情報を整理する画像引用： https://www.missiondrivenbrand.jp/entry/thinking__Structured どっちも大切 28

Slide 29

Slide 29 text

構造化されている例資料間の関係 ➢ 画面一覧と画面設計書 ➢ 機能一覧と各機能設計書 ➢ システム構成一覧と構成別パラメータシート ➢ 移行全体スケジュールと各移行作業詳細手順書 ➢ 共通仕様書と各個別仕様書各資料内の目次構成例：要件定義書 1. システム導入の目的と目標 2. システムの概要／システムの構想 3. システム導入後の業務フロー 4. 機能要求 5. 入力要求と出力要求 6. 品質・性能要求 7. セキュリティ要求重複を避ける漏れ重複ない章立て（一般例） 29

Slide 30

Slide 30 text

構造化することのメリット（１）画像引用： https://www.missiondrivenbrand.jp/entry/thinking__Structured ドキュメントを作る上で最も避けるべき「漏れとダブリ」をなくせる 30

Slide 31

Slide 31 text

構造化することのメリット（２）枠組みが共有できると読み手に伝わりやすいなぜか？画像引用： https://www.missiondrivenbrand.jp/entry/thinking__Structured 31

Slide 32

Slide 32 text

情報＝枠組み＋内容「情報」とは「枠組み」と「内容」で構成される。「枠組み」が共有できると「内容」を受け取りやすい。（文脈）枠組み内容情報前提事項仕様進め方イメージ画像引用：https://www.itmedia.co.jp/bizid/articles/1009/21/news058.html 32

Slide 33

Slide 33 text

構造化のポイント 1. 上手に分ける 2. 文脈を意識する 3. 論点を見つける 33

Slide 34

Slide 34 text

構造化のポイント（１）上手に分ける分かる＝分ける 34

Slide 35

Slide 35 text

「分ける」の上手下手はどこで決まるか？ 1. 漏れダブリをなくす 2. 粒感を揃える 3. 順序を整える 35

Slide 36

Slide 36 text

これを気持ち悪いと思えるか？春、夏、冬野菜、肉、サンマ昭和、平成、大正、令和 36

Slide 37

Slide 37 text

枠組みの力を借りて情報伝達の精度を上げる春、夏、秋、冬野菜、肉、魚（サンマ）大正、昭和、平成、令和 37

Slide 38

Slide 38 text

これらへの感度を上げよう 1. 漏れダブリをなくす 2. 粒感を揃える 3. 順序を整える全体→詳細、時系列、大→小、頻出→レア、正常→異常など 38

Slide 39

Slide 39 text

構造化思考のポイント（２）文脈を意識する文字列は何を伝えているのか？ 39

Slide 40

Slide 40 text

それぞれに意味がある春、夏、秋、冬野菜、肉、魚（サンマ）大正、昭和、平成、令和 40 季節食材年号

Slide 41

Slide 41 text

こういう問題昔やりましたよね？問題：□に入るものを答えよ Q1：１, 2, 4, 8, □, 32, 64 Q2：J, F, M, A, M, □, J, A,・・・ 41 この問題の本質は、各Qの文脈を探すことにある

Slide 42

Slide 42 text

文脈は理解を助けてくれる 42 文脈がない状態文脈をつくる文脈がある状態

Slide 43

Slide 43 text

構造化思考のポイント（３）論点を見つけるある問題に対して答を見つけるために考えるべきことを論点という 43

Slide 44

Slide 44 text

今日の最重要ワード論点 44

Slide 45

Slide 45 text

論点とはその問いに答えるためには何を考えるべきなのか？どんなことを答えるべきなのか？ 45

Slide 46

Slide 46 text

目次とはその資料の論点である各資料内の目次構成例：要件定義書 1. システム導入の目的と目標 2. システムの概要／システムの構想 3. システム導入後の業務フロー 4. 機能要求 5. 入力要求と出力要求 6. 品質・性能要求 7. セキュリティ要求漏れ重複ない章立て（一般例） 46 要件定義書の論点つまり何を書けば要件が定義できたと言えるのか？

Slide 47

Slide 47 text

アインシュタインの言葉「もし自分が死にそうな状況で、助かる方法を考えるのに１時間あるとしたら、最初の55分は適切な質問を探すのに費やすだろう」 47 画像：https://honcierge.jp/articles/shelf_story/1521

Slide 48

Slide 48 text

何かを考え、表現するときのコツ何を伝えるべきなのか？（主題） ↓ それを伝えるためには何を示せればよいのか？（論点） ↓ その内容 48 主題論点1 論点2 論点X 内容1 内容2 内容X いきなり答を考えようとしない・・・・・・

Slide 49

Slide 49 text

構造化思考の演習 49

Slide 50

Slide 50 text

構造化思考の演習実際にやってみましょう 50

Slide 51

Slide 51 text

構造化演習（１）部門の飲み会の幹事を引き受けました。参加数を最大化させられる案内文を考えたいです。どんな項目が含まれているとよいですか？ 51

Slide 52

Slide 52 text

構造化演習（１） 52 現実はこうかもしれないが・・・

Slide 53

Slide 53 text

構造化演習（１）考え方（例） 53

Slide 54

Slide 54 text

構造化演習（２）プロジェクトの振返りの意見を集めたいと思います。依頼フォームを検討してください。 54

Slide 55

Slide 55 text

構造化演習（2）考え方（例） ■ 振返りで起こりがちな問題・誰のための振返り？・後半のことばかりに気になってしまい前半のことが抜け落ちる →PJ全体を見て重要なことがカバーできているか？・その場限り、いきあたりばったり。振り返ったあとに何か得るものがあるか？・評価に対する価値観の個人差はないか？（アピール型、遠慮型など） ■振返りの目的は？ルールや制度の変更？具体的改善活動の抽出？個人の成長？顧客との振返りであれば次の営業機会を探る場でもある 55

Slide 56

Slide 56 text

演習のポイントいきなり項目を挙げはじめるのはNG 目的を果たすために何を考えればよいかを考える（目的が指示されてなければ仮説を立てる） 56

Slide 57

Slide 57 text

構造化思考を効率的に進めるために 57

Slide 58

Slide 58 text

先輩達は考えた汎用的な事柄を考え表現するのに毎回論点から考えるのは非効率だし品質もばらつく 58

Slide 59

Slide 59 text

そこで生まれたのが主題と論点及びその表現方法などの組み合わせ一式をフレームワーク/テンプレートという 59

Slide 60

Slide 60 text

いろいろあるので調べてみようただ過剰に頼りすぎると思考が縛られることもあるので注意 60 フレームワークやテンプレートはあくまでも主題を得るための論点の１つの形でしかない。背景や文脈にのっとってテーラリング（応用）できる力が必要フレームワークやテンプレートは初心者には極めて効果的な手法

Slide 61

Slide 61 text

フレームワークの活用事例～振返り～ 61 » コミュニケーションの方向に着目したふりかえりの方法 - よこなのへたのよこずき https://ihcomega.hatenadiary.com/entry/2020/04/28/055258 • 「KPT （Keep/Probrem/Try）法」でやっていた • でも過去振り返りの時間が足りなくなることが頻発 • 議論しなくてもよいことは議論しなくてもいいのでは？ • チーム(または個人) で続けたいこと • 自分がドヤりたいこと • チームメンバーにお礼したいことフレームワークを使うことがゴールにならないように結果や得たい成果を常に忘れないようにしたい

Slide 62

Slide 62 text

生成AIの活用 62 1. 次期基幹システムの方針 2. ARIの対応可能範囲 3. ERP導入の考え方 4. 過去の支援事例 5. 現在の進捗 6. 基幹システムの対象領域 7. プロジェクト体制 8. 過去の検討内容 9. システム刷新の進め方求める論点について出力してくれる論点を出せる/評価できれば生成AIをより有効に使いこなせる悪くないけど最適かは状況次第（確率論）

Slide 63

Slide 63 text

構造化を踏まえたドキュメント作成アプローチ 63

Slide 64

Slide 64 text

効果的なドキュメントを書くには？ 1. そのドキュメントの読み手と主題を正しく把握する（誰のどんな問題を解決する資料なのか？） 2. その主題の論点を考える 3. 各論点について回答を深堀りし適切に分類して、文脈構成を設計する 4. 詳細を言語化/図式化する 5. 見た目を最適化する 64 ★ 構造化思考 ★ 作文表現技術

Slide 65

Slide 65 text

そのドキュメントの目的は明確か？なんとなくの積み上げ ≠目的達成 65

Slide 66

Slide 66 text

ドキュメント作業に入るその前にターゲットとなる読み手目的や得たい成果アプローチや論点上司/依頼者と確認できているか？ 66

Slide 67

Slide 67 text

仕事の進め方も同じタスク←ゴールゴールから考える 67

Slide 68

Slide 68 text

とりあえずまこなり社長の動画を見よう 68 https://www.youtube.com/watch?v=ArMNB_QTSXw

Slide 69

Slide 69 text

構造化志向以外のスキルを高めるには？ 69

Slide 70

Slide 70 text

効果的なドキュメント作成に必要なスキル知識（再掲）構造化思考力作文/表現技術記述対象に関する知識特にここがポイント！ 70 もちろんこれらも大切

Slide 71

Slide 71 text

今日の内容を改めて体系化して学びたい方 71 この本を激しく推薦します！

Slide 72

Slide 72 text

作文技術やPJ知識もめちゃくちゃ大切参考図書やリンク集こちら参考になれば 72 https://qiita.com/yasuoyasuo/items/1eb7298f91a44dce7abc

Slide 73

Slide 73 text

作文技術を学ぶ上で激しくおすすめの資料 73 https://speakerdeck.com/namura/shui-gadoujian-temosoutosikashou-kequ-renaiwen-shu-shu-gong-kai-ban

Slide 74

Slide 74 text

こちらも良ければ読んでみて 74 • 用語は文書内で一貫性をもたせる • 曖昧な代名詞の利用は避ける • 受動態は避け、能動態を優先する • 強い動詞を選択する1 • 曖昧な動詞よりも意味が限定される動詞を選ぶ • 1文1メッセージ • 長い文章はリスト形式に変換する • 不要な言葉は排除する • 順序が重要な場合は番号付きリストを使用し、順序が重要でない場合は箇条書きリストを使用する • リストを使う場合は言葉の並列性を保つ • 番号の付いたリストは命令語で始める • リストと表を適切に使う • 段落の骨子を示す良いリード文を作る • 1段落1トピックに絞る • 読み手に伝えるべきことを定義する • 読み手を意識して書く • ドキュメントの最初にそのドキュメントの重要なポイントを明確に示す https://qiita.com/yasuoyasuo/items/c43783316a4d141a140f

Slide 75

Slide 75 text

ドキュメントライフサイクルプロセスを学ぶには 75 エンジニアのためのドキュメントライティング / Docs for Developers and Paragraph Writing https://speakerdeck.com/nttcom/docs-for-developers-and-paragraph-writing

Slide 76

Slide 76 text

最後に 76

Slide 77

Slide 77 text

今日のまとめ ✓ ドキュメント作成に求められるスキル ➢ 漏れなく誤解なく言語化する ➢ 知識＋作文能力＋構造化思考 ✓ 構造化思考とは？ ➢ 「分かる」は「分ける」 ➢ 分解＋グルーピング（思考の補助線） ✓ 構造化思考の演習 ➢ いきなり手を付けず、何を考えるべきか（論点）を考える ✓ ドキュメント作成の進め方 ➢ 目的から逆算して段取りを考える 77

Slide 78

Slide 78 text

量が質に転嫁するドキュメントを書く機会を自ら作りドキュメント力を鍛錬しよう 78 どの現場もあったら助かる資料は必ずあるはずです SNSやブログでも積極的に情報発信していこう

Slide 79

Slide 79 text

ドキュメントを活かすにはプロジェクトのOSを整えたい https://speakerdeck.com/yasuoyasuo/dao-falsezhen-nzhong-wokireinisurupuroziekutomanezimento 自分の失敗を繰り返さないようにマネジメント哲学を言語化できた多くの方に目を通していただきたい道の真ん中中野で検索！

Slide 80

Slide 80 text

チームワークマネジメントを支えるドキュメント力 80

Slide 81

Slide 81 text

ご清聴ありがとうございました資料は後ほど Xで共有させていただきます懇親会でお声がけ感想、フィードバック Xでコメント/DM いただけたらありがたいです 81

Slide 82

Slide 82 text

エンジニアのためのドキュメント力基礎講座～構造化思考から始めよう～＜完＞ 2025年11月29日ＡＲアドバンストテクノロジ株式会社中野康雄（@yasuoyasuo） Backlog World 2025