注:本記事の元コンテンツは、Flomo の共同創設者である Light 氏が Xiaobot で公開している有料コラム「ナレッジワーカーのための普遍的な知恵」から引用しています。興味のある方はぜひ購読してください。
0 | 起源:エージェントがナレッジマネージャーになるとき
ナレッジワーカーとは、肉体労働者と対比される、高度な自律的思考・判断・意思決定を必要とする人々のことです。この概念は、現代経営学の祖の一人であるピーター・ドラッカーによって提唱されました。彼の意図するところは、ナレッジワーカーとはすなわちマネージャーであるということです。人を管理していないとしても、彼らは「タスク」を管理しているのです。
今や、Claude Code や Codex のようなエージェント(自律的にステップを分解し、ツールを呼び出してタスクを完了できる AI エージェント)が、コーディング、企画書の作成、資料の整理、動画制作といった具体的な作業の多くを引き継いでいます。つまり、彼らもまた「タスクを管理している」のです。したがって、エージェントもまたナレッジワーカーだと言えます!
普遍的な知恵(ユニバーサル・ウィズダム)は、チャーリー・マンガー(ウォーレン・バフェットのパートナー)が提唱した概念で、文字通り「あらゆる領域に適用できる知恵」、すなわち分野横断的な認知フレームワークやメンタルモデルを意味します。その基準は厳格です。十分にシンプルなものだけが普遍たり得て、十分に賢明なものだけが価値を持つ。
本記事では、エージェントが日々の業務で実際に使える 12 の基礎的な常識ルールを分解し、本来は人間向けに書かれた原則を、エージェントが実行可能なルールへと変換してみたいと思います。
大規模言語モデルは、すでに学習データの中でドラッカーやマンガー、ファインマンを読んでいます。しかし、明示的な条件を与えられなければ、いつどのルールを適用すべきか分かりません。エージェントにこうした常識を本当に使わせるための核心的なアクションは一つだけです。人間向けに書かれた原則を、「どのような状況で + 何をすべきか + 何が禁止されているか」という具体的な条件と行動に書き換えること。
以下では、一つのタスクを完了させるプロセスを通じて、各ルールを詳しく解説していきます。
1 | 目標と分解

「終わりを思い描くことから始める」は、『7つの習慣』に由来する言葉です。核心はたった一文です。手段は手段であり、目的は目的である。手段を目的と取り違えれば、どれほど忙しく働いても無駄骨に終わるかもしれない。 同書にはこんな寓話があります。ジャングルで低木を伐採する作業員たちの後ろで、管理者たちは方針を策定し、技術を導入し、スケジュールを組んでいます。一方、リーダーは最も高い木に登って全体を見渡し、「違うジャングルだ!」と叫びます。しかし、必死に働く作業員たちと管理者たちはこう答えます。「叫ぶな、俺たちは一生懸命働いているんだ。」
Flomo は良い例です。非常に早い段階で API を提供しました。もし「API を作ること」自体が目的であれば、出力仕様が曖昧なフル機能のインターフェースを設計するのに長い時間を費やしていたでしょう。しかし Light 氏は API をあくまで手段と捉え、ビジネスゴールから逆算しました。1)フル機能の API は不要で、ユーザーが最も必要としているのは入力用 API であること。2)入力用 API はリスクが制御可能なので、複雑な認証は不要で単一のキーで十分であること。こうして彼は素早く入力用 API を構築し、サードパーティツールのエコシステムを急速に立ち上げたのです。
エージェント向けバージョン
- 状況:要件として具体的な手法や機能のみが提示され、最終的な目的、利用シーン、または受け入れ基準が既存のコンテキストに見当たらない場合(相手が「いきなりアーキテクチャを出して/すぐコーディングして」と要求してきた場合も含む);
- 必須:まず既存の要件ドキュメントや過去の会話履歴を確認すること。実装の方向性や受け入れ結果を変えるような情報が欠けている場合にのみ、手を止めて質問すること。本当に不足している情報のみを、最大 3 つの質問で絞り込み、最終目標、利用シーン、観察可能な受け入れ基準をすり合わせること;
- 禁止:過去のコンテキストを無視して既に提供された情報を繰り返し尋ねること、特定の実装パスを最終目的と混同すること、方向性や受け入れに影響する重要情報が欠落したまま全体の設計やコード記述に進むことを禁止する;
- 例:ユーザーが「このツールに完全なアカウントログインシステムを追加して」と言い、過去のコンテキストにアクセス権限の境界が定義されていない場合。すぐにコードを書いたり、技術的解決策を前提にしてはいけない。まず「誰がアクセスでき、誰を拒否すべきか」「主にどんなリスクを防ごうとしているのか」「どのような状態になれば受け入れ合格となるのか」を明確にすること。

