Uncle Bob の ub-mode は、コーディングエージェントに仕事の完了を証明させる

四つのプログラムを背負った skill ファイル
毎週のように、どこかのリポジトリがコーディングエージェントに人格を配っている。名前と口調と、モデルが気にすべきことの一覧を書いた markdown ファイルだ。skills フォルダに放り込んでスラッシュコマンドを打てば、エージェントは修羅場をくぐってきたシニアエンジニアのような口調でコミットメッセージを書き始める。
2026 年 11 月 15 日時点で ub-mode は GitHub で 7,989 スター、リポジトリは unclebob/ub-mode。導入手順も型どおりだ。SKILL.md を ~/.claude/skills/ub-mode/SKILL.md にコピーするか、Cursor や Grok の相当する場所に置いて、/ub-mode と打つ。三段階。「First Make it Work」には Laziness Protocol、Foundational Thinking、TDD、Redesign From First Principles、Attack the Premise、Subtract Before You Add、Outcome-Oriented Execution、Build the Lever、そしてドメインのモデリング、境界、型の規律、冪等な操作、共有状態を直列化する前の分離についてのアーキテクチャの節が入る。「Then Make it Right」には Fix Root Causes、Sequence Work into Verifiable Units、Test Behavior Not Implementation、Refactoring。「Practice」はログ、コンテキストウィンドウの衛生、worktree の後片付け、小さく順序立てたコミット。
スクリーンショットで引用されるのは、この一覧のほうだ。読む価値があるのは「Then Make it Right」の中身、つまり著者がエージェントの仕事を検査するために書いた四つのコマンドラインプログラムだ。
一文の問題
コーディングエージェントに終わったかと聞けば、返ってくるのは一文だ。「エンドポイントを実装し、テストも追加して、スイートは通っています」。その一文はコードを書いたのと同じプロセスが生成しているので、独立した情報を一切持たない。slop はここから来る。モデルの性格の問題ではなく、モデルが置かれているループの問題だ。エージェントにとっての完了の定義は主張であり、主張は安く作れる。
この skill は主張を、エージェントが動かさざるを得ない数字に置き換える。Crapper は関数ごとに循環的複雑度、テストカバレッジ、CRAP スコアを計算し、すべての関数を CRAP < 10 に保つよう求める。Dryer は構造的な重複を探し、類似度 0.8 以上のブロックの除去を要求する。Mutator はミューテーションテストを回す。わざとコードを壊して、テストが気づくかを見る。UML-viewer はコンポーネント、カバレッジ、CRAP スコア、ミューテーションスコア、依存の向きを描く。
四つのうち三つはビルドを落とせる。文章とは言い争える。終了コードとは言い争いにくい。反論が別のコードでなければならないからだ。
Attack the Premise
第一段階の九つの原則のうち、読み手がモデルのとき振る舞いが変わるものが二つある。
Attack the Premise は単体で出してもいいと思っている。エージェントの従順さには、具体的で高くつく癖がある。依頼を書かれたとおりに、有能に実装し、その依頼が存在すべきかは決して問わない。キャッシュ層を足せと言えばキャッシュ層ができる。テスト付きで、小さなステップでコミットされ、境界もきれいだ。エンドポイントが遅いのはクエリプランのせいかもしれない、とは誰も確認していない。このチケットが、二年前に去った誰かの判断への場当たり的な回避策だということにも、エージェントは気づかない。
人間のレビュアーが反論するのは、反論が無料で、周辺の文脈を頭に抱えているからだ。エージェントはルールに反論せよと言われたときだけ反論する。だから Attack the Premise は構造材になる。第一段階という位置も効いている。コードが存在する前、答えを変えるのがまだ安い段階だ。
Sequence Work into Verifiable Units が二つ目で、これは実質的に記憶の話だ。長いセッションは腐る。三ターン目に置いた制約は九十ターン目でもウィンドウに残っているが、重みはもう同じではない。モデルは一時間前に決めたルールを、自信たっぷりに破り始める。仕事を単位に切り、各単位の終わりにチェックを置けば、立ち止まって見る場所ができ、ゲートにも噛みつく対象ができる。四千行の変更の末尾のゲートは、その変更がダメだと言う。四十行の末尾のゲートは、どの四十行がダメだと言う。
数字が助けにならなくなる場所
ここから先は信頼をやめる。
CRAP < 10 は人間のコードレビューから出てきた。同僚の書いたコードを読む、忍耐に限りのあるレビュアーのために調整された数字だ。閾値に最適化するエージェントは、正直な四十行の関数を、もっとひどい名前で中身は同じ十二行の関数四つに分割できる。関数あたりの複雑度は下がり、カバレッジは保たれ、スコアは下がり、ビルドは緑になる。コードは何も良くなっていない。数字が良くなっただけだ。

