株式会社renue
AI導入・DXの悩みをプロに相談してみませんか?
AIやDXに関する悩みがありましたら、お気軽にrenueの無料相談をご利用ください。 renueのAI支援実績、コンサルティングの方針や進め方をご紹介します。
新しいコードベースに「4-6週間」かかっていた時代は終わった
新しいプロジェクトにアサインされた。技術スタックは初めて触るもの。コードベースは数万行。従来なら本格的に戦力になるまで4-6週間かかっていました。しかし2026年、AIエージェントを活用すれば1-2週間で生産的になれることが報告されています。
本記事では、未知の技術スタックやコードベースに最速で追いつくための体系的アプローチを解説します。
キャッチアップの5ステップフレームワーク
ステップ1:ゴールと初回レビューの確定
「知らないこと」に取り組む際、最初にやるべきはゴールの明確化です。何をいつまでに目指しているのかを把握し、その共通理解のもとに作業の確認を最低1回は確定させます。
確認すべき5属性
- For what:何のためにこの技術を学ぶのか
- What:具体的に何ができるようになる必要があるか
- Q(品質):どのレベルの理解が求められるか
- C(コスト):誰が・どれだけの時間を使えるか
- D(期限):いつまでに戦力になる必要があるか
ステップ2:情報収集(4つの観点)
- 作業対象:リポジトリの場所、ブランチ戦略、開発環境のセットアップ手順
- 過去事例:同じ技術スタックで開発した先輩、過去の類似プロジェクト
- 情報ソース:公式ドキュメント、社内Wiki、CLAUDE.md、README
- 有識者:技術に詳しい人、類似作業をした新人
ステップ3:AIエージェントに「プロジェクト概要」を聞く
ターミナルでclaudeを起動し、最初の質問を投げます。
このプロジェクトは何をしているか教えて。 技術スタック、ディレクトリ構成、主要な依存パッケージを説明して。
AIがプロジェクト全体を数秒で要約してくれます。人間が1時間かけてREADMEとpackage.jsonとDockerfileを読む作業を、最初の5分で完了できます。
ステップ4:コードリーディングをAIと一緒に行う
未知のコードベースを読む際、AIエージェントに質問しながら進めます。
「src/app/page.tsxの処理フローを説明して」 「このAPIエンドポイントは何をしているか」 「この関数の引数と戻り値の意味を教えて」 「このプロジェクトで使われているデザインパターンは何か」
Cursor IDEのコードベースインデックス機能を使えば、リポジトリ全体に対して質問でき、正確なファイル参照付きで回答が得られます。Claude Codeは複数ファイルにまたがる複雑なロジックのトレースに優れています。
ステップ5:小さな変更を実際にコミットする
読むだけでなく、小さな変更を実際にコミットすることで理解が定着します。
- typo修正やコメント追加(最もリスクが低い)
- 既存テストの追加(コードの挙動を学べる)
- 小さなバグ修正(実際の開発フローを体験)
AI会話フォーマット:セッション開始時のコンテキスト設計
AIエージェントとの会話を始める際、以下のフォーマットでコンテキストを提供すると、回答の精度が飛躍的に上がります。
# プロジェクト概要 - プロジェクト名:○○ - クライアント:△△ - 目的:□□を実現する # 現在のフェーズ - フェーズ:本番改修 - 期限:○月○日 - 今週のゴール:××機能の実装 # 技術スタック - 言語/FW:Python / FastAPI / Next.js - インフラ:Azure VM(Docker完結型) - LLM:Azure OpenAI # 今回のタスク ## やりたいこと ○○を実装したい ## 背景・経緯 クライアントから「△△」と指摘があった ## 制約条件 - 既存のテキスト処理は維持 - VM1台のDocker完結型 # 期待するアウトプット - □□が動作すること - テストが通ること
1週間のキャッチアップスケジュール
| 日 | やること | 成果物 |
|---|---|---|
| 1日目 | 環境構築+AIにプロジェクト概要を聞く | 動く開発環境+全体像の理解 |
| 2日目 | 主要画面・APIの処理フローをAIと読む | アーキテクチャメモ |
| 3日目 | 小さな変更をコミット(typo修正/テスト追加) | 初PRのマージ |
| 4日目 | 担当機能の周辺コードを集中的に読む | 担当範囲の理解 |
| 5日目 | 実際のタスクに着手(AIと並走) | 機能実装の開始 |
キャッチアップ時の注意点
AIの説明を鵜呑みにしない
AIは時として不正確な説明を自信満々に返すことがあります。特に暗黙的な動作やユニークなパターンに対して。重要な理解は必ず実際のコードを読んで検証します。
30分〜1時間で見通しが立たなければ相談する
AIに聞いても解決しない場合は、人間の有識者に相談します。「AIを使って自力で解決、30分〜1時間見通しが立たなければ相談する」が効率的な判断基準です。
3ヶ月前と同じ業務をしない
キャッチアップは一度きりではありません。3ヶ月ごとに「何を新しく学んだか」を振り返り、常に業務をアップデートし続けます。
まとめ:未知技術キャッチアップチェックリスト
| ステップ | チェック項目 | 目安時間 |
|---|---|---|
| ゴール設定 | 5属性(For what/What/Q/C/D)を確認したか | 30分 |
| 情報収集 | 4観点(作業対象/過去事例/情報ソース/有識者)を収集したか | 1時間 |
| AI概要把握 | AIにプロジェクト全体像を説明させたか | 5分 |
| コードリーディング | 主要ファイルの処理フローをAIと読んだか | 2-4時間 |
| 初コミット | 小さな変更を実際にコミットしたか | 1-2時間 |
| AI会話設計 | セッション開始時のコンテキストフォーマットを設定したか | 15分 |
| 検証 | AIの説明を実コードで検証したか | 随時 |
未知の技術スタックへのキャッチアップは「時間がかかるもの」から「AIで加速できるもの」に変わりました。5ステップフレームワークとAI会話フォーマットを活用し、1週間で戦力になることを目指してください。
関連記事
ビジネススキル研修のご相談はrenueまで。