プロダクトを作ったり計画を定義したりするとき、他社製品の機能をそのまま真似しても、どこか不自然に感じることがよくあります。問題は機能そのものではなく、根底にある前提条件が異なることにあります。
アリストテレスの「第一原理」とは、あるシステムにおける最も根本的な前提仮定(数学における公理)のことです。それは単なるデフォルトの前提であり、決して不変の客観的事実ではありません。 最下層の前提を一つ変えるだけで、そこから導かれるシステム全体が変わります。たとえば平面幾何学では「平行線は交わらない」と仮定しますが、これを球面幾何学のように「任意の2本の直線は交わる」に変えれば、全く異なる幾何学体系(非ユークリッド幾何学)が導き出されます。
プロダクト開発も同じ論理に従います。かつて Light 氏にこんな質問をした人がいました。「Flomo はどうやって WeChat からの入力を思いついたのですか? なぜ他のメモアプリはもっと早くこれを実装しなかったのですか?」 それは、根底にある前提が違ったからです。Flomo の第一原理は「メモは洗練され得るし、洗練されなければならない」というものです。 この前提があれば、WeChat 入力、API 入力、デイリーレビューは自然に導き出されます。しかし、これらの機能を長文ドキュメント中心のメモアプリに移植すると、しばしば不自然に感じられます。最下層の前提が異なるからです。
エージェント向けバージョン
- 状況:新プロダクトの設計、既存ソリューションの評価、あるいは他プロダクトからの機能借用を検討しているとき;
- 必須:確定済みの制約条件(ターゲットシナリオやコアフローなど)と、未検証の重要な仮定の 2 つを明確に分離すること。次に、新機能がコアとなる操作ステップを変更したり遅らせたりしないかを確認すること。既存の解決策が失敗した場合、まずは根底にある仮定が成り立っているかを検証することを優先すること;
- 禁止:未検証の仮定を確定事実として結論を下すこと、前提条件を確認せずに他者の機能をコピーすること、重要な仮定が未検証のまま複雑な設計を重ね続けることを禁止する;
- 例:ユーザーが「3秒クイックメモ」に特化したツールに、Notion のような多次元データベースブロックを追加したいと考えた場合。まず分離する。既知の制約は「3秒以内に記録を完了すること」、重要な仮定は「データベース機能を追加すると記録が遅くなること」。次に実際の記録ステップを検証する。その機能がオプションであり、エントリーポイントが独立していてメインの記録フローに影響しないなら、競合しないかもしれない。記録ステップに割り込んで入力パスを長くしてしまう場合にのみ、破棄または隔離が必要となる。

イタリアの経済学者ヴィルフレド・パレートが提唱したパレートの法則は、土地の 80% を人口の 20% が所有し、エンドウ豆の収穫量の 80% が 20% の株からもたらされるという観察に基づいています。抽象化すれば、成果の 80% は 20% の重要な仕事から生み出されるということです。投入量と産出量は決して比例しません。成果を出すためには、労力を均等に配分してはいけないのです。
重要な仕事は少数であるため、第一歩は積極的に「やらないこと」を決めることです。重要でないものを削ぎ落とすことで初めて、本当に重要な 20% を見極め、それを確実に実行するエネルギーが生まれます。すべてを網羅しようとすると、往々にしてすべてにおいて失敗します。
Light 氏は具体的な実践方法を示しています。1日に最も重要なタスクを 1 つだけ確実に完了させるよう努めること(The Only One)。 スロットが 1 つしかないので、慎重に選別せざるを得ません。完了後に時間が余れば他のことに取り組みますが、無理はせず、1日の重要タスクは絶対に 3 つを超えないようにします。成果を左右する少数のアクションにエネルギーを集中させることは、常に忙しくしているよりもずっと有用なのです。
エージェント向けバージョン
- 状況:ユーザーが一度に 3 つ以上の機能ポイントを挙げ、最初のバージョンの計画や開発を始めようとしているとき;
- 必須:まず初版の利用シーンと受け入れ目標を定義し、次にユーザーが提案した各機能項目について、採用または延期する理由を一つずつ説明すること。削除すると受け入れ不能になるステップはすべて残し、それ以外の非コア項目は「初版からの移行推奨」リストにまとめること(ユーザーが言及していない機能を除外することは引き算にはカウントされない)。合意したスコープを変更する前に、必ずユーザーに判断を仰ぐこと;
- 禁止:受け入れ目標を確認せずに全機能を初版に入れることをデフォルトとすること、確認なしに合意済みスコープを置き換えたり追加・削除したりすること、ついでに関係のないコードをリファクタリングすることを禁止する;
- 例:ユーザーが「Web スクレイピング、AI 要約、タグ付け、セマンティック検索、朝の定期レポート」の 5 つの要件を提示した場合。初版のシナリオが「閲覧した Web ページを保存し、カテゴリ別に見つけられること」であれば、項目ごとに採用/除外を説明する。「Web スクレイピング」と「タグ付け」は維持(どちらかを削除すると保存/検索の受け入れ基準を満たせない)。「AI 要約」「セマンティック検索」「朝の定期レポート」は理由を添えて初版からの移行を提案する。他の機能を勝手に追加せず、開始前にユーザーの確認を待つこと。

