ANTIGRAVITY LABEN
記事一覧/Agents & Manager
Agents & Manager/2026-06-21上級

エージェントが足した依存を、あとから棚卸しする — ライセンスと出所を追える形で残す設計

エージェントに任せて数ヶ月が経つと、package.json に見覚えのない依存が静かに増えていきます。何が・いつ・なぜ足されたかを後から追える形に整える、棚卸しと出所記録の設計をまとめます。

Antigravity254依存管理ライセンスサプライチェーン長期運用2

プレミアム記事

ある朝、package.json を開いて手が止まりました。date-fns の隣に、入れた覚えのない小さな日付ライブラリが並んでいます。git blame をかけると、3週間前のエージェントのコミットでした。テストを通すために足したのでしょう。動いてはいます。けれど「なぜこれを選んだのか」「ライセンスは何か」「外しても平気か」は、もうどこにも書かれていませんでした。

エージェントにコードを任せると、生産性は確かに上がります。その裏で、依存ツリーは静かに、こちらの記憶より速く育ちます。一つひとつは小さな判断でも、数ヶ月・複数プロジェクトぶんが積み重なると、誰も全体像を把握していない状態になります。これは長期運用でいちばん効いてくる種類の負債です。

ここでは、エージェントが足した依存を後から棚卸しし、ライセンスと出所を追える形に戻すための設計を整理します。

追えなくなると、何が起きるのか

「見覚えのない依存が一つある」だけなら笑い話で済みます。問題は、それが積み上がったときに現れます。

一つ目は、ライセンスの取り違えです。エージェントは機能を満たすパッケージを選びますが、ライセンス条件まで毎回吟味してくれるとは限りません。GPL 系のコードが商用クローズドのアプリに紛れ込んでいても、棚卸しの仕組みがなければ気づけません。

二つ目は、攻撃面の拡大です。直接依存が一つ増えると、推移的依存は十、二十と連れてきます。使っていない依存が放置されるほど、脆弱性の通知に追われる時間が増えます。

三つ目は、判断の喪失です。半年後に「この依存、外していいんだっけ」と迷ったとき、足した理由が残っていなければ、外す勇気も残せません。結果として、誰も触れない依存が永久に居座ります。

私自身、Dolice Labs として複数のサイトとアプリを個人開発で並行して回しているので、この三つはどれも実感があります。とくに三つ目の「判断の喪失」は、エージェント運用に固有の重さがあると感じています。人が足した依存には、たいてい記憶か Slack のログが残ります。エージェントが足した依存には、コミットメッセージ以上の文脈が残らないことが多いのです。

棚卸しを「三つの問い」に分解する

棚卸しを漠然と始めると、依存の多さに圧倒されて手が止まります。問いを三つに分けると、機械にやらせる部分と人が見る部分の線引きが明確になります。

問い知りたいこと自動化の可否
何が直接依存のうち、エージェントが追加したものはどれかほぼ自動化できる
いつどのコミットで、どの作業の流れで入ったか自動化できる
なぜその依存でなければならない理由があったか人の確認が要る

「何が」「いつ」は git 履歴に答えがあります。「なぜ」だけは、後から人が判断を補う必要があります。だからこそ、足した時点で「なぜ」を残しておく運用が効いてきます。後半でそこに触れます。

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
git 履歴から「エージェントが足した依存」だけを抽出する実装
ライセンスを集計し、許容ポリシーと自動で突き合わせる方法
出所をコミットに残し、半年後の自分が経緯を追える運用設計
Stripe による安全な決済 · いつでもキャンセル可能

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

Agents & Manager2026-06-21
無人エージェントの実行ログを、ディスクを溢れさせずに後から追える形で残す
スケジュール実行のエージェントは、落ちた理由を後から追えなければ直せません。実行ログをディスクを溢れさせずに残すため、3層保持・スキーマ版付与・圧縮ジョブで設計する方法を、複数サイトを自動運用する個人開発の現場からまとめます。
Agents & Manager2026-06-20
無人実行のエージェントをタイムアウトで止めたとき、書きかけのファイルが残る問題
スケジュール実行のエージェントがタイムアウトで殺されると、書きかけのファイルが静かに残ります。原子的な書き込み・固定名temp残骸の排除・書き込み後の内容検証で、無人パイプラインを壊さない設計をまとめました。
Agents & Manager2026-06-20
失敗したエージェントジョブを取りこぼさない — デッドレターと再投入の設計
スケジュール実行のエージェントが夜間に失敗したまま消えていく問題を、デッドレター退避と段階的な再投入で防ぐ設計を、複数サイトを自動運用する個人開発の現場からまとめます。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →