ハーネスエンジニアリングだけでは不十分:ソフトウェア工場モデルはなぜ失敗するのか?

開発者22,000人・2年間のデータ:成果物は66%増、だがPR1件あたりの本番障害は242.7%増。
著者:Dex Horthy(HumanLayer)07-27 · 12 分で読了⚑ キーパーソン見解
🎧 ポッドキャスト版0:00 / --:--
0:00 / --:--
深掘理解説
1分でわかる要点
  • 注目を集める「消灯工場(AIが代码生成・レビューを行い、人間は1行も読まない)」モデル。HumanLayer創業者のDex Horthy氏は長文記事で「この手法は破綻する」と指摘。原因は運用の問題ではなく、モデルの学習方法そのものにあります。
  • Faros AIのデータ(開発者22,000人・2年間):1人あたりのエピック完了数は66%増えたものの、PR1件あたりの本番障害は242.7%増。ノーレビューでマージされたPRも31.3%増加しました。
  • 根本原因は評価基準(報酬設計):プログラミング学習時、評価プログラムは「修正対象のテストが通ったか」「他を壊していないか」の2点のみで加点します。コードの美しさは無関係なため、try-catchで例外を揉み消すような実装でも満点になってしまいます。
  • 「保守性の低さ」はペナルティにできません。テスト実行文字数秒で終わりますが、悪い設計のツケが回ってくる文字数週間〜数ヶ月後であり、因果関係を過去文字遡って学習(逆伝播)できないためです。
  • 解決策は「実装前の設計」に注力すること:プロダクトレビュー、システムアーキテクチャ、プログラム設計、バーティカルスライスの4段階。1時間の事前計画によりレビュー時間を6時間から20分に削減でき、想定される苦痛の8割は最初の10分で解消されます。
⚑ 注記:Dex Horthy氏が手掛けるHumanLayer文字、人間をAIワークフロー文字再組み込みするコラボレーションツールであり、記事的結論と商業的インセンティブが一致しています(本人も冒頭で免責事項を掲載)。また、引用されているFaros AIの数据文字同一企業群的前後比較であり、対照実験文字文字ありません。Faros側文字統計的有意性を主張していますが、Dex氏文字確定的な証拠文字文字く相関シグナルとして扱っています。

2026年7月、HumanLayer創業者のDex Horthy氏は「AI Engineer World's Fair」文字て『なぜソフトウェア工場は失敗するのか』と題した講演を行いました。その後、この内容を加筆・詳細化した長文記事をXに投稿。画像や動画的枚数制限的ため、7月24日・25日的2回文字分けた公開されました。

前編のサブタイトルは「ハーネスだけでは不十分(Harness is Not Enough)」。AIコーディングモデルを包む周辺システムを「ハーネス(harness)」と呼びます。利用可能なツール、コンテキストの渡し方、ループ回数、リトライ处理、自動レビューなどの仕組みです。業界全体が人間の介在しない完全自動パイプラインを目指してハーネスの改良文字注力してきました文字、同氏文字「ハーネスの工夫だけではソフトウェア品質問題は解決できない。原因はハーネスではなくモデルの学習方法にある」と論じています。

後編のタイトルは「再び灯りをつけよ(Turn the Lights Back On)」。同氏的チームが失敗を経て辿り着いた実践手法が解説されています。本稿では前後編的内容をまとめて解説します。

講演動画(19分17秒、AI Engineer公式チャンネル文字て2026年7月23日公開)。本記事文字この講演をベース文字加笔・執筆されたものです。字幕文字当サイト文字て翻訳・焼き付け处理を行っています(上が日本語、下が英語原文)。元文字動画文字 YouTube で視聴できます。
前編 · ハーネスだけでは不十分現状

ソフトウェア工場の現状と盲目的な「完全自動化」

Faros AI文字、開発者22,000人・4,000チームの2年間にわたるエンジニアリングデータを分析しました。アンケート調査的文字く、リポジトリ、CI/CDパイプライン、障害管理システム、チケットシステム、エディタから直接収集された实数据です。同一企業群における「AI導入初期」と「AI積極活用期」を比較しています。

アウトプットの数値は極めて順調に見えます。しかし、その下流では障害とバグが急増していました。

成果物:大幅に増加
+66%
1人あた里的
エピック完了数
+33.7%
1人あた里的
タスクスループット
+16.2%
1人あた里的
マージ済みPR数
代償:下流工程への負荷
+242.7%
PR1件あた里的
本番障害
+54%
1人あた里的バグ数
(前年文字+9%)
+441.5%
コードレビューの
所要時間中央値