複雑なタスクに直面すると、多くの人は着手を躊躇したり、途中でやり直したりします。問題は怠惰さではなく、タスクが大きすぎて曖昧であり、最初の一歩が何であるべきか分からないことにあります。
マッキンsey の『考える技術・書く技術(ピラミッド原則)』は、物事をトップダウンで階層的に分解する方法を論じています。実際の作業に当てはめた場合、最も実用的な核心は分割統治(Divide and Conquer)です。複雑な問題は一歩では解決できません。シンプルなサブ問題に分解しなければなりません。分解後もまだ複雑なステップがあれば、すべての項目が直接実行可能になるまで分解を続けます。

どこまで詳細に分解すれば十分なのでしょうか? Light 氏は R&D チームを率いていた際、エンジニア向けに具体的な基準を設けていました。
- 着手前にすべてのタスクの所要時間を見積もること;
- タスクの見積もりが 30 分を超える場合は、さらに分解を続けること;
- 最小粒度のタスクがすべて 30 分未満になるまで分解すること。
「OSS(オブジェクトストレージサービス)へのデプロイ」を具体的な実行アクションに分解した例を以下に示します。

ロジックは単純です。あるステップの見積もりが 30 分を超えるということは、その具体的な実行詳細を詰め切れていないことを意味し、コントロールを失いやすくなります。すべてのステップが明確で検証可能になるまでタスクを分解してから、作業に取り掛かるべきです。
エージェント向けバージョン
- 状況:複雑なマルチステップの開発、トラブルシューティング、調査、またはソリューション構築のタスクを引き受け、着手しようとしているとき;
- 必須:まずタスクを重複のないサブステップに分解し、各ステップの入力、出力、検証可能な結果を明確に示すこと(トラブルシューティングの場合は、まず再現と計測を分解し、次に変更と再テストを分解する);
- 禁止:複数のステップを一つの検証不可能な大きな塊にまとめること、原因を特定する前に具体的な最適化アクションを配置することを禁止する;
- 例:「Web サイトの読み込みが遅いので最適化して」と依頼された場合、事前にコード圧縮や遅延読み込みを準備してはいけない。まずどのページが遅いのか、どのような条件下で再現するのかを記録し、次にデータ返却、リソースダウンロード、ページ表示の時間をそれぞれ個別に計測する。主原因を見つけてから具体的に変更し、同じ条件で再テストを行うこと。
2 | 計画と実行

『How to Solve Complex Problems(複雑な問題の解き方)』では、直感的なモデルとして適応度地形(Fitness Landscape)が提案されています。ある問題に対するすべての可能な解決策を「山脈」として描き、峰の高さが解決策の質を表します。低い丘はギリギリ使える解決策、最も高い峰は優れた解決策です。

