AIエージェント時代の必須フロー

― インストールされたライブラリの”見える化”を怠ると危険 ―

はじめに

AIエージェントを使っていると、開発はどんどん自動化されていきます。

• ライブラリの追加
• フレームワークの導入
• ツールのインストール
• プロジェクト構成の変更

気づけば、人間が手を動かさなくてもシステムが構築されていく状態になります。

しかしここに大きな落とし穴があります。

AIエージェントの”見えない積み上げ問題”

AIエージェントは優秀です。ただし、基本的にこういう動きをします。

• どんどんインストールする
• 最適と思われる構成に変更する
• 必要そうな依存関係を追加する

その結果起きるのがこれです。

• どのライブラリが入っているか分からない
• どの階層がどれだけ肥大化しているか不明
• 何が本当に必要なのか判断できない

つまり、ブラックボックス化したプロジェクトになります。

必須フロー：「構造と容量の可視化」

AIエージェントを使う上で、絶対に入れておきたいフローがあります。

それが「インストール後に必ず確認する」仕組みです。

AIにこう指示するだけです：

「どの階層に、どのライブラリが、どれくらいの容量で入ったか教えてください」

可能であればさらに：

• node_modules / venv / lib の内訳
• 追加・更新・削除されたパッケージ一覧
• ディレクトリごとの容量
• 依存関係の概要

なぜこれが重要なのか

① AIは”正しさ”より”動作”を優先する

AIは「動けばOK」で進める傾向があります。

• 軽量かどうか
• 構造が綺麗かどうか
• 将来壊れないか

ここは後回しになりがちです。

② 人間が理解できないと改修できない

ブラックボックス化したプロジェクトは危険です。

• ちょっとした修正ができない
• どこを触ればいいか分からない
• 依存関係が怖くて触れない

結果として「AIで作ったのに直せない状態」になります。

推奨フロー（シンプル版）

AIエージェントを使うときは、これを習慣にします。

1. AIに開発させる
2. インストール・変更が終わる
3. 構造レポートを出させる

その際に必ず聞く：

• どの階層に何が入ったか
• どれくらいの容量か
• 依存関係はどうなっているか

さらに一歩進んだ使い方

余裕があればこれも追加します。

• 「変更前との差分を出して」
• 「削除してもいいものを提案して」
• 「軽量化案を出して」

ここまでやると、AIはただの実行装置ではなく、設計レビュー担当になります。

まとめ

AIエージェントは非常に強力です。しかし強力であるほど、管理が必要になります。

ポイントはこれです。

• 作らせるだけで終わらせない
• 必ず構造を可視化する
• 容量と依存関係を把握する

つまり、

「使いながら理解する」ではなく「理解しながら使う」

この意識に切り替えることが重要です。

関連記事

• AIログ解説_RaspberryPiにClaudeCodeをインストールする
• AI時代に生き残る人消える人