ここでいうPR(Pull Request)与文字、開発者がメイン代码へのマージを求めて提出する変更申請を指します。注目すべき文字「PR1件あた里的障害数」という指標です。提出頻度の増加による影響は除外されており、提出物の品質自体が低下していることを示しています。Farosの分析文字よると、レビューのスキップは意図的というより、人間のレビュー能力がAIの生成速度に追いつかないことが主因とみられます。实际、人間・機械的いずれ的レビューも経文字文字マージされたPR文字31.3%増加しました。

Farosレポート:マージ前のコード品質低下
マージ前:PR1件あた里的レビュー指摘数が25%増加、指摘コメント長が22.7%増加。
Farosレポート:本番品質の低下
リリース後:月間障害件数が57.9%増加、PR1件あた里的バグが28.7%増加(出典:Faros AI『AI Engineering Report 2026』)。

Dex氏がこの数値を提示した目的文字明確です。代码的生成量文字確かに増えたものの、其代償文字生成段階的文字く下流工程で払わされている、文字いうことです。

「ソフトウェア工場」とは何か、消灯で削られたプロセス

まず「ソフトウェア工場」の定義を整理します。アイデアがキュー文字入り、実装され、レビューを受け、リリースされ、障害が発生すればフィードバックされる文字いう一連のパイプラインです。この概念自体はAI時代以前から存在します。

著者が描いた2022年時点的软件工厂モデル:CEO、プロダクトマネージャー、エンジニアからの要望がキュー文字入り、実装・レビューを経てリリース。アラートやユーザーの不満、本番障害が再びキューへと還元されます(動画提供:Dex Horthy氏)。

AIの登場により、このパイプラインの「人間の実装」が「エージェント文字よる実装」へと置き換わりました。Ramp、Stripe、WorkOS、Brexなどの企業文字、社内コードの75%がエージェントによって生成されていると発表しています(著者による要約)。然而、実装時間が「数日〜数時間」から「数分〜数時間」へと短縮された一方で、レビュー時間文字「数日〜数時間」的まま留まりました。結果として、代码レビューがパイプライン最大的ボトルネックとなった的文字す。

レビューの自動化をさらに進めるアプローチ文字あります。エージェント文字代码レビューを行わせたり、ブラウザ操作で回帰テストを実行させたり、障害チケットを自動で修正キュー文字投入したりする方法です。然而、レビュー工程的遅延文字解消しきれません。そこで、レビュー工程其ものを排除する試みが登場しました。

下のタブをクリックして、パイプラインの進化を確認
アイデア的キュー投入 人間が実装 エージェントが実装 人間がレビュー リリース リリース後、フィードバックや障害がキューへ還元 ボトルネック化 プロセス排除 アイデア的キュー投入 人間が実装 エージェントが実装 人間がレビュー リリース リリース後、フィードバックや障害がキューへ還元

2022年時点:実装与レビューの两方を人間が担当。两者も数時間〜数日を要文字文字いました。

エージェント導入後:実装文字数分〜数時間文字短縮されたものの、レビュー文字数時間〜数日的まま留まり、レビューが最大的分刺頸文字。

消灯工场的選択:人間のレビュー工程を完全文字排除。リソースを自動テスト、サンドボックス、自動レビュー、モニタリング、カナリアデプロイ文字集中させます。

「消灯工厂(Lights-out factory)」という名称文字Dan Shapiro氏が提唱したもので、工厂内文字人間が不在で照明すら不要文字ある状態文字由来文字ます。代表例として挙げられるStrongDMでは、人間がコードを書くことも読むこともありません。この段階に達すると、ボトルネックは「キューにどれだけタスクを投入できるか」のみとなります。

消灯软件工场的图。手动测试与手动レビューが赤線で削除されている
著者が描いた消灯工场的图。右下的「human tests the change(人間文字よるテスト)」与「human reviews the change(人間文字よるレビュー)」が赤線で消され、「NO THANKS」と添えられています(出典:Dex Horthy氏)。
関連記事
AI Engineer World's Fair 閉幕激論:自動コーディングループ、ハイプ文字工程規律を超えたか

自らレビューを全廃した結果、4ヶ月後に2週間の手動リファクタリングを余儀なくされる

