失敗から学ぶ ~サブエージェントの正しい使い方~/subagent-lessons-learned_link-and-motivation

リンクアンドモチベーション登壇資料（2026/04/24）
失敗から学ぶ ~サブエージェントの正しい使い方

#TECH BATON #リンモチ#Claude Code
===========================================
【イベント情報】
■イベントページ
https://findy.connpass.com/event/387808/

【株式会社リンクアンドモチベーション】
■お問合せ先
　engineer_pr@lmi.ne.jp
■テックブログ
　https://link-and-motivation.hatenablog.com/
■開発組織の公式X
　https://x.com/LinkandM_dev
=============================================

Transcript

1. © Link and Motivation Group 株式会社リンクアンドモチベーション ブランド統合開発ユニット プラットフォーム推進グループ 林 龍蔵 失敗から学ぶ ~サブエージェントの正しい使い方~
2. 2 © Link and Motivation Group こんばんは！！
3. 3 © Link and Motivation Group 自己紹介 林 龍蔵（@りゅうぞう） 株式会社リンクアンドモチベーション ブランド統合開発ユニット プラットフォーム推進グループ プラットフォームエンジニア 各サービスを繋ぎこむ基盤作り(認証やユーザー管理) 趣味はカラオケ(十八番はAlexandrosのワタリドリ)
4. 4 © Link and Motivation Group Claude Codeを使っていて このような状況になったことありませんか？
5. 5 © Link and Motivation Group 陥りがちな状態 ・すぐに5h制限がきてしまう ・処理時間が長い
6. 6 © Link and Motivation Group サブエージェントの使い方の 問題かも 陥りがちな状態
7. 7 © Link and Motivation Group サブエージェントの使い方の 問題かも 陥りがちな状態 失敗から学んだサブエージェントの 正しい使い方をお話しします
8. © Link and Motivation Group 失敗談１
9. 9 © Link and Motivation Group サブエージェントの使い方の 問題かも 陥りがちな状態 ・すぐに5h制限がきてしまう ・処理時間が長い
10. 10 © Link and Motivation Group ある日… ワカリマシタ (8つのサブエージェントを起動) Claude わたし (8PR)並列で実装計画→実装して 一瞬でトークンを使い切り5h制限
11. 11 © Link and Motivation Group ある日… ワカリマシタ Claude わたし (8PR)並列で実装して 一瞬でトークンを使い切り5h制限 タスクの全量が大きいだけかと思っていたが...
12. 12 © Link and Motivation Group 問題 問題は役割の分離だった！
13. 13 © Link and Motivation Group 8つのPRの詳細 • DBにNot Null制約追加(テーブル１) #PR5 • DBにNot Null制約追加(テーブル２) #PR6 • DBにNot Null制約追加(テーブル３) #PR7 • DBにNot Null制約追加(テーブル４) #PR8 • DBにカラム追加(テーブル１) #PR1 • DBにカラム追加(テーブル２) #PR2 • DBにカラム追加(テーブル３) #PR3 • DBにカラム追加(テーブル４) #PR4
14. 14 © Link and Motivation Group 失敗 • DBにNot Null制約追加(テーブル１) • DBにNot Null制約追加(テーブル２) • DBにNot Null制約追加(テーブル３) • DBにNot Null制約追加(テーブル４) • DBにカラム追加(テーブル１) • DBにカラム追加(テーブル２) • DBにカラム追加(テーブル３) • DBにカラム追加(テーブル４) 各エージェント間で 同じ箇所のコードを読む
15. 15 © Link and Motivation Group 改善 機械的なまとまり (PRごとに...) Before After 似た内容のPRは同じサブエージェントに任せる！ 意味的なまとまり (適切な役割範囲で)
16. 16 © Link and Motivation Group 8つのPRを2つの意味的単位にグルーピング Not Null 制約 • DBにNot Null制約追加(テーブル１) • DBにNot Null制約追加(テーブル２) • DBにNot Null制約追加(テーブル３) • DBにNot Null制約追加(テーブル４) カラム 追加 • DBにカラム追加(テーブル１) • DBにカラム追加(テーブル２) • DBにカラム追加(テーブル３) • DBにカラム追加(テーブル４)
17. 17 © Link and Motivation Group 改善 Not Null 制約 • DBにNot Null制約追加(テーブル１) • DBにNot Null制約追加(テーブル２) • DBにNot Null制約追加(テーブル３) • DBにNot Null制約追加(テーブル４) カラム 追加 • DBにカラム追加(テーブル１) • DBにカラム追加(テーブル２) • DBにカラム追加(テーブル３) • DBにカラム追加(テーブル４) サブエージェント間の重複が激減 結果、トークン消費量も激減
18. © Link and Motivation Group 失敗談２
19. 19 © Link and Motivation Group サブエージェントの使い方の 問題かも 陥りがちな状態 ・すぐに5h制限がきてしまう ・処理時間が長い
20. 20 © Link and Motivation Group ある日… ワカリマシタ (Slack / Sentry / Redash / コード調査...) Claude わたし エラー調査して 1回の調査に20分も...
21. 21 © Link and Motivation Group 失敗 ワカリマシタ (Slack / Sentry / Redash / コード調査) Claude わたし エラー調査して 1回の調査に20分も... 詳細を追っていくと...
22. 22 © Link and Motivation Group 『経営トップが本気を示す』 調査ステップ 『経営トップが本気を示す』 Step 1 (sub1) Slack調査 Slackの届いたエラー通知 の内容を確認 Step 2 (sub2) Sentry調査 エラー通知の内容を より詳細に確認 Step 3-a (sub3) DB調査 エラー調査のステップ 現状の確認 『経営トップが本気を示す』 Step 3-b (sub4) コード調査 根本原因を特定
23. 23 © Link and Motivation Group 『経営トップが本気を示す』 調査ステップ 『経営トップが本気を示す』 Step 1 (sub1) Slack調査 Slackの届いたエラー通知 の内容を確認 Step 2 (sub2) Sentry調査 エラー通知の内容を より詳細に確認 Step 3-a (sub3) DB調査 エラー調査のステップ 現状の確認 『経営トップが本気を示す』 Step 3-b (sub4) コード調査 根本原因を特定 各ステップにサブエージェントを 起動させていた...
24. 24 © Link and Motivation Group サブエージェントの使用が ボトルネックに 失敗 ・サブエージェントは起動に時間がかかる ・メインとサブで情報を交換する時間が必要
25. 25 © Link and Motivation Group 改善 ステップごとにサブエージェント使用 Before After ステップごとではなく、処理内容によって使い分ける！ 重い&並列ができる処理に サブエージェント使用
26. 26 © Link and Motivation Group 『経営トップが本気を示す』 調査ステップ 『経営トップが本気を示す』 Step 1 (main) Slack調査 Slackの届いたエラー通知 の内容を確認 Step 2 (main) Sentry調査 エラー通知の内容を より詳細に確認 Step 3-a (sub1) DB調査 エラー調査のステップ 現状の確認 『経営トップが本気を示す』 Step 3-b (sub2) コード調査 根本原因を特定
27. 27 © Link and Motivation Group サブエージェントの使用場面を 見極め効率性アップ 改善 ・順列 & 軽いタスク → ×サブエージェント ・並列 & 重いタスク → ◦サブエージェント
28. 28 © Link and Motivation Group サブエージェントの使用場面を 見極め効率性アップ 改善 ・順列 & 軽いタスク → ×サブエージェント ・並列 & 重いタスク → ◦サブエージェント 20分かかっていた調査が 10分に！
29. © Link and Motivation Group まとめ
30. 30 © Link and Motivation Group サブエージェントの注意点 「範囲」 と 「内容」 サブエージェントを 起動させるような処理か？ サブエージェント間で 重複した処理はないか？
31. 31 © Link and Motivation Group ご清聴ありがとうございました！