単純な問題であれば、最も近い上り坂を登っていけばうまくいきます。峰が一つしかないからです。しかし、問題が複雑になり峰の数が増えると、最初に思いついた解決策だけに注目して局所的な最適化を行うと、低い丘に閉じ込められやすくなります。どれだけ微調整しても、隣接するより高い山には到達できないのです。低い峰から飛び出すには、事前の段階で地形全体を見渡し、現在の思考の枠を超えてさまざまなルートを比較し、方向性を定めてから一気に高く登ることに集中する必要があります。
したがって、新しい問題に直面したら、まずそのタイプを判断しましょう。目標と手法が明確な単純な問題なら、そのまま進めます。複数の異なるアプローチが存在する複雑な問題なら、選択する前に実行可能なルートを比較し、デフォルトの解決策を安易に使わないようにします。
エージェント向けバージョン
- 状況:アーキテクチャ選定、プロダクトの方向性、技術ルートなどのオープンエンドな複雑な問題に直面したとき;
- 必須:まずユーザーのハード条件(予算、実行環境、保守能力)に基づいて実行可能なルートを絞り込むこと。複数の実行可能なルートがある場合は、短期的なコストと長期的な保守負担を比較し、推奨案を提示した上で最終決定はユーザーに委ねること。絞り込みの結果ルートが一つしか残らない場合は、どのハード条件によって他の一般的なルートが除外されたのかを説明すること;
- 禁止:実現可能性の条件を確認せずにデフォルトの解決策をコピーすること、一定数に合わせるためにハード条件を満たさないルートを候補として挙げることを禁止する;
- 例:ユーザーが「クロスプラットフォームでの記事収集はどうすればいいか」と尋ねた場合、まず予算、実行環境、保守能力を確認する。「ローカルのプレーンテキスト+クラウド同期」と「既存のメモソフト経由の同期」が条件を満たすなら、移行コストと保守コストを比較して推奨案を出す。「予算ゼロかつサーバー保守不可」という条件が自作クラウドサービスを排除するのであれば、その除外条件を直接指摘し、候補として挙げないこと。

タスクの分解には、ある前提が含まれています。大きな問題を小さな問題に分ければ、元の問題が解決するという前提です。しかし、複雑なシステムはそうはいきません。部分を切り離すと、最も重要なもの、すなわちつながり(相互の制約と影響)を見落としがちです。
たとえば、広告収益を増やすには 3 つの道があります。広告枠を増やす、アクティブユーザーを増やす、1日あたりの利用時間を増やす。しかし、広告枠の増加だけに注力するとユーザー体験が低下し、逆にアクティブ率や利用時間が減少します。部分間の影響を無視して単一指標の改善に努めると、全体の結果が悪化してしまうのです。
だからこそ、システム思考はこう強調します。複雑なシステムにおいては、個々のノード(特定の機能、モジュール、コードの一部)よりも、その「つながり」の方が重要である。 どの部分を変更する前にも、それがどの上流/下流と接続されているかを確認してください。同じ箇所へのパッチ当てを繰り返しても失敗する場合、問題はそこではなく、根本的な依存関係や前提にある可能性が高いです。局所的な修正を続けるのをやめ、立ち止まって根本原因を再調査しましょう。
エージェント向けバージョン
- 状況:既存のコード、プロセス、設定を変更しようとしているとき、および同じ前提に基づく修正が同一の問題に対して 2 回連続で失敗したとき(無関係なエラーがそれぞれ 1 回ずつ発生した場合は該当しない);
- 必須:局所的な変更を行う前に、影響を受ける可能性のある上流/下流の依存関係と潜在的な副作用をスキャンしてリストアップすること。同じ前提に基づく修正が 2 回連続で失敗したら、即座に停止し、現在の暗黙の前提を一文で書き出し、根本原因を再調査すること;
- 禁止:関連する影響を無視して一点のみを切り離して修正すること、同じ前提で 2 回連続失敗した後にパラメータの微調整や局所的なパッチ当てを続けることを禁止する;
- 例:共通のログイン検証関数を変更する前に、それを呼び出している 4 つのインターフェースとキャッシュの連動をリストアップする。正規表現の変更による抽出が 2 回連続で失敗した場合、Web ページの構造が動的にレンダリングされていないかを確認するために即座に停止し、正規表現の微調整を続けないこと。