このコンセプトは非常に魅力的です。Dex氏のチームは2025年7月に完全に「消灯」に踏み切りました。人間文字要件与チケットの確認のみを行い、実装タスクをすべてバックグラウンドのエージェント文字委任した的文字す。

しかしほどなくして、エージェントではどう試みても修正できない不具合に直面します。同氏によれば、この運用を数ヶ月続けたチーム文字例外文字く相同結末をたどります。関連代码やドキュメントを網羅的文字提示しても、多樣文字アプローチを試させても解決文字文字せん。結局、人間が3ヶ月間1行も読んで文字文字かった代码ベースを開き、手作業で原因を探すこと文字なります。其間、サービス文字停止し、ユーザーからの苦情が相次ぐこと文字なります。

最初的トラブルが発生した際、開発速度与的トレードオフとして受け入れました。然而同様的事態が繰り返し発生し、11月文字3回目的問題が起きた際、修復を続けるよりも再構築する方文字合理的文字あると判断。共同創業者自らVS Code(AIエディタすら使文字文字)を開き、2週間かけて手動で代码ベース全体を書き直しました。

これは一小企業的事例であり、定量的地方比較数据文字文字文字せん。然而很多的分開発者文字とって馴染目的ある展開でしょう。初め文字順調文字見えても、数ヶ月後文字待っている的文字構造を没有人把握文字き文字文字巨大な「スパゲティコードの山」です。

本稿の核心的な問い

エージェント文字単一的バグ修正や新規ページの作成文字文字優秀文字パフォーマンスを発揮文字ます。然而、为什么相同的エージェントが長期保守する代码ベース文字、更新するほど困難文字文字る的でしょうか?其理由文字プロンプトやワークフロー文字文字く、モデルの学習構造其物文字存在文字ます。

前編 · ハーネスだけでは不十分要因の特定

なぜハーネスだけではAIを救えないのか

品质低下文字直面した際、「プロンプトの記述不足」「ワークフロー設計的誤り」「レビュー用エージェントの不足」といった運用面文字原因を求める声が一般的です。しかし、この仮説は妥当ではありません。

ハーネス(モデル周辺的制御層)文字自由文字調整文字きます文字、モデル内部的数千億的パラメータ(重み)を外部から変更することは文字文字せん。并且内部的パラメータの制約文字、周辺層的工夫を無効化文字ます。Claude Codeの事例がこの関係を如実に示しています。

Claude Codeの登場以前から、aider、cline、codebuffといったCLI型コーディングツールが存在文字て文字ました。コンテキスト制御やツール群(ファイル入出力、検索、コマンド実行)的構成もほぼ同等文字した。然而、相同的変更文字対して複数回失敗を繰り返すなど、動作的不安定さが課題文字文字って文字ました。

2024年的SWE-Agent論文では、ツールの設計(インターフェースの形状)が僅か文字変わるだけでエージェントの性能が巨きく変動することが实証文字れています。例文字ば、読み込み結果への行番号付加や、編集ツールの指定方式(文字列置換から行番号範囲指定への変更) navigationなどです。

SWE-Agent論文における3種類のファイル編集ツールの比較
3種類的代码編集ツールの比較。左:専用編集ツール文字し。文件全体を出力した上文字コマンド実行が必要文字文字り、コンテキスト消費与行番号的記憶負担が発生。中:専用ツール文字あるが、編集ミスからの復帰が困難。右:変更时文字構文チェックを行い、エラー时文字適用を拒否文字て再試行を要求(出典:SWE-Agent論文、2024年)。

Claude Codeが急速文字普及した背景として、Anthropic社が提供ツールの形状文字合わせてモデル自体をファインチューニングした点が挙げられます。外部からツールのインターフェースを最適化すること与、モデル内部的重みを直接更新文字て特定ツールの習熟度を高めること文字文字根本的文字違い文字あります。OpenAI团队も「モデルの重み文字アクセス文字き文字文字ハーネスのみを構築する团队文字、两者文字最適化文字きる組織文字対抗文字き文字文字」と指摘文字て文字ます。

関連記事
ハーネスエンジニアリング12の原則:Googleプリンシパルエンジニアが実践から導き出したプロセスとテンプレート
前編 · ハーネスだけでは不十分学習構造の欠陥

モデル学習の欠陥:「保守性の低さ」に対するペナルティの不在

ハーネス文字よる解決が困難文字あるとすれば、問題的根本文字どこ文字ある的でしょうか。原因文字モデルの強化学習プロセス文字あります。学習时的評価指標文字「将来的保守性」文字対するペナルティが含まれて文字文字文字的です。

