【結論】探索と根拠提示を分けてSource Codeを解析
Source Code解析では、Repository全体の要約より、目的に応じた探索質問を設計する方が精度が上がります。
Claude Codeには関係するEntry point、Data flow、依存関係、根拠となるFileと行を提示させます。
# ターミナルでRepositoryの状態を確認
git status --short
# Claude CodeをPlan Modeで起動
claude --permission-mode plan具体的な手順・設定方法
解析目的を障害調査、Onboarding、Security reviewなどに限定します。
Explore系Subagentへ広い検索を委任し、Main Contextには要約だけを戻します。
解析結果をdocs/analysis.mdへ保存し、未確認事項と再現Commandを残します。
# 起動後のセッション内でContextを確認
/context
# ターミナルで参照箇所を機械検索
rg -n 'UserService|createToken' src実践プロンプト / 活用テクニック
AIの説明と静的検索結果を相互確認すると、依存関係の見落としを減らせます。
解析文書には事実、推測、提案を明確に分けます。
src/auth配下の認証Flowを解析してください。
Entry pointからToken発行・検証までを追い、根拠となるFile pathとSymbol名を示してください。
確認できない挙動は推測せず、未確認として列挙してください。
最後に再現TestのCommand案を出してください。注意点・よくあるエラーと対処法
RepositoryがMonorepoの場合、追加DirectoryへAccessを許可しないと依存先を見落とします。
必要なら--add-dirを使いますが、読み込むMemory fileの範囲にも注意してください。
解析結果をそのまま仕様書とせず、実行結果、Test、担当者への確認で裏付けます。