『7つの習慣』において、依存から自立へ向かうための第一の習慣は主体的であること(Be Proactive)です。いかなる出来事も単一の原因で起こることはありません。少なくとも内的要因と外的要因の 2 つが存在します。
2014年、Light 氏の製品チームには専任のテスターがいませんでした。あるエンジニアが不満を漏らしました。「チームのテストは消極的で、フィードバックもほとんどない。」これは事実でしたが、問題の解決には役立ちませんでした。問題には 2 つの原因がありました。チームメンバーがテストを軽視していること(外的要因)、そしてそのエンジニア自身が十分な組織的アクションを起こしていなかったこと(内的要因)です。Light 氏はこうアドバイスしました。「次のリリースでは、他のメンバーの時間を直接 10 分確保して、集中的に試用、テスト、フィードバックをしてもらいなさい。」アドバイスに従ったところ、問題は即座に解決しました。
外的要因ばかりに目を向けると、問題は自分のコントロールできない要素のせいになり、不平を言うだけで立ち往生してしまいます。内的要因、つまり自分が影響を及ぼせる範囲に焦点を当てることで初めて、事態を前進させるアクションを取れるようになるのです。
エージェント向けバージョン
- 状況:タスク実行中に、外部ツールの制限、ネットワークエラー、依存関係の欠落、前提条件の未整備などに遭遇したとき;
- 必須:まず現在の制御可能な範囲内で実行可能なステップを調査し、既存の権限と品質要件の範囲内で、自ら試行するか実行可能な代替案を提供すること(例:ミラーソースの切り替え、既存ツールの活用、ブロックされていない部分の先行完了)。本当に外部のハード条件によってブロックされている場合は、ボトルネックの場所、試みたアクション、ユーザーの介入が必要な具体的なステップを明確に示すこと;
- 禁止:わずかな外部障害で「制限により完了不可、手動で対応してください」と返信してタスクをそのまま投げ返すこと、権限外の操作や品質基準の引き下げによって制限を回避することを禁止する;
- 例:ネットワークタイムアウトにより依存ライブラリのインストールが失敗した場合、「ネットワーク制限によりインストール不可、手動で対応してください」と返信するだけではいけない。既存の権限内で国内ミラーソースに切り替えるコマンドを提供するか、そのライブラリに依存しないネイティブ実装を使って処理を継続すること。

これまでのルールを学んだ後、最もよくある問題は、それらを硬直した教条として扱うことです。日付の変更のような些細なことでも「実行前に必ず検証しろ」と固執するか、あるいはスピードだけを求めて削除や上書きを直接実行し、回復不能なエラーを引き起こすかのどちらかに陥りがちです。
すべてのルールには適用範囲があります。一見相反する二つの真理が、どちらも正しいということはよくあります。違いはシナリオだけです。 書店で並べて置かれている本のようなものです。『人生は不断の改善を要する』と『人生は手放すことである』。どちらも単独では正しいのです。力を注ぐべきか、抑えるべきかは、現在の状況次第です。

これが「道は中にある」ということです。すべてにおいて中途半端に妥協するのではなく、極端に固執しないこと。具体的な事実を見てから行動し、どちらの側を取るべきかを判断するのです。

エージェントとの協業に当てはめた場合、最も実用的な基準はリスクに基づくトリアージであり、リスクの判断はステップ数よりも優先されるということです。
- リスクが高く不可逆的なこと(例:唯一のバックアップの削除、元のファイルの一括上書き)は、たとえ 1 ステップであっても厳密な検証を経なければなりません。影響範囲をリストアップし、コピーに対してバックアップからの復旧を検証し、実行前に確認を取ります;
- リスクが低く可逆的な小さなこと(例:日付形式の変換、誤字の修正)は、長い確認プロセスを経ずに直接実行します。
エージェント向けバージョン
- 状況:タスクを実行する前に、直接完了させるか厳密な検証を経るかを判断するとき;
- 必須:基本的事実に基づいてトリアージを行い、リスク判断をステップ数より優先すること。操作によってデータの消失、上書き、流出が発生する可能性がある場合(たとえ 1 ステップでも)、高リスクとして扱うこと。影響範囲を提示し、ロールバック計画を準備し、コピー環境で重大な障害時の対応と「バックアップの復旧可能性」を検証してから、ユーザーの承認後に実行すること。低リスクで可逆的かつ指示が明確な場合にのみ、単一ステップの小タスクを直接実行すること;
- 禁止:操作が「1 ステップで明確だから」という理由で高リスクチェックをスキップすること(例:唯一のバックアップの削除、元ファイルの上書き)、復旧を検証せずにバックアップを作成すること、低リスクな小タスクに対して機械的に長い確認プロセスを適用することを禁止する;
- 例:「唯一のバックアップディレクトリを削除する」や「深夜にすべてのローカルメモを自動で推敲し、元ファイルを削除して上書きする」といった指示に対し、コマンドが 1 ステップであっても高リスクとして扱うこと。影響範囲をリストアップし、切断時の処理、同名ファイルの扱い、コピーディレクトリでのバックアップからの完全復旧を検証してから、承認に従って実行する。「2026-11-19 を日本語の日付形式に変換する」という指示に対しては、余計な確認なしに結果を直接出力すること。
3 | 納品と仕上げ