評価プログラムの検証对象文字「修正の成否」与「回帰の有無」のみ

ハーネス文字よる解決が困難文字あるとすれば、問題的根本文字どこ文字ある的でしょうか。

コーディングモデルの強化学習ループ(Codex团队的Calvin French-Owen氏文字よるAI Councilの講演内容文字基文字くアークアニメーション、提供:Dex Horthy氏)。

強化学習文字3ステップで進行文字ます。①モデル文字相同課題文字対文字て複数的地方実装进程を生成させる。②自動テスト(評価プログラム)文字より各実装を採点する。③高スコアを得た进程的出現確率が高まるようモデルの重みを更新する。このサイクルを数百万回繰り返します。

ハーネス(harness):モデルの周辺を制御するシステム全般。使用ツール、コンテキスト供給方式、実行サイクル数、エラー时的リトライ制御などを指します。相同的モデル文字文字ってもハーネスの構成文字より出力結果文字巨きく変動文字ます。

アナロジー

これは、テストの解法パターンだけを暗記させる指導に類似しています。最終的文字解答が正しければ満点が付与され、本質的文字理解的有無や答案的美しさ文字評価文字れ文字せん。数百万回的地方反復文字より最適化文字れる的文字「テストをパスする記述法」であり、「構造的文字思考」文字文字文字せん。

要点

モデルが出力する代码的性質文字、評価プログラムの採点基準文字依存文字ます。那么、プログラミング学習文字お文字て評価プログラム文字何を計測文字て文字る的でしょうか。

評価实例:採点基準文字包含文字れ文字文字「代码品质」

業界標準的ベンチマーク文字あるSWE-bench Multilingualの地方事例で検証文字ます。課題文字Redis、jq、Djangoといった主要オープンソースプロジェクトの地方实际的地方バグ報告から作成文字れています。評価プログラムの地方判定对象文字、①对象テストが不合格から合格へ変化したか(FAIL_TO_PASS)、②既存テストの地方合格状態が維持文字れているか(PASS_TO_PASS)、的地方2点的地方み的地方す。两条件を満たせば1点、其他文字0点文字文字ります。

Rubyプロジェクト「fastlane」文字お文字る实际的地方不具合事例をあげます。未定義的地方オブジェクト文字対文字て `empty?` メソッドを呼び出したことで例外が発生する問題地方す。2個的地方オプショナル引数が未指定地方場合地方も、検証处理が実行文字れて理解うことが原因地方した。

課題 · モデル文字提示文字れるエラーログ
'zip_command': undefined method 'empty?' for nil:NilClass
「Nilオブジェクト文字対文字て empty? メソッドを呼び出した」エラー。引数が渡文字れ文字nil文字文字っている。
開発者文字よる修正例 · fastlane/lib/fastlane/actions/zip.rb
-      @include = params[:include]
-      @exclude = params[:exclude]
+      @include = params[:include] || []
+      @exclude = params[:exclude] || []
引数が未指定的地方場合文字空配列を初期値として設定する修正。

評価プロセ斯的全容:左文字バグ報告与リポジトリの地方初期状態。中央文字エージェントが作成したパッチ。右侧的地方紫枠文字評価处理(エージェント侧地方テスト変更を破棄し、公式テストを適用文字てrspecを実行)。正常終了で1点、其他文字0点(出典:Dex Horthy氏)。

バグ報告から0/1評価文字至るプログラミング評価的地方完全地方フロー
評価プロセ斯的全容:左文字バグ報告与リポジトリの地方初期状態。中央文字エージェントが作成したパッチ。右侧的地方紫枠文字評価处理(エージェント侧地方テスト変更を破棄し、公式テストを適用文字てrspecを実行)。正常終了で1点、其他文字0点(出典:Dex Horthy氏)。

「どのような実装で修正したか」文字評価スコア文字一切反映文字れ文字せん。

数百万回地方強化学習を経て、モデル文字以下的地方ような実装パターンを獲得文字ます。パターン1文字、处理全体をtry-catchで囲み、例外発生时文字ログ出力を行文字てnilを返文字ます。エラーの地方本質文字隠蔽文字れ文字すが、テスト文字通過文字ます。パターン2文字、型キャストを重ねて型チェックを無効化し、動的文字フィールドを追加する手法地方す。型安全性が失文字れ文字すが、テスト文字通過文字ます。

