codebase-onboarding

name	codebase-onboarding
description	Analyze an unfamiliar codebase and generate a structured onboarding guide with architecture map, key entry points, conventions, and a starter CLAUDE.md. Use when joining a new project or setting up Claude Code for the first time in a repo.
origin	ECC

Codebase Onboarding

不慣れなコードベースを体系的に分析し、構造化されたオンボーディングガイドを生成します。新しいプロジェクトに参加する開発者や、既存のリポジトリで初めて Claude Code をセットアップする場合に設計されています。

使用タイミング

• プロジェクトで初めて Claude Code を開く場合
• 新しいチームやリポジトリに参加する場合
• ユーザーが「このコードベースを理解する手助けをして」と依頼した場合
• ユーザーがプロジェクト用の CLAUDE.md の生成を依頼した場合
• ユーザーが「オンボーディングして」「このリポジトリを案内して」と言った場合

仕組み

フェーズ 1: Reconnaissance

すべてのファイルを読まずに、プロジェクトに関する生のシグナルを収集します。以下のチェックを並列で実行します：

1. パッケージマニフェストの検出
   → package.json, go.mod, Cargo.toml, pyproject.toml, pom.xml, build.gradle,
     Gemfile, composer.json, mix.exs, pubspec.yaml

2. フレームワークのフィンガープリンティング
   → next.config.*, nuxt.config.*, angular.json, vite.config.*,
     django settings, flask app factory, fastapi main, rails config

3. エントリポイントの特定
   → main.*, index.*, app.*, server.*, cmd/, src/main/

4. ディレクトリ構造のスナップショット
   → ディレクトリツリーの上位2階層（node_modules, vendor,
     .git, dist, build, __pycache__, .next は除外）

5. 設定・ツールの検出
   → .eslintrc*, .prettierrc*, tsconfig.json, Makefile, Dockerfile,
     docker-compose*, .github/workflows/, .env.example, CI 設定

6. テスト構造の検出
   → tests/, test/, __tests__/, *_test.go, *.spec.ts, *.test.js,
     pytest.ini, jest.config.*, vitest.config.*

フェーズ 2: Architecture Mapping

偵察データから以下を特定します：

技術スタック

• 言語とバージョン制約
• フレームワークと主要ライブラリ
• データベースと ORM
• ビルドツールとバンドラー
• CI/CD プラットフォーム