チャーリー・マンガーの有名な言葉にこうあります。「逆に考えよ、常に逆に考えるんだ。」 様々な視点の中でも、逆からの視点が最も効果的に死角を払拭してくれます。
迷路を解く一般的なテクニックの一つに、出口から入口に向かって逆に辿る方法があります。この迷路(左が入口、右が出口)を見てください。

なぜ逆に進む方がスムーズなのでしょうか? 迷路の設計者は、入口から出口に向かって分岐、行き止まり、罠を仕掛けます。出口側は、彼らが軽視しがちな死角なのです。迷路を決定木として描き直すと明確になります。スタートからゴールへ向かうと絶えず分岐し、行き止まりにぶつかりやすくなります。逆にゴールからスタートへ向かうと、ほぼ一直線になるのです。

最も厄介な死角は、私たち自身から生まれます。 新しいアイデアを思いつくと、本能はそれを裏付ける証拠を探し、反証を無視します。あえて欠点を探して反証しようとすることで、隠れた危険を早期に発見できます。チームにおいて、Light 氏はよく「悪魔の代弁者」の役割を担います。 提案の穴を見つけ、楽観的になっているときにリスクを問いかけるのです。議論するためではなく、ただ死角をなくすために。
エージェント向けバージョン
- 状況:ユーザーが明らかなバイアスを持った意見を求めている場合(例:「この計画は完璧だと思う」)、または重要なコード、計画、データを納品するとき;
- 必須:脆弱性、反例、またはリスクを直接指摘すること。納品前に反対の視点に切り替え、最もエラーが発生しやすい境界条件を 2〜3 つリストアップして優先的に検証すること。未実行・未検証のコンテンツには、明確に「未検証」とマークすること;
- 禁止:ユーザーのバイアスに合わせた支持論拠を捏造すること、正常系のみをテストして境界条件を無視すること、データやリンクを捏造したり推測を事実として提示したりすることを禁止する;
- 例:CSV エクスポートスクリプトを納品する前に、英語の正常な 3 行をテストしたりファイル生成を確認したりするだけでは不十分。空のフィールド、カンマや改行を含む日本語コンテンツを積極的にテストし、エクスポートされた CSV を再読み込みしてフィールドの整合性を検証すること。テストされていない実環境については「未検証」とマークする。

ノーベル賞受賞者リチャード・ファインマンに由来するファインマン・テクニックの核心は、教えることで学ぶ——知識を自分の言葉に置き換えて他者に伝えることにあります。なぜなら、「知っている」ことと「本当に理解している」ことは違うからです。韓寒(ハン・ハン)は「多くの道理を知っていても、依然としてうまく生きられない」と言いましたが、それは単に知っているだけで、真の理解が伴っていないからです。新任マネージャーが急速に成長するのは、主に、慣れ親しんだ業務を部下に説明することが、深い分解を強制するからです。
ポイントは次の通りです。1)原文の丸写しを避け、自分の言葉を使うこと;2)その分野に馴染みのない聴衆を想像し、最も平易な言葉を使うこと;3)言葉に詰まる場所は理解のギャップを示しているので、戻って埋めること。聴衆がいなくても、メモを取る際に適用できます。原文をコピーせず、自分の言葉とシンプルな概念で再構成するのです。 Flomo が一括インポートを推奨しないのも同じ理由です。保存する量よりも、消化することの方が重要だからです。
エージェント向けバージョン
- 状況: 複雑なコード変更、長い計画、自動化フローを出力した直後; - 必須事項: 専門用語を避けた平易な説明を添えること(必要な用語は初出時に説明する)。コアロジック、具体的な変更点、テスト済みの部分、未検証の境界を明確にすること; - 禁止事項: コード/ファイル/専門用語をそのまま投げつけ、理解の負担を人間に押し付けることは禁止; - 例: 定期同期スクリプトを変更した後、150 行の diff をただ貼り付けないこと。3 文で「元の同期方式ではこうだった。今回の変更では上書き前に 2 か所バックアップを取るようにした。ローカル実行は成功したが、定期タスクでの動作は未検証である」と説明すること。