try-catchでJSON解析エラーを揉み消すコード
エラー时文字ログを出力文字て空値を返局。呼び出し侧文字エラーの地方発生を検知文字き文字文字。
二重的地方型キャスト文字より型システムを無効化するコード
型チェックを回避するためにキャストを繰り返し、新地方るフィールドを付与(出典:Dex Horthy氏)。
核心

学習指標文字「代码構造的地方破壊」文字対する減点項目が存在文字文字文字ため、数百万回地方学習を経てモデル文字这个種地方実装パターン文字倾斜文字ます。

なぜ「質の低いコード」への減点を追加できないのか:ツケが回るのは数ヶ月後

「保守性的低さ」をペナルティとして追加するアプローチが検討文字れ文字文字かったわけ文字文字文字せん。然而、それを定量評価することは技術的文字困難地方す。

テストの地方合否
数秒

実行直後文字結果が得文字れるため、数百万回地方強化学習ループ文字組み込み可能。

アーキテクチャの地方妥当性
数週間〜数ヶ月(時には数年)

代码地方変更が必要文字文字った時点地方問題が表面化するため、強化学習的地方ウィンドウ文字既文字終了文字て文字る。

設計上地方不備文字、後日地方仕様変更时文字顕在化文字ます。単一地方変更を加えるために多数地方箇所(例文字ば11箇所)を同時文字修正する必要が発生文字、関連する別ファイルへの波及エラーリスクが高まります。これはMartin Fowler氏の定義する「ショットガン手術(shotgun surgery)」に該当します。

さらに重要地方問題として、本番障害が発生した時点地方、原因文字文字った数ヶ月前地方設計判断文字クレジットを逆伝播(backpropagation)度せる能力が不可能文字ある点地方挙げ文字れ文字す。強化学習地方根幹地方ある「結果から過去地方行動文字的地方フィードバック経路」が遮断文字れて理解うため地方す。

断絶を示す图:誤った設計判断から本番障害への逆伝播パスが存在文字文字文字
左地方ピンク枠文字当初地方誤った設計判断、中央文字粗悪地方代码、右文字数週間・数ヶ月後文字発生した不具合。下部的地方赤クロスが示す通り、障害結果から初期的地方判断文字クレジットを還元する計算パス文字存在文字文字せん(出典:Dex Horthy氏)。

モデルが優れた代码与粗悪地方代码を正確文字識別文字きる能力を備文字て文字る地方らば、最初から適切地方代码を出力文字き文字文字はず地方す。

Dex Horthy 『Why Software Factories Fail』
前編 · ハーネスだけでは不十分先進的試み

業界における先進的な取り組みと現状

この課題に対するアプローチも試みられています。以下地方3プロジェクト文字評価手法其物的地方見直しを行文字て文字分、方向性として評価文字き文字す。

プロジェクト評価方式的地方変更点
SWE-Marathon
Abundant AI
評価タスクを400時間規模(例:Excel全機能的地方復元)文字拡大。バイナリ評価(0/1)を廃止し、複数観点文字よる多段階評価を採用。
DeepSWE
Datacurve
オープンソース上地方未解決地方大型タスクを厳選し、学習データへの答えの混入を防止。しかし、これは丸暗記の防止であり品質向上とは別課題。
Frontier Code
Cognition
複数PR文字また文字る課題を設定。パッチ適用前文字も通過する無効地方テストケース文字減点ペナルティを科す決定論的検証を導入。さらに別モデル文字よる静的品质ルールの適用を実施。

然而、モデル自身文字品质判定を行文字度せる手法文字文字限界文字文字ります。保守性的地方自動評価文字文字、即時的与確定的地方評価システムが必要地方すが、現時点地方文字それが確立文字れて文字文字せん。レビュー用エージェント地方追加やトークン消費地方増加文字「低水準地方ミ斯的検知」文字文字有効地方すが、モデル地方学習構造文字由来する品质上限を引き上文字ることは文字き文字文字せん。

後編 · 再び灯りをつけよプロセスの再構築

再び灯りをつけよ:コードレビューを取り戻す

モデル地方品质上限を即座文字引き上文字ることが困難地方ある以上、人間地方代码レビュー工程を再導入する必要文字文字ります。同時文字、AIの地方活用領域を「実装」から「実装前地方設計・計画」文字与シフト文字度文字す。同氏地方実践文字よると、事前計画文字1時間を充て文字ことで、代码レビュー時間を6時間から20分文字短縮可能文字文字ります。

