メインコンテンツへスキップ
見出し画像

【前編】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では、役割を以下のように明確に分割します。

    1. Superpowers: 開発工程(計画・実装・テスト・レビュー)の本線

    2. Repo Local Skills: モノレポ固有の判断(影響範囲、ドキュメント更新要否など)

    3. Copilot Instructions: 常時効かせるルール(スコープ切り、小さく変更など)

    4. Nx: 影響範囲の計算と境界管理

    5. エスカレーション閾値: 人が介入する明確な判断基準

    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層モデルを整理しました。

    ▶ Coding Agentを安全に再実行する

    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. 『エリック・エヴァンスのドメイン駆動設計』

    原典です。
    ただし、いきなり読むと重いので、今のテーマなら入門書の後で十分です。体系だったアプローチを学ぶ本として位置づけるのが良いです。



    あなたの記事テーマにいちばん合う「読む順番」

    おすすめ順はこれです。

    最短ルート

    1. Clean Architecture

    2. ドメイン駆動設計入門

    3. リファクタリング 第2版

    4. テスト駆動開発

    5. チームトポロジー

    この5冊で、

    • 構造

    • 境界

    • 安全な変更

    • 壊れにくい開発

    • チーム運用

    まで一通りつながります。


    かなり正直に言うと

    「AI codingでAIモノレポ運用の型」そのものを、日本語書籍1冊で学べる本はまだかなり少ないです。
    なので実務では、

    • アーキテクチャ本

    • DDD本

    • リファクタリング本

    • TDD本

    • チーム設計本

    • Git本

    を束ねて、そこにあなたの記事のようなPlaybook化を乗せるのが正解に近いです。これは、各書籍がそれぞれ構造・設計・安全な変更・チーム運用を別々に扱っているためです。

    AI・データ・開発の関連書籍をもう少し探したい方は、Book Media Techでテーマ別に比較できます。

    Book Media TechでAI・データ・開発の本を探す

    AI・データ・開発の本を探す|Book Media Tech
    AI・データ・開発の本を探す|Book Media Tech


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

     
     
    生成AIを「知っている」から「実務で成果を出す武器」へ。AI駆動開発・Claude Code・AIエージェントを中心に、丸投げしない設計と現場で使える判断軸を解説。 As an Amazon Associate, I earn from qualifying purchases.

    あなたへのおすすめ