02. リポジトリの全体像

このリポジトリの性質

重要な発見

このリポジトリは、実行可能なCLI本体のソースコードではありません。

Claude Code CLI本体: @anthropic-ai/claude-code というnpmパッケージとして配布（ソースコードは非公開）
このリポジトリ: 公式プラグイン集、サンプル、カスタムコマンドのコレクション

つまり、このリポジトリは：

✅ プラグインの実装例を学ぶためのサンプル集
✅ 公式プラグインのソースコード
✅ プラグイン開発のベストプラクティス
❌ CLI本体の実装コード

ディレクトリ構成

claude-code/
├── .claude/                      # プロジェクトレベルのClaude Code設定
│   ├── commands/                 # カスタムスラッシュコマンド
│   │   ├── commit-push-pr.md    # /commit-push-pr コマンド
│   │   ├── dedupe.md            # /dedupe コマンド
│   │   └── oncall-triage.md     # /oncall-triage コマンド
│   └── settings.local.json       # ローカル設定
│
├── .claude-plugin/               # プラグインマーケットプレイス設定
│   └── marketplace.json          # 全プラグインの中央レジストリ
│
├── .devcontainer/                # 開発環境（Docker）
│   ├── Dockerfile                # Node.js 20ベースの環境定義
│   └── devcontainer.json         # VS Code Dev Container設定
│
├── .github/                      # GitHub設定
│   ├── workflows/                # CI/CDワークフロー
│   └── ISSUE_TEMPLATE/           # Issueテンプレート
│
├── plugins/                      # ★ 公式プラグイン集（最重要）
│   ├── agent-sdk-dev/            # Agent SDK開発プラグイン
│   ├── code-review/              # 自動PRレビュー
│   ├── commit-commands/          # Gitワークフロー自動化
│   ├── explanatory-output-style/ # 教育的出力スタイル
│   ├── feature-dev/              # 機能開発ワークフロー
│   ├── frontend-design/          # フロントエンド設計
│   ├── learning-output-style/    # インタラクティブ学習モード
│   ├── pr-review-toolkit/        # PR包括的レビュー
│   ├── security-guidance/        # セキュリティリマインダー
│   └── README.md                 # プラグインシステム説明書
│
├── examples/                     # サンプルコード
│   └── hooks/                    # フックの実装例
│
├── scripts/                      # ユーティリティスクリプト
│
└── ドキュメント
    ├── README.md                 # メインドキュメント
    ├── CHANGELOG.md              # バージョン履歴
    ├── LICENSE.md                # ライセンス情報
    └── SECURITY.md               # セキュリティガイドライン

技術スタック

コンポーネント	技術
ランタイム	Node.js 20+
パッケージマネージャー	npm
言語	TypeScript（スクリプト用）、Markdown（プラグイン定義）
CLI本体	`@anthropic-ai/claude-code`（非公開）
開発環境	Docker + VS Code Dev Containers
連携ツール	Git、GitHub CLI (gh)、Python 3（フック用）
ドキュメント	Markdown

インストール方法

Claude Code CLI本体のインストール方法：

npm（Node.js 18+が必要）

npm install -g @anthropic-ai/claude-code

Homebrew（macOS）

brew install --cask claude-code

インストールスクリプト

# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows
irm https://claude.ai/install.ps1 | iex

公式プラグイン一覧

プラグイン	説明	主要機能
agent-sdk-dev	Agent SDK開発キット	`/new-sdk-app` コマンド、検証エージェント
commit-commands	Git操作の自動化	`/commit`, `/commit-push-pr`, `/clean_gone`
code-review	自動PRレビュー	`/code-review` コマンド、信頼度スコアリング
feature-dev	機能開発ワークフロー	7フェーズガイド、3つの専門エージェント
pr-review-toolkit	PR専門レビュー	6つの専門分析エージェント
security-guidance	セキュリティ警告	PreToolUseフック、パターン検出
explanatory-output-style	教育的出力	SessionStartフック
learning-output-style	学習モード	SessionStartフック
frontend-design	フロントエンド作成	プロダクショングレードUI生成

重要なファイル

必読ドキュメント

/README.md - プロジェクト全体の概要
/plugins/README.md - プラグインシステムの公式説明（最重要）
/CHANGELOG.md - 機能の進化履歴

設定ファイル

.claude-plugin/marketplace.json - プラグインの中央レジストリ
.claude/settings.local.json - プロジェクト固有の設定
plugins/*/plugin.json - 個別プラグインのメタデータ

開発環境

.devcontainer/devcontainer.json - Dev Container設定
.devcontainer/Dockerfile - Docker環境定義

モノレポ構成か？

いいえ、従来のモノレポではありません。

共有ビルドプロセスなし
プラグイン間の依存関係なし
各プラグインは独立して動作
プラグインコレクションリポジトリ

アーキテクチャパターン:

Claude Code CLI (npmパッケージ)
    ↓ ロード
プラグイン
    - ローカル .claude-plugin/
    - マーケットプレイスレジストリ
    - コミュニティリポジトリ

次のステップ

アーキテクチャと仕組み - Claude Codeの全体構造を理解
プラグインシステム詳解 - プラグインの構成要素を深く学ぶ