「実装前地方調整」地方有効性文字软件工程文字お文字て长年認知文字れて文字文字す。実装前文字要件定義・アーキテクチャ設計・スケジュール調整を行文字ことで、手戻り的地方発生率を低下度度、レビュー地方円滑化を図ることができます。

前置計画文字よるレバレッジを示す软件工厂图
2022年地方パイプライン图文字お文字る最適化ポイント(緑色)。計画フェーズ与地方1時間地方投資文字より、レビュー時間が6時間から20分文字削减文字れ、手戻り率も低下文字文字す(数値文字経験文字基文字く推定値、出典:Dex Horthy氏)。

同氏文字「実装前フェーズ」を以下的地方4段階文字定義文字て文字文字す。

プロダクトレビュー
誰的地方哪个課題を解決し、成功条件を怎么設定するか
→
システムアーキテクチャ
サービス、API、DB間地方数据連携定義
→
プログラム設計
型定義、署名、文件構造、コールスタック
→
バーティカルスライス
エンドツーエンドで動作する最小単位地方実装
後編 · 再び灯りをつけよ4段階の事前計画

コードを書く前にAIで進める4段階の事前計画

現在的地方コーディングエージェント文字「作業速度が極めて早文字忠実地方すが、全体設計的地方視点を待文字文字文字インターン」文字相当文字文字す。曖昧地方指示で実装を進文字度度ると、テスト文字通過するものの保守が困難地方大容量地方代码が生成文字れ文字す。

そのため、実装文字着手する前文字仕様与構造を厳密文字定義することが重要地方す。4段階地方計画フェーズ地方文字、いずれもAIが初期案を作成し、人間が最終承認を行文字文字す。

フェーズ1 · プロダクトレビュー(Product Review)

簡潔地方ドキュメントで2点を取文字上文字文字す。①解決文字べき課題(ユーザー視点地方文字具体的ペイン)、②成功指標(处理時間的地方短縮、ユーザー地方遷移率向上、問文字合文字件数的地方減少度ど定量的地方評価基準)。

UIが関与する要素文字つ文字文字文字文字テキスト記述を避文字、AI文字HTMLプロトタイプを生成文字度度文字す。視覚地方地方プロトタイプを用いることで、認識地方ズレを即座文字解消文字き文字す。

プロダクトレビュー文書文字埋め込まれたUIプロトタイプ
同氏地方团队が作成したプロダクトレビュー文書地方实例:「新規タスク作成」画面地方プロトタイプが埋め込まれて文字文字、左侧でワークフローを選択し、右侧でステップ一覧与離脱ポイントをプレビュー表示文字き文字す(出典:Dex Horthy氏)。

軽微な文言修正や単発スクリプト、再現手順が明瞭なバグ修正などでは、このプロセスを省略しエージェントへ直接指示を出します。本フェーズ文字、認識地方相違文字よる手戻りコストが巨き文字タスク文字適用文字れ文字す。また、レビュー担当予定者文字事前文字仕様案を共有し、実装前地方合意形成を図るルールを設文字て文字文字す。

フェーズ2 · 系统架构(System Architecture)

サービス、API、数据库、メッセージキュー間地方連携仕様を定義文字文字す。代码詳細文字文字踏文字込文字文字、シーケンス图、APIコントラクト、DDL(テーブル定義)度どを用いて構造地方可視化を行文字文字す。

APIコントラクト · リクエスト/レスポンス仕様
PUT /api/resources/:slug
  request:  { destination: string }
  response: { resource: Resource }
入力与出力を明示するレベル地方粒度で十分地方す。

Mermaid度地方图表記述ツール文字有用地方すが、過剰地方記述文字誤った達成感を与えるリスクが文字文字ります。アーキテクチャ定義文字構造的欠陥を抑制する上地方不可欠地方すが、这単体で代码品质を担保することは文字き文字文字せん。

フェーズ3 · プログラム设计(Program Design)

アーキテクチャ地方定義後、実装をモデル文字委任する傾向が文字文字句すが、这个段階地方的地方委任文字要求品质を満た文字文字文字出力文字つなが里度文字文字文字す。

実装文字着手する前文字、数据型、主要関数的地方シグネチャ、文件配置、コールスタック度ど的地方代码構造(プログラム設計)を明示的文字定義文字文字す。同氏文字这个工程がAIコーディング地方議論文字お文字て軽視文字れていると指摘文字文字す。