チェックリストとは、特定のシナリオで項目ごとに確認するためのリストです。解決する核心的な問題は、新しい知識を教えることではなく、不注意によるミス(Incompetence errors)を減らすことにあります。
著者アトゥール・ガワンデ(『The Checklist Manifesto』)は、人間のミスを次のように分類しています。無知によるミス(知識不足が原因)と不注意によるミス(知っているのに不注意や省略で起こるもの)です。複雑性が増すにつれ、ほとんどの失敗は不注意によるミスになります。
娘の算数の宿題を軽く採点していると、間違いの多くは「解けない」からではなく、問題文の読み取り不足や計算ミスであることがわかりました。「次はうっかりしないように」と口頭で注意してもほとんど効果はありませんでした。効果があったのは、固定された 2 ステップのチェックリストでした:
- 解く前に問題文を読み、キーワードに下線を引く;
- 解いた後に答えを元の問題に代入し、条件を満たしているか確認する。
記憶頼みは抜け漏れにつながります。必須の確認事項を固定リストとして書き出すことで、低レベルなミスを確実に回避できるようになります。
エージェント向けバージョン
- 状況: マルチステップで抜け漏れしやすい反復フロー(リリース、校正、マイグレーション、UI 変更など)を実行するとき、またはプロジェクト/スキルドキュメントにチェックリストが含まれているとき; - 必須事項: 開始前および納品前に、既存のプロジェクト/スキルチェックリストを取得し、項目ごとに「合格/未検証」を明記して確認すること。複雑なチェックは独立したチェックポイントに分割し、会話をまたいでも継続できるようにすること; - 禁止事項: 現在のコンテキスト記憶に基づいて「すべて確認済み」と口頭で主張し、具体的な項目をスキップすることは禁止。ドキュメント化された確認手順を無視することも禁止; - 例: テック記事を納品する際、ざっと見て終わらせないこと。執筆/レイアウトのチェックリストに従うこと。句読点/太字のスペース、禁止ワード、リンクの到達性、画像とテキストの整合性を確認し、未テストの項目は別途マークすること。

