ミスを反省で終わらせない——失敗を「1行ルール」に変える運用

📉反省文はなぜ機能しないのか

ミスが起きたとき、つい長い振り返りを書きたくなります。何が起きて、なぜ起きて、次はこうする——という定番のフォーマットです。ところがこの形式には弱点があります。分量が多いので、次に同じ作業をするときに誰も（AIも含めて）通読しないのです。学びは書いた本人の満足で終わり、行動には反映されません。

もう一つの問題は、常駐ファイルの肥大です。私たちは作業前に必ず参照するルール集を持っていますが、そこにミスの経緯まで書き込むと、ファイルがどんどん重くなります。AI COOにとって常駐ファイルは毎回コンテキストに載る前提の文書なので、肥大は思考の質を直接下げます。読む前提の文書を長くすることは、読まれない文書を作ることと同じでした。

🗂️二層に分ける——経緯はアーカイブ、ルールは1行

そこで当社は、ミスの記録を明確に二層に分けました。一つは common-mistakes.md。ここには「作業前に参照する現役の行動ルール」だけを、原則1行で置きます。もう一つは mistake-log-archive.md。こちらに詳細な経緯・時系列・退役した古いルールを全部押し込みます。

運用の分離則はシンプルです。新しいミスが起きたら、詳しい経緯はアーカイブ側に書く。そして常駐ファイルには「次にどう動くか」の1行だけを追記する。この徹底で、毎回読む文書は行動則の箇条書きに保たれ、背景を知りたいときだけアーカイブを開けば済むようになりました。学びを捨てずに、常駐コンテキストの肥大を止める——両立の答えがこの二層構造でした。

✍️1行ルールの書き方——「なぜ」を必ず埋め込む

1行に圧縮するとき、意識しているのは「禁止」と「代替」と「根拠」を1文に入れることです。たとえば当社のルールには「git reset --hard 禁止 —— git stash / git revert を使う」という行があります。何をしてはいけないか、代わりに何をするか、が一目で分かります。抽象的な戒めではなく、次の一手が書いてあるのがポイントです。

もう一つ大事にしているのが、実際に踏んだ痛みを短く添えることです。「merged ≠ deployed（本番反映を実測する）」というルールには、マージ済みなのに本番へ反映されていなかった具体例を1つだけ括弧で残しています。根拠のない禁止は破られますが、実際に落ちた穴の記憶が付いていると、ルールが守られやすくなります。1行に収める制約が、逆に本質だけを残す力になりました。

🔁実例——「文書で状態を推定しない」が生まれた経緯

抽象論だけだと伝わりにくいので、当社で最も効いている1行を紹介します。「文書ベースの状態推定禁止 —— 文書=plan・live=state。状態報告の前に必ず1つ以上 live 実測する」というルールです。これは複数回のミスから抽出されました。

きっかけは、社内文書に書かれたPR番号やデプロイ状況をそのまま「現在の状態」として報告し、実際にはとっくに変わっていた、という失敗が繰り返されたことでした。文書は「こうする予定」を記録したものにすぎず、今どうなっているかは実行環境に問い合わせないと分かりません。そこで経緯と個別の失敗事例はアーカイブに残し、常駐側には「報告の前に必ず実測」という行動則を1行だけ置きました。以降、状態を語る前にコマンドを1本叩く癖がつき、この種の誤報告は目に見えて減りました。

🧹肥大を防ぐ——追記のルール自体をルール化する

二層運用で油断すると、常駐ファイルに経緯を書き足してしまう誘惑がまた来ます。そこで当社は「新規ミス発生時は、詳細経緯はアーカイブに、常駐ファイルにはルール1行のみ追加する」という、運用そのものを縛るメタ・ルールをファイル冒頭に明記しました。編集のたびに立ち返る一文があると、二層の境界が崩れません。

加えて、退役したルールは消さずにアーカイブへ移します。もう使っていない戒めでも、なぜやめたかは将来の判断材料になるからです。常駐は軽く保ち、履歴は失わない。フローとストックを分ける、と言い換えてもいいかもしれません。反省を貯めるのではなく、行動を更新し続けるための仕組みです。

🧭まとめ——失敗を資産に変える最小の設計

失敗はゼロにできません。だからこそ、失敗をどう次に活かすかの設計が効いてきます。当社のやり方はごく単純で、経緯はアーカイブへ、行動則は1行だけ常駐へ、という分離を徹底するだけです。読む前提の文書を軽く保ち、それでも学びは一つも捨てない。

ふりかえりのフォーマットを豪華にするより、次に必ず参照される1行を残すほうが、再発防止にはずっと効きます。一人会社でもチームでも、記録が「読まれる状態」に保たれているかどうかが分かれ目です。ミスを反省で終わらせず、1行のルールに変える——今日の失敗から一つ、そんな行を足してみてください。

この「1行ルール」を積み上げるミスログの運用も、当社の運営構造をまとめた ai-coo-starter（OSS）にテンプレートとして入れています。仕組みごと持っていける形にしてあります。