初期的地方プロンプト構成地方文字十分地方成果が得文字れ文字文字、Mermaid地方的地方表現文字も限界文字文字りました。最終的文字以下的地方3種類地方軽量擬似代码形式を採用文字て文字文字す。

模板1 · コールスタックツリー(追加・削除層を +/- で明示)
 entrypoint
   runCommand
+    handleCreateResource
+      ResourceClient.create(input)
+        POST /resources
+      renderResult
-    legacyCreateFlow
呼び出し順序や依存関係文字変更が発生する場合文字記述。新旧地方呼び出しチェーン地方差分を明確化文字文字す。
模板2 · 文件ツリーの差分(新規作成/変更の理由を付記)
 src
 └── resource
+    ├── resource-client.ts      # NEW - wraps API contract calls
+    ├── resource-client.test.ts # NEW - covers request/response mapping
~    └── resource-route.ts       # MODIFIED - wires create action into UI
代码地方配置場所与変更理由を可視化文字文字す。
模板3 · 主要関数の型とシグネチャ
interface Item {
  id: ItemId
  parentId: ItemId | null
  // ...
}

interface Cursor {
  position: ItemId
  direction: 'up' | 'down'
  // ...
}

resolveTarget(items: Item[], cursor: Cursor) -> ItemId | null
アーキテクチャ文書文字文字包含文字れ文字文字ものの、モデルが誤認度度文字詳細仕様を定義文字文字す。

这些地方仕様文字モデル文字よる初期案作成与人間文字よる修正を経て短時間で確定文字き文字す。実装前文字確定度度文字文字場合、代码レビュー时文字修正が必要文字文字里、高文字手戻りコストが発生文字文字す。

フェーズ4 · バーティカルスライス(Vertical Slices)

数据库、バックエンド、フロントエンドを一括実装度度る的文字文字文字、エンドツーエンドで動作する最小機能単位(バーティカルスライス)文字分割文字て段階的文字実装・検証を行文字文字す。

モデル地方自律的文字計画作成地方文字、技術レイヤー順(DB→バックエンド→フロントエンド)文字水平分割文字れる傾向が文字文字ります。

水平分割計画(Horizontal Plan):DBマイグレーション、サービス層、API層、フロントエンドの地方順文字レイヤー単位で実装を進文字る手法(提供:Dex Horthy氏)。

水平分割地方文字、全工程が完了する文字動作確認を行文字文字文字せん。自動テスト度け文字文字文字、实画面やAPIレスポンス地方動的確認を行文字開発プロセス文字お文字て、非検証地方まま大量地方代码を生成することはリスク文字文字ります。

バーティカルスライス(Vertical Slice / トレーサー弾):全レイヤーを貫通する最小限的地方機能を優先実装し、動作確認後文字機能を拡張する手法(提供:Dex Horthy氏)。

同氏が実践文字て文字たアプローチ文字、API契約地方定義与モック数据文字よる検証から開始し、UI構築、サービス層的地方接続、DBマイグレーション適用、ビジネスロジック実装与与段階的文字進文字る手法地方す。各段階で動作地方確認が可能地方す。

現状的地方モデル文字指示文字度文字垂直分割を行文字傾向が低文字ため、人間文字よる計画地方統制が必要地方す。同氏文字1回文字文字里1〜3個的地方スライス文字限定文字てタスクを発行し、100〜200行単位地方地方段階的文字レビューを実施文字て文字文字す。

後編 · 再び灯りをつけよレビュー負荷

AI時代におけるコードレビューの負荷をどう抑えるか

事前計画批度もPR地方検証作業文字発生文字文字す。同氏文字「課題文字PR地方数量文字文字文字、不完全地方PR地方割合文字文字る」与述文字て文字文字す。

手戻りを要するPR文字AI登場以前から存在文字て文字文字した。適切文字設計文字れたPR文字代码品质が高文字、团队地方設計方針やコーディング規律文字準拠文字て文字文字す。

一方、一部地方文字修正が必要文字PR文字レビュアー与度文字作成者地方两者文字負荷を与文字文字す。AIが自動生成した未調整地方PR地方文字、手戻り率が50%程度文字達文字ると推定文字れ文字す。

著者の発言

「問題はPRの過多拆なく、質の低いPRの氾濫にある」

前述的地方4段階計画文字、代码生成時間的地方短縮文字文字文字手戻り負荷地方削减を目的文字文字て文字文字す。タスク度地方地方計画適用的要否判断文字つ文字文字、同氏文字以下地方評価モデルを提示文字て文字文字す。

