なぜ「実運用ログを公開する」のか
第 1 章でちょっと触れた「実運用ログを公開する」というプロジェクトの姿勢について、もう少し詳しく書いておきます。 なぜ公開するのか、という話です。
ログって普通は隠すもの、と思ってた
最初に話しておくと、私も最初は「実装の中身は隠すもの」だと思っていました。 技術的な試行錯誤、失敗、判断ミス。 これらを公開するメリットを、正直あまり感じていなかったというのが本音です。
「ちゃんと動いてから公開すればいい」 「失敗してる途中を見せても、誰の役にも立たない」 そう思っていたんです。
特に、私のプロジェクトの 失敗ログ を公開するなんて、ちょっと考えられませんでした。 失敗 = 恥ずかしい、と無意識に思っていたんだと思います。 完成品だけ綺麗に並べて見せる、それが普通のブログとか技術ドキュメントの形だと思っていました。
公開してみたら、不思議と楽になった
転機は、ある時に「とりあえず公開してみるか」と決めたことでした。 特別な理由があったわけでもなく、誰かのアドバイスがあったわけでもなく、 「隠す方が逆に面倒な気がしてきた」という、消極的な動機からです。
実装ログを書いて、失敗の経緯も残して、外に出す。 やってみると、不思議なことが起きました。 書く時間は増えたのに、判断が早くなった んです。
理由は単純で、書きながら判断を整理することになるから。 「なぜこの選択をしたのか」を文章にしようとすると、頭の中の曖昧な部分が浮き彫りになります。 「実は根拠が弱い判断だった」と気づくこともあれば、 「これは前に同じ失敗してたな」と思い出すこともある。
公開する前提で書くと、なおさらです。 他人に説明する前提だと、ちゃんと筋を通して書こうとする。 それが結局、私の思考の整理になっていた、というわけです。
「他人の目」が入ることの効果
もう一つ気づいたのは、「公開している」という状態そのものに効果があるということでした。
これは別に、誰かにコメントをもらうとか、SNS でバズるとか、そういう話ではありません。 「他人が見るかもしれない」状態にしておくこと自体が、品質チェックとして効いてくる という話です。
たとえば、適当に判断したことをそのまま書こうとすると、書いてる途中で 「これ、人に読まれて大丈夫か？」と一瞬手が止まります。 止まると、もう一度考え直す。 考え直した結果、判断が改善することもあれば、説明を補足することもある。 要するに、公開を前提にしただけで、無意識のうちに丁寧になるんです。
これ、AI を使った開発でも同じことが起きていて、後の章で詳しく書く予定の 三権分立（さんけんぶんりつ） という仕組みも、似た発想で作っています。 「他人の目を構造的に入れる」というのは、人間相手でも AI 相手でも、効くんだなあと思ってます。
だから失敗ログも含めて残す
そんなわけで、このプロジェクトでは うまく行ったログだけじゃなくて、失敗ログも含めて公開する ことにしています。
理由は 3 つ。
- 判断整理のため：書いて公開すると思考が整う
- 「他人の目」効果のため：公開前提で書くと、無意識のうちに丁寧になる
- 似たことを試す人の参考になるため：失敗ログの方が再現性が高くて、対処法を知りたい場面の方が多い
特に 3 つ目について補足しておくと、技術記事って「成功したやり方」だけ書かれていることが多いんですよね。 でも、実際にやってみるとぶつかる失敗の方が、再現性も高いし、検索して辿り着きたい情報の方が多い気がしています。 だから、失敗 → 修正 → 学び の流れを、できるだけそのまま残しておこうと思っています。
きっとこの先、私もまた失敗します。 その時の判断ミスや、軌道修正の経緯も、淡々と記録として残していく予定です。 「実運用ログを公開する」というプロジェクトの姿勢は、そういう意図で作っています。