
【前編】Vibe Codingはなぜ後半で破綻するのか?GitHub Copilot CLIで作る「AIモノレポ運用の型」
最近、AIエージェントにコードを生成させる「Vibe Coding」が主流になりつつあります。
GitHub Copilot CLIやCursorなどを駆使すれば、開発の初速は信じられないほど上がります。
しかし、実務でこれを使っているエンジニアなら、薄々気づいているはずです。
「開発が後半に進むにつれて、急激に苦しくなる」という事実に。
この記事では、業務内容を外部に出さずに共有できる「汎用モノレポ運用の型(Playbook)」の前編として、Vibe Codingが失速する原因と、それを防ぐためのアーキテクチャ・コンテキスト制御の設計思想を公開します。
1. なぜVibe Codingは「後半」で苦しくなるのか?
Vibe Codingは初速が速い一方で、プロジェクトが育つにつれて以下の問題が噴出します。
AIが文脈を見失う: コードが増えるほどAIに渡す文脈が膨張し、実装精度が落ちる。
根本原因に届かない: AIが同じエラーを何度直しても、表面的な対処療法を繰り返す。
機能間の矛盾: 一方を直すと他方が壊れる。AIがその場のノリで実装するため、前提が矛盾する。
非機能要件の壁: 排他制御、トランザクション、非同期処理といった要件が、後半で一気に重くのしかかる。
レビュー不能: PR(プルリクエスト)が肥大化し、人間の認知限界を超える。
つまり、後半で苦しくなる理由は「AIの性能」ではありません。
「構造・工程・記録の型」がないこと、そして「型が破れたときのレジリエンス(復元力)設計」がないことが最大の原因です。
2. AI時代を生き抜くための「基本思想」
このPlaybookでは、役割を以下のように明確に分割します。
Superpowers: 開発工程(計画・実装・テスト・レビュー)の本線
Repo Local Skills: モノレポ固有の判断(影響範囲、ドキュメント更新要否など)
Copilot Instructions: 常時効かせるルール(スコープ切り、小さく変更など)
Nx: 影響範囲の計算と境界管理
エスカレーション閾値: 人が介入する明確な判断基準
AIに「すべて」を任せるのではなく、AIが働きやすい「型」を作ることが重要です。
3. モノレポ・アーキテクチャの基本方針
AIのコンテキスト膨張を防ぐためには、「アプリを薄く保つこと」が絶対条件です。
apps/: 実行アプリの入口(ここに深い業務ロジックを書かない)
packages/: 再利用可能な責務
docs/: 運用資産
.github/: AIに効かせる運用ルール
▼ Backendのルール(Clean Architecture寄り)
深い業務ロジックや契約(Contract)、外部接続をapp側に持ち込むと破綻します。
domain層はUIやフレームワークに依存せず、shared contractを使って入出力を固定します。
▼ Frontendのルール(Feature-Sliced Design寄り)
コンポーネントに深い業務ルールを書かず、API呼び出しを散らさない。
feature単位で責務を切り、UIとオーケストレーションを混ぜないことが鉄則です。
最新mainと保存済み認証を混ぜずに扱う3層モデルを整理しました。
4. コンテキスト制御戦略:「CONTEXT.md」の魔力
AIエージェント開発において最も重要なのが「AIに読ませるファイルの優先順位(コンテキスト制御)」です。
各 app / package のルートに CONTEXT.md を配置し、AIに「何を読み、何を読まないべきか」を強制します。
▼ CONTEXT.md の記述例
# CONTEXT: <app or package name>
## この module の目的
(1〜2文で完結に)
## 依存先(AI が合わせて読むべきもの)
- packages/shared-contracts(型定義)
- packages/core-a(計算エンジン)
## 依存先だが通常読まなくてよいもの
- packages/shared-observability(ログ基盤)
## この module を変更するとき必ず確認すること
- shared-contracts との整合
- xxx のテストさらに、.github/copilot-instructions.md に以下のルールを追記します。
「作業対象 module の CONTEXT.md を最初に読むこと。読まなくてよいものに挙がっているファイルは、明示的に必要になるまで読まないこと」
これにより、AIの文脈窓(Context Window)の無駄遣いを防ぎ、ハルシネーションを劇的に減らすことができます。
後編へ続く
前編では、Vibe Codingの課題とアーキテクチャの型について解説しました。
次回の【後編】では、「AIがエラーから抜け出せなくなった時のエスカレーション設計」や、「実務でそのまま使えるワークフローとSkillの全貌」を公開します。
【第1回:思想編】 Vibe Codingはなぜ後半で破綻するのか?
【第2回:運用編】 AIの暴走を止める「エスカレーション設計」
【第3回:ツール深掘り①】 なぜAIに「Superpowers」をインストールするのか?
【第4回:ツール深掘り②】 「Nx」はモノレポツールではない。AIを縛る「防護壁」だ
【第5回:実装編】 そのまま使える!AIエスカレーション&トリアージのカスタムSkill集
より学びを深めたい方へ
まず最初に読むならこの3冊
1. 『Clean Architecture 達人に学ぶソフトウェアの構造と設計』
アプリを薄く保つ、依存方向を守る、業務ロジックをUIやフレームワークから切り離す、という記事の中核思想にかなり近い本です。
特に、あなたの記事の「apps は入口だけにして、深い業務ロジックは packages 側へ」という考え方を理解する土台になります。
2. 『ドメイン駆動設計入門 ボトムアップでわかる!ドメイン駆動設計の基本』
「shared contracts」「境界」「責務分割」を実務感のある形で理解しやすい本です。
DDDの重い理論書に入る前の橋渡し本としてかなり良く、モノレポで package をどう切るかを考えるときに効きます。
3. 『リファクタリング 第2版 既存のコードを安全に改善する』
Vibe Coding が後半で苦しくなる理由の一つは、AIがその場しのぎの修正を積み上げてしまうことです。
この本は、その逆で、外部仕様を壊さず内部構造だけを改善する筋力を鍛える本です。後半の破綻回避にはかなり重要です。
次に読むと理解が一段深くなる本
4. 『テスト駆動開発』
記事の「レジリエンス設計」「壊れても戻せる開発」に直結します。
AIが書いたコードを信じすぎず、変更を小さく安全に積むには、TDDや少なくともテストファーストの考え方がかなり効きます。
5. 『チームトポロジー』
これはコード本というより、運用の型を作る本です。
記事にある「AIに全部やらせず、役割を分ける」「エスカレーション閾値を決める」「チームと開発フローの設計を分けて考える」という発想に近いです。人とAIの役割分担を考えるときにも相性がいいです。
6. 『ソフトウェアアーキテクチャの基礎』
設計原則をもう少し広い視点で押さえたいならこれです。
モジュール、結合、アーキテクチャスタイル、アーキテクトの役割まで整理されていて、記事をシリーズ化するなら背景理論としてかなり使いやすいです。
モノレポ周辺まで広げるなら
7. 『実用 Git 第3版』
GitHub Copilot CLI 前提の記事なら、実はかなり大事です。
PRを小さくする、履歴を読みやすくする、ブランチ運用を崩さない、という部分はAI活用以前にGit運用力が土台です。あなたが考えている「小さい変更」「レビュー可能性」に直結します。
8. 『マイクロサービスアーキテクチャ 第2版』
モノレポそのものの本ではないですが、境界の切り方、結合・凝集、モノリスをどう捉えるかの理解にすごく効きます。
特に公式紹介でも、独立デプロイ、ドメイン境界、モノリスの利点と課題、結合と凝集、DDDとの関係が大きく扱われています。モノレポ内の package 境界を考えるときにも応用しやすいです。
9. 『ソフトウェアアーキテクチャ・ハードパーツ』
後半で効いてくる非機能要件の重さを考える本です。
あなたの記事の「排他制御、トランザクション、非同期処理が後半で重くのしかかる」という問題意識にかなり近いです。日本語版がO’Reilly Japanのカタログに載っています。
もしDDDをもう一段しっかりやるなら
10. 『ドメイン駆動設計をはじめよう』
入門より一段深く、設計方針から実装方法の選択まで整理されています。
「境界づけ」「複雑さに対抗する設計」という、AIが広げがちなコードベースを抑える考え方に向いています。
11. 『エリック・エヴァンスのドメイン駆動設計』
原典です。
ただし、いきなり読むと重いので、今のテーマなら入門書の後で十分です。体系だったアプローチを学ぶ本として位置づけるのが良いです。
あなたの記事テーマにいちばん合う「読む順番」
おすすめ順はこれです。
最短ルート
Clean Architecture
ドメイン駆動設計入門
リファクタリング 第2版
テスト駆動開発
チームトポロジー
この5冊で、
構造
境界
安全な変更
壊れにくい開発
チーム運用
まで一通りつながります。
かなり正直に言うと
「AI codingでAIモノレポ運用の型」そのものを、日本語書籍1冊で学べる本はまだかなり少ないです。
なので実務では、
アーキテクチャ本
DDD本
リファクタリング本
TDD本
チーム設計本
Git本
を束ねて、そこにあなたの記事のようなPlaybook化を乗せるのが正解に近いです。これは、各書籍がそれぞれ構造・設計・安全な変更・チーム運用を別々に扱っているためです。
AI・データ・開発の関連書籍をもう少し探したい方は、Book Media Techでテーマ別に比較できます。
Book Media TechでAI・データ・開発の本を探す

#AI駆動開発 #VibeCoding #GitHubCopilot #モノレポ #ソフトウェアアーキテクチャ #エンジニアの生存戦略 #DX #開発環境 #プロンプトエンジニアリング