Kindle出版で「暗黙知」をどう伝えるか？納得感ある論理構成は「基本設計」から
こんにちは、Hibikiです。
本記事は、「ITエンジニア×Kindle出版の体系化」シリーズです。
その名も「Chi. （チ。）」プロジェクト。
なぜ「Chi.」なんて名前を付けているのかは、第1回の記事をご覧ください。
「テーマは決まった、早速原稿の執筆に入ろう」
そう考えているなら、ちょっと待ってください。
いきなり執筆に入るのは、システム開発を詳細設計から開始することに等しいです。
詳細設計から入るような進め方では、必要な要件の設計が漏れていても気付くことができません。
私たちが目指すのは、私たちが「体験したこと、考えたこと、感じたこと」という実践知を伝えていくことです。
実践知を受け取る側に立ってみた場合、いくら私たちが伝えようとしていることが素晴らしくても、穴だらけの説明ではスッと頭に入ってこないでしょう。
要件定義、基本設計がしっかりした上に詳細設計を積み重ねることで、はじめて堅牢なシステムが構築できることを私たちは知っています。
実践知を伝える取り組みでも、やることは同じです。
初回の記事で、「ITエンジニア×Kindle出版」の体系は大きく分けて、以下の4つがあると説明しました。
1️⃣技術トレンドからテーマを決める
2️⃣テーマ内で比較検討する
3️⃣比較結果を基に深堀りする
4️⃣比較・深堀りを発信する
この4ステップをシステム開発に当てはめると、次のようになります。
1️⃣技術トレンドからテーマを決める ➔ 要件定義
2️⃣テーマ内で比較検討する ➔ 基本設計
3️⃣比較結果を基に深堀りする ➔ 詳細設計
4️⃣比較・深堀りを発信する ➔ 実装
はやる気持ちを抑えて、きちんと基本設計したものを伝えていきましょう。
今回は、基本設計にあたる「2️⃣テーマ内で比較検討する」についてです。
なぜ「比較検討」がそれほど重要なのか？
それは、このプロセスこそが、私たちが持つ「体験したこと、考えたこと、感じたこと」という暗黙知（＝実践知）を基に、読み手に伝達可能な形式知の輪郭を描くプロセスだからです。
この「基本設計書」（＝比較検討の結果）は、
暗黙知では曖昧だった部分が明確になり
【解像度を上げる】AIには書けない、体験に基づく「専門性の証明」となる
【認知・信頼を獲得する】
のです。
この2点を達成することで、比較検討が、読み手にその技術を学ぶ理由を説き、「納得感を引き出すツール」となるのです。
以降のセクションでさらに深堀りして考えてみましょう。
📚️解像度を上げる
第1ステップである「1️⃣技術トレンドからテーマを決める」にて、すでに実践知を持つテーマを選定したことでしょう。
では、なぜさらに解像度を上げる必要があるのか？
それは次の3つのメリットを享受するためです。
1️⃣比較することで特徴が浮き彫りになる
2️⃣実践知を伝えるための論理構成が見える
3️⃣弱いポイントの対策が実践知の核となる
１つずつ説明していきます。
1️⃣比較することで特徴が浮き彫りになる
例えば、あなたがあるプログラミングフレームワークの説明をテーマに選んだとしましょう。
すでにそのフレームワークを使ったプログラミングの経験があり、深い知識をお持ちでしょう。
しかし、そのフレームワークの知識だけで、長所、短所を説明することが可能でしょうか？
良い、悪いとは、相対的な観点です。絶対的な指標はありません。
つまり、他の類似のフレームワークと比較してはじめて、対象のフレームワークの長所、短所を明確に説明できるようになるということです。
具体例を見てみましょう。
PythonのWebフレームワークにDjango（ジャンゴ）とFlask（フラスク）というものがあり、よく比較されます。
生成AIに比較表を作ってもらいました。
Djangoはフルスタック、Flaskはマイクロという程度のことは、実践知を持っている方であればすでにご存知のことでしょう。
しかし、DjangoではORM、管理画面、認証機能まで同梱されているが、Flaskでは別となっているという具体的な違いについては知識がないかもしれません。
これらの違いこそフレームワークを特徴づけている点であると知ることで、伝える中身も具体的になり説得力のあるものに変わってくることでしょう。
2️⃣実践知を伝えるための論理構成が見える
特徴があるということは、そこに伝えるべきネタがあるということです。
上記の比較表によると、それぞれのフレームワークでORMに特徴があることが分かります。
しかし、読者が知りたいことは単に何が違うかだけでなく、
どのような思想に基づいて違いが生まれているか
ではないでしょうか。
Djangoであれば「バッテリー同梱」、Flaskであれば「シンプル＆ミニマル」。これらの思想に基づき、ORMにも違いが出ていることが分かれば、理解もスムーズでしょう。
比較検討することで、私たちの暗黙知に輪郭を与え、伝えるべき論理構成が明確になります。
この論理構成こそが、書籍の骨格となり、読み手に伝えるべき骨子となるのです。
3️⃣弱いポイントの対策が実践知の核となる
特徴が分かるということは、強弱のポイントが分かるということです。
「弱いポイント」をどう乗り越えたか、それこそがAIには書けない「実践知」の核心です。
たとえば、AIは「Djangoの学習コストは高い」という事実を提示できます。
しかし、「その高い学習コストを実案件の中でどうやって克服したか」「Flaskには無い管理画面を、どのライブラリで、どう工夫して補完したか」という体験に基づくストーリーは、私たちにしか伝えることが出来ません。
この弱点への対策こそが、「Chi.」プロジェクトで伝えるべき実践知の核なのです。
その弱点を明確にするためにも、比較検討というプロセスは外すことが出来ません。
📚️認知・信頼を獲得する
最終理想形は、バイネームで私たちを検索してもらい、著書を購入していただくことです。
しかし、私を含めてほとんどの人はバイネームで検索してもらえるほど知名度がありません。
では、知名度がない中でどうやって私たちの著書を見つけてもらうのか。
これは第4ステップである「4️⃣比較・深堀りを発信する」と密接に関わることですが、第2ステップ「2️⃣テーマ内で比較検討する」での結果をSNSで共有することで、読者との最初のキッカケを作ります。
「比較検討」の結果を使う理由は次の2点です。
1️⃣人は損を嫌うという性質を利用して認知を得る
2️⃣嫌味なく専門性を示す
１つずつ説明していきます。
1️⃣人は損を嫌うという性質を利用して認知を得る
私たちはある程度の値が張る買い物をする時、「比較」します。
Amazonや楽天にて星の数で比較したり、星の数が同じならレビュー数で比較したり、レビュー内容で比較したり、と。
これは人間が損を嫌う生き物であるということから来ています。
有名な話なので聞いたことがあると思いますが、プロスペクト理論と言って
「不確実性がある状況下での意思決定において、人は「利得」よりも「損失」を避けようとする心理」
が働くというものです。
自分に関係するものの比較があると、自分が損をしていないか確認したくなる、ということです。
例えば、AとBというフレームワークがあり、あなたが個人開発でAフレームワークを使ってシステム構築しようと考えていたとしましょう。
AとBの比較記事があったら、見てしまいませんか？
本当にAが正しい選択なのかを確認したくなるのではないでしょうか。
たとえ私たちのように知名度が無い著者であっても、比較記事を公開することで認知してもらうことができるはずです。
いや、知名度が無い私たちだからこそ、積極的に比較記事を使って認知してもらう戦略が必要でしょう。
2️⃣嫌味なく専門性を示す
私たちが専門性を示そうとすると、どうしても自慢話のようになっていまいます。
「生産性が○○％改善するシステムを開発した」
「顧客への応答スピードが○○％向上した」
事実であったとしても、そのような自慢話をあえて読もうという人は稀有です。
しかし、私たちの専門性を知ってもらわなくては、私たちを信じて著作を手に取ってもらえません。
ここでも、専門性を示す簡単な方法が「比較検討の結果を示す」ことです。
専門家の観点から、公平な比較がされていれば、自然な形で私たちの専門性を理解してもらえるでしょう。
ただし、ここでも大事なのは「生成AIが作った比較結果」だけを示すのでは足りないということです。
それこそ、わざわざ私たちの比較記事を読まなくても、生成AIに聞けば良いでしょう。
生成AIが作り出す比較結果を使っても良いと思いますが、そこにオリジナルの観点を追加することは必須だと考えています。
そのオリジナルの観点こそが、私たちの実践知を示すことになるためです。
当然のことですが、比較結果に恣意性があってはいけません。
著作に関係する方を有利に書きたくなる気持ちはありますが、「公平な結果」であるからこそ価値があり、私たちの専門性を信じてもらうことができるのです。
📚️まとめ
今回は、「解像度を上げる」という観点で次の3点について説明しました。
1️⃣比較することで特徴が浮き彫りになる
2️⃣実践知を伝えるための論理構成が見える
3️⃣弱いポイントの対策が実践知の核となる
また、「認知・信頼を獲得する」という観点で次の2点について説明しました。
1️⃣人は損を嫌うという性質を利用して認知を得る
2️⃣嫌味なく専門性を示す
第1ステップ「1️⃣技術トレンドからテーマを決める」でどれだけ良いテーマを見つけたとしても、通常、その段階で考えているレベルはまだ荒いものです。
「比較検討」を通して一段深く中身を検討すること。
それこそが、私たちの「暗黙知」を、
AIには書けない「実践知の核」として縁取り、
市場からの「信頼」を獲得する武器へと変える
ためのプロセスです。
そして、この2つを達成して初めて、 私たちの「知」は、読み手の「なぜ」に答え、納得感を引き出すツールへと姿を変えるのです。
一見遠回りに感じるプロセスですが、スキップせずに一つ一つ着実に積み重ねていきましょう。
本記事は比較検討を行うメリットを中心に説明しました。あまり方法論に触れていませんので、今後、さらに具体的に解説していきます。
「Chi.」プロジェクトを応援していただける方、一緒に挑戦していきたい方はぜひフォロー、スキ、コメントをお願いします。
皆さんのリアクションが、この挑戦を続ける大きな力になります。
「ITエンジニア×Kindle出版」のシリーズをマガジンにまとめていきます。
マガジンもフォローいただけると、漏れなく更新を確認できます！