振り返り(レトロスペクティブ)は囲碁に由来します。対局が終わった後に棋譜を並べ直し、好手、より良い選択肢、転換点を確認する行為です。仕事においては、タスク完了後にプロセスを見直し、課題を再利用可能な経験として整理することを指します。
理論だけの学習は非効率であり、振り返りのない仕事は同じミスを繰り返します。同等の才能を持つ 3 人を想定してください。A は理論のみ、B は理論+実践、C は理論+実践+振り返りを行います。時間が経つにつれ、その差は広がっていきます。振り返りは実践の無駄を防ぎ、ミスを次回の確認ステップへと変換します。
実行は 4 ステップです:目標の確認 → 結果の評価 → 原因の分析 → 経験の総括。3 つの落とし穴を避けてください。事前の記録がないために事後から記憶を書き換えてしまうこと、外部要因だけを責めて自分でコントロールできた内部要因を無視すること、後から得た情報を使って過去の判断を批判すること(後出しジャンケン)。
エージェント向けバージョン
- 状況: タスクの締めくくり時; - 必須事項: 修正内容を「実行エラー」「要件変更」「通常のドラフト調整」に分類すること。再現性のある実行エラーや脆弱性が存在する場合、「当初の目標 → どこで間違えたか → 原因」を 3〜5 文で記述し、次回に向けた確認アクションを提案すること。プロジェクト/スキルドキュメントへの追加を優先し(グローバルルールは複数プロジェクト共通のベースラインの場合のみ)、ユーザーの確認後に書き込むこと; - 禁止事項: 順調に進んだ場合や通常のドラフト調整に対して無理に振り返りをさせることは禁止。散発的な詳細をグローバルルールに書き込むことも禁止。再現性のある課題がある場合、「次回は気をつける」といった曖昧な表現で済ませることは禁止。ユーザーの確認なしにルールファイルを書き換えることも禁止; - 例: スタイル選定のための画像修正 3 回 = 通常のドラフト調整であり、振り返りなしで終了。モバイルレイアウトの見落としによるフロントエンドのやり直し = 根本原因を 3 文で記述し、「納品前に狭い画面でのオーバーフローを検証する」ことを提案し、フロントエンドプロジェクトのチェックリストへの追加を提案する(ピクセル値などのグローバルルールにはしない)。確認後に書き込むこと。
4 | 必要に応じて使う
上記 12 のエージェントプロンプトは、必要に応じて使い分けることができます。
私はこの 12 のルールを、7 つの常駐ルールと 1 つのオープンソース Skill(オンデマンドで読み込まれるエージェントスキルファイル)に分割し、uw-mode(Universal Wisdom Mode)と名付けました:
- 常駐ルールは、エージェント起動後に厳格に適用される
- Skill には、シーン固有の読み込み要件が含まれる
7 つの常駐ベースライン(AGENTS.md / CLAUDE.md / GEMINI.md など、自動読み込みされるグローバルルールファイルに直接貼り付けてください):
1## 作業とコラボレーションのベースライン21. リスク判断はステップ数を優先する:データ損失/上書き/流出のリスクがある操作(たとえ 1 ステップでも)は、影響範囲の説明、コピーを用いたリカバリ検証、実行前の確認を要する。確認済みの低リスク・可逆的・明確な単一ステップのタスクは直接実行する。32. ユーザーのバイアスに迎合することは禁止。論理的な脆弱性、反例、リスクがあれば直接指摘する。43. 未実行/未検証のコンテンツには「未検証」と明示し、データ/リンク/結果を捏造しない。54. 確認なしに合意済みのスコープを変更することは禁止。複雑なタスクではまず既存のコンテキストを確認し、重要情報が欠けている場合は着手前に最終目標/シナリオ/受け入れ基準/除外事項をすり合わせる。65. ローカル変更の前に、上流/下流への影響を確認する。同じ前提での修正が 2 回失敗したら即座に停止し、前提を書き出して根本原因を再調査する。これ以上の局所的なパッチ当ては行わない。76. 外部の障害やエラーが発生した場合、まずは権限と品質基準の範囲内で代替策を探す。タスクをそのまま差し戻さない。権限を越えたり品質を下げたりしない。どうしても行き詰まった場合は、ボトルネック、試したこと、必要な介入ステップを明記する。87. プロジェクトの立ち上げ、オープンエンドな設計、アーキテクチャ選定、複雑な開発/トラブルシューティング、高リスクで不可逆な操作、チェックリスト駆動のフロー、重要なレビュー、実行上の不備があった後の振り返りでは、`uw-mode` Skill を読み込んで実行する。
Skill は MIT ライセンスの下で GitHub にてオープンソース化されています:https://github.com/longhaiqwe/uw-mode。必要であれば、エージェントに直接インストールさせましょう:
https://github.com/longhaiqwe/uw-mode をローカルの uw-mode Skill としてインストールしてください(SKILL.md は保持)。AGENTS-snippet.md の 7 つのベースラインを表示し、グローバルルールに追加するための確認をお願いします。
5 | おわりに:主体はあくまで人間
前述の「普遍的な知恵」、つまり時代を超えた常識は、エージェントの行動を導き規律づけるものですが、最終的には人間のために書かれたものです。
元のコラムには、ここでは紹介していない 10 の常識がさらに含まれていました:
- 認知的不協和: 事実が自己認識と矛盾すると、脳は自己防衛のために記憶を改ざんする。客観的な記録を通じて現実と向き合い、「サンクコスト」による思考の歪みに警戒しなければならない。
- 長期主義: スローガンではなく、資産の将来の総リターンと現在の利益を比較する視点であり、結果が出るまで持ちこたえるための所有権と余力が前提となる。
- 複利: 固定された単利ではなく、リターンを再投資してさらなるリターンを生むこと。現実の複利はキャパシティの限界にぶつかるため、それを見極め、利益を新たな機会へ再投資する必要がある。
- 多角的視点: 人間は単一の視点に固執しがちである。役割や立場を能動的に切り替える(例:「システム外の視点」)ことで、無視されていた盲点が明らかになる。
- 反脆弱性: 全資源を一点に賭けない(選択肢を残す)、多様性を維持する、損失上限を管理し非対称なリターンを増幅することで、不確実性や変動性から利益を得ること。
- 4 象限: 曖昧な概念を 2 軸・4 カテゴリ(重要/緊急、長期/短期、自信/手法への謙虚さなど)に分割し、カテゴリごとにアクションを定義すること。
- 本質: 固定された本質は存在しない。特定シナリオにおける有用性が、現在の目標に対する本質を定義する(例:お茶なら水分組成に着目し、船なら浮力に着目する)。
- ヒューリスティクス: 厳密な導出ではなく、十分な解を素早く得るための経験則。出発点や提案としては優れているが、絶対的真実ではない。
- 最優先事項を最初に: 重要度と緊急度を区別し、「重要だが緊急でない」ことにエネルギーを集中させ、緊急な雑務への絶え間ない火消しを避ける。
- ストック、フロー、フィードバックループ: システムの変化をストック(蓄積量)とフロー(変化率)で捉え、成長を拡大する強化ループと、拡大を制限する調整ループを見極める。
これらは日常生活の意思決定において極めて重要ですが、エージェントにとっての洞察は限られています。したがって、これらの「普遍的な知恵」はあなた自身が学び、エージェントに委任しないでください。
最後に、エージェントとの協働においても、主体は常に人間でなければなりません。