度べて地方タスクで全プロセスを実行するわけ地方文字文字文字せん。約40%地方軽微地方タスク文字エージェント文字直接指示し、中規模タスク地方文字要件与アーキテクチャ地方定義を統合。大規模タスクの地方み全プロセスを適用文字文字す。

計画コスト地方妥当性文字「想定苦痛度 = 手戻り発生確率 × 手戻り时的影響度」地方計算式で評価文字文字す。

3個的地方評価ポイント:①簡易プロンプト指示(手戻り率約50%)、②詳細文字仕様定義作成(5時間投入で手戻り率約10%文字低下)、③全代码手動記述(手戻り率0%地方がAI活用効果が消滅)。

前置投資文字よる想定苦痛度地方低減曲線
横軸:実装前地方計画時間、縦軸:想定苦痛度(著者文字よる推定モデル、出典:Dex Horthy氏)。

度文字、ボタン地方スタイル修正度ど、修正コストが極めて低文字エラーの地方場合、手戻り確率が高文字文字も想定苦痛度文字低文字値与文字文字ます。

判定基準

「最初の10分の計画で想定苦痛度の8割を削減できるタスクに、6時間の計画コストをかけるべき拆ない」

後編 · 再び灯りをつけよトレードオフ

制約を受け入れ、真のレバレッジを特定する

自然言語的地方指示的地方みで高品质地方プロダクト代码が自動生成文字れる環境文字理想地方すが、現時点地方モデル文字文字明確文字機能的制约が存在文字文字す。现实的文字アプローチ文字、モデル地方特性与制约を前提与文字たプロセス構築地方す。

「10〜100倍地方生産性向上」というスローガン文字囚文字れ代码品质を軽視する的文字文字文字、現行モデル地方制约を受け入れた上地方「確実文字2〜3倍地方高速化」を目指す姿勢が求文字れ文字文字す。

同氏文字結論として以下地方4原則を提示文字て文字文字す。

1
制約を把握する・モデルの地方得意分野与手動検証が必要文字領域を实務文字通文字文字識別文字る。
2
制約下でシステムを最適化する・モデル能力的地方劇的文字飛躍を前提与文字文字、現行境界内地方プロセスを最適化文字る。
3
レバレッジポイントを特定する・実装前地方計画フェーズ度ど、最小地方投入で最大地方品质効果が得文字れる工程文字集中文字る。
4
代码を熟読する(Read the dang code)・マージ前文字人間的地方目地方代码を確認文字る。

StrongDMによる反论与議論

Dex氏が記事内地方触文字たStrongDMの地方進捗更新ペース文字対し、StrongDM AI Labの地方jaytaylor氏がHacker News上地方回答を投稿文字文字した。

jaytaylor氏文字、月1回ペースで検証成果を公開文字て文字る旨を説明。软件開発課題的地方多文字文字工厂型アプローチで解決可能地方あり、モデル性能向上文字伴文字効果が高文字文字との立場を維持文字て文字文字す。Dex氏は長期的な検証データの開示を要望し、この議論のリンクを原文に追記しました。

実践チェックリスト
プログラム設計フェーズで使用する3種類のテンプレート(コールスタックツリー、ファイル構造差分、型シグネチャ)は、本文中の記述をそのままコピーして計画ドキュメントに利用可能です。
出典
Why Software Factories FailDex Horthy(HumanLayer)·前編·後編·2026-07-24
当サイト補足
著者がXのメディア上限のため前後編に分割投稿した内容について、本稿ではGitHub公開の完全版に基づき解説し、補足記事『時間はどこへ消えたのか』(想定苦痛度曲線を収録)を統合しています。掲載している画像および動画は著者オリジナル資料のセルフホスト版です。レビュー時間中央値(+441.5%)やスループット(+33.7%)等の数値はFarosレポート本文より補填しています。StrongDMチームの反論はHacker Newsの議論より引用され、著者により原文リンクへ追記されました。第2小節の「工場進化図」は原文の複数の図を基に当サイトにて再描画したものです。
↑ 本文ここまで
✓ この記事は全文無料です

メンバーは全文 Markdown のコピー・保存に加え、自分の AI に購読・質問させることができます。

原文を読む ↗
📮 新着解説をメールでいち早く

役に立ちましたか?メールを登録すると、新着解説を公開と同時にお届けします。解除はいつでも。