味覇で作るパスタが美味い - 20261001_yabaubuki.dev

株式会社リブセンス 技術広報チーム主催の勉強会『yabaibuki.dev』の第7回『やっぱり人間が頑張（や）らナイト！AI時代を生き抜くヤバイ人間力LT会』で発表した内容です。

エンジニアたちのAI時代におけるドキュメントへの向き合い方について、私見を述べています。

Transcript

1. 味覇で作るパスタが美味い。 2026.10.01 リブセンス 中野 悦史 Copyright © Livesense Inc.
2. 1. はじめに 登壇者について。 中野 悦史 (NAKANO Etsushi) - GitHub: etsxxx - リブセンスVPoE / マネージャー / インフラエンジニア - ハリネズミのアイコンは飼ってた⼦たち - 趣味は写真、飲酒 Copyright © Livesense Inc. 2
3. 1. はじめに AI駆動開発時代の⼈間の仕事とは？ • AI駆動開発の時代、⼈間の役割は「実装以外」に移っている Copyright © Livesense Inc.
4. 1. はじめに AI駆動開発時代の⼈間の仕事とは？ 従来の開発フロー 企画‧要件定義 設計 実装 テスト (運⽤) AI時代の開発フロー 企画‧要件定義 設計 実装 テスト (運⽤) Copyright © Livesense Inc.
5. 1. はじめに AI駆動開発時代の⼈間の仕事とは？ • AI駆動開発の時代、⼈間の役割は「実装以外」に移っている • 実装以外の領域の重要要素: ドキュメント ◦ ドキュメントでもAIは活⽤されている ←今⽇の本題 Copyright © Livesense Inc.
6. 1. はじめに 私の暴⾔の数々を懺悔。 ※ AI生成文書に対して辛辣な私。 Copyright © Livesense Inc.
7. 1. はじめに 私が常⽇頃考えていること。 ウェイパァー • • • AIは味覇である ◦ 味覇を使えば、素⼈でも⼿軽に70点の中華料理が作れる ◦ でも⾼級中華店で味覇の⾵味しかしない料理が出てきたら、 がっかりするだろう 我々はプロフェッショナルである ◦ 成果物の対価でお⾦をもらっている ◦ 素⼈と同じ⼿軽なものでは、がっかりされてしまう 「ウェイパー」じゃなくて「ウェイパァー」らしいよ ※ 私は味覇の愛用者です。味覇は廣記商行さんの商品です。
8. SECTION 2. AIとドキュメントとレビュー Copyright © Livesense Inc.
9. 2. AIとドキュメントとレビュー ドキュメントを書くことに苦⼿意識がある⼈、多いのでは？
10. 2. AIとドキュメントとレビュー 最初にスタンスを明記しておきたい。 • ドキュメントを書く姿勢はとても好ましい ◦ AI⽣成であっても、ドキュメントを書こう(作ろう)とする⾏為は最⾼ ◦ 『やっぱり⼈間が頑張（や）らナイト！』というイベントだけど、 「AIを使わず⼈間が書こう！」なんて⾔う気はない • • だが、ドキュメントを書き終えることがゴールであってはならない ドキュメントの⽬的に意識を向けよう Copyright © Livesense Inc.
11. 2. AIとドキュメントとレビュー ドキュメントの⽬的？ • • • ドキュメントは、数年先に活⽤されることを想定して書くべき ◦ ⼈間は、驚くほど過去のことを忘れる 2026年10⽉現在、ドキュメントは未だ、⼈間が読むものである ◦ いつかRAWドキュメントはAIしか読まない時代が来るかもしれない ◦ しかし、AIも⼈間も読めるドキュメントであっても何も損はない 他⼈に読んでもらえるドキュメントを書こう Copyright © Livesense Inc.
12. 2. AIとドキュメントとレビュー なぜドキュメントを書き、なぜレビューをするのか？ • • 内容を推敲し、議論するという、品質向上を通じて成⻑するため ◦ 良いドキュメントと良いレビューは、チームを成⻑させる AIの無難な出⼒に依存すると、その機会を失いかねない ◦ その瞬間で⾒れば、AIで70点の成果物を得られているかもしれない ◦ ◦ そのドキュメントは、⼈間が読まずともAIが読んでくれるかもしれない だが、AI任せではその良し悪しを判断する⼒も失われてしまう ▪ 技術負債‧理解負債‧認知負債を未来に残す⾏為になりかねない Copyright © Livesense Inc.
13. SECTION 3. AI時代のドキュメントへの向き合い⽅ Copyright © Livesense Inc. 13
14. 3. AI時代のドキュメントへの向き合い方 我々はどうすべきか？ • • AIを使うことは全く問題ない 成果物に責任を持とう ◦ AI⽣成物を「⾃分の⽂章」と⾔えるように⾃分⾃⾝で推敲しよう ◦ ⾃分で推敲してないものを⼈に⾒せるのは失礼な⾏為 ◦ • Meat Proxyになってはいけない 成果物と⾃分の理想を⽐較しよう ◦ AIが⽣成したものと、⾃分の理想との、ギャップを把握しよう ◦ 理想に⾜りなければ直す → 成果物の品質が向上する ◦ 理想を超えていたら学ぶ → あなたのスキルが向上する Copyright © Livesense Inc.
15. 3. AI時代のドキュメントへの向き合い方 盛れば盛るほど良いってもんじゃない。 現在のAIは、過剰な出⼒をしがち。 「最⾼じゃん、これだけ書いてあれ ば不⾜なんてないね」 なんて思っていると、右図のような 物を中野に⾒せて「⼈間の読むもの じゃない」と⼀蹴される。 画像: project-cartoon Copyright © Livesense Inc.
16. 3. AI時代のドキュメントへの向き合い方 そもそも⾃分の理想がないと、成果物は破綻する。 ⾃分なりの理想像を持たずにAIの出 ⼒に依存すると、成果物の中から 『正解』を選べない。 あなたが作りたいものはどれ？ ドキュメントの要件定義をしよう。 画像: project-cartoon Copyright © Livesense Inc.
17. 3. AI時代のドキュメントへの向き合い方 ドキュメント作成も、開発と⼀緒。 気をつけるべきはこんなところだけ。 • AIでドキュメントを書き始める前に： ◦ 対象読者を明記しよう ◦ 読者に達成してもらいたいことを明記しよう • 要件定義 AIの出⼒そのままで完成にするのではなく： ◦ ⽂章を黙読して、すんなり頭に⼊るか確認しよう ◦ ノイズを減らして、書き換えて、⼤事なことを⽬⽴たせよう レビュー Copyright © Livesense Inc.
18. 4. 終わりに あなたは味覇で何を作りたいのか？ • 「味覇を使ったら簡単に中華料理を作れた」はスタート地点 ◦ 味覇のおかげで簡単に70点には達することができる ◦ だからこそ、残りの30点にこだわろう ◦ その30点にこそ、あなたのプロフェッショナルの精神が宿る • あなたが本当に作りたいものを、まず最初に考えよう ◦ 味覇はあまたの調味料の1つ。味覇を使うからといって、中華料理を作ら ないといけないわけじゃない ◦ あなたが作りたいものが明確なら、味覇が引き⽴て役になるはず Copyright © Livesense Inc.