重複は逆方向から壊れる。Dryer は類似度 0.8 以上のブロックを指摘する。九つの引数とモードフラグを取る共有ヘルパーを抽出すれば、類似度は閾値を下回る。置き換えた二つの関数より読みにくい関数が一つ残り、チェックは通る。ツールが測っているのは形で、形はもっと悪い形で簡単にごまかせる。
ミューテーションテストは正直なゲートで、高くつくほうだ。変異体ごとにスイートを回すので、実時間はスイートの実行時間に変異体の数を掛けたものになる。ノート PC なら許容できるが、エージェントが修正を反復しているループの中では苦しい。推測にすぎないが、エージェントが最初に手を抜くのはここだろう。mutator を飛ばすか、振る舞いを検証せずに変異体を殺すテストを書く。関数が null 以外を返すことだけを検証するテストは、驚くほど多くの変異体を殺し、ユーザーが認識できるものは何も検証しない。
いまゲートを出荷するエッセイスト
このプロジェクトには README が書いていないジョークがある。Robert C. Martin は二十年間議論されてきた。主に Clean Code のスタイル指南について、そのルールが苦労して得た経験なのか、マーケティングのうまい伝承なのかについて。その同じ著者が今、ルールを閾値と終了コードを備えたプログラムとして出荷し、読むのではなくインストールしろと言っている。
譲歩に見えるし、公正な譲歩だ。エッセイは実行できない。ある章に何年も反対し続けて、決着がつかないままでいられる。CRAP < 10 には一瞬で反対できる。自分のリポジトリでツールを走らせ、何を変えろと言ってくるかを見ればいい。スタイル論争は、誰かが数字を出すと終わる。少なくとも静かになり、具体的になる。コードについての散文で有名な人が、散文のほうが弱い部分だったと判断したわけだ。
ゲートに見えないもの
ひとつ限界を、率直に書く。これは skill ファイルと四つの CLI ツールだ。この一式のどこにも、人間が diff を読んだことを検証するものはない。ゲートが見るのはエージェントが生成したコードだ。そのコードが存在すべきだと誰かが同意したか、チケットにやる価値があったかについては何も言わない。一つだけ残せるなら残す、Attack the Premise は、markdown ファイルの一文のままで、モデルが指示に従う気があるか以外に強制するものがない。コレクション全体で最も強い項目が、唯一プログラムを背負っていない。どの問題が本当に難しいかが、そこに出ている。
導入する前に、エージェントを向ける予定のリポジトリに crapper を走らせる。二百の関数がすでに閾値を超えているなら、最初のセッションは機能開発ではなくリファクタリングになり、エージェントは頼んでもいないコードに予算を使う。その数字は、エージェントに午前二時に見つけてもらうより、自分で先に見たほうがいい。
関連記事
Pinky は agent に自分のスマホを操作させる。送信ボタンは、あなたが許可を押すまで押さえたまま
Pinky はどんな MCP agent でも本物の iPhone や Android につなぎ、承認をプロンプトではなく自前のゲートウェイで強制する。銀行アプリは見えず、パスワード欄は通行止め、Android 13 では agent に隠れた2枚目の画面が渡される。
サーバー1台、AI配信者1人:夜のライブ配信を動かすコードの中身
open-yoki は、毎晩 Binance Square で配信する AI ホストの本番コードで、人格・声・お金に関わる機能は取り除かれています。headless Chrome がフレームを描き、ffmpeg が RTMP を押し、Markdown フォルダが彼女の気分と投稿内容を決めます。
SoduWork の依頼は、チャットが止まったときではなく、依頼した人が承認したときに終わる
SoduWork はセルフホストのワークベンチだ。依頼には着手前に受け入れ基準が書かれ、納品は別の harness がレビューし、最後は人が承認する。うまくいった進め方はプラグインとして保存され、チームの他の人がそのまま実行できる。
世界の法律を git に入れた人がいる。だから法令も blame できる
global-law は各国の法令を git リポジトリとして持ち、1 つの commit が既知の日に効力を持った 1 つの法律にあたる。条文に対して log、blame、show、diff を実行でき、ある日の各国の施行状況を調べ、コーパス全体を MCP 経由でアシスタントに渡せる。