SuperClaude/docs/Development/architecture-overview.md

アーキテクチャ概要

プロジェクト構造

メインパッケージ（superclaude/）

superclaude/
├── __init__.py           # パッケージ初期化
├── __main__.py           # CLIエントリーポイント
├── core/                 # コア機能
├── modes/                # 行動モード（7種類）
│   ├── Brainstorming     # 要件探索
│   ├── Business_Panel    # ビジネス分析
│   ├── DeepResearch      # 深層研究
│   ├── Introspection     # 内省分析
│   ├── Orchestration     # ツール調整
│   ├── Task_Management   # タスク管理
│   └── Token_Efficiency  # トークン効率化
├── agents/               # 専門エージェント（16種類）
├── mcp/                  # MCPサーバー統合（8種類）
├── commands/             # スラッシュコマンド（26種類）
└── examples/             # 使用例

セットアップパッケージ（setup/）

setup/
├── __init__.py
├── core/                 # インストーラーコア
├── utils/                # ユーティリティ関数
├── cli/                  # CLIインターフェース
├── components/           # インストール可能コンポーネント
│   ├── agents.py        # エージェント設定
│   ├── mcp.py           # MCPサーバー設定
│   └── ...
├── data/                 # 設定データ（JSON/YAML）
└── services/             # サービスロジック

主要コンポーネント

CLIエントリーポイント（main.py）

• main(): メインエントリーポイント
• create_parser(): 引数パーサー作成
• register_operation_parsers(): サブコマンド登録
• setup_global_environment(): グローバル環境設定
• display_*(): ユーザーインターフェース関数

インストールシステム

• コンポーネントベース: モジュラー設計
• フォールバック機能: レガシーサポート
• 設定管理: ~/.claude/ ディレクトリ
• MCPサーバー: Node.js統合

デザインパターン

責任の分離

• setup/: インストールとコンポーネント管理
• superclaude/: ランタイム機能と動作
• tests/: テストとバリデーション
• docs/: ドキュメントとガイド

プラグインアーキテクチャ

• モジュラーコンポーネントシステム
• 動的ロードと登録
• 拡張可能な設計

設定ファイル階層

1. ~/.claude/CLAUDE.md - グローバルユーザー設定
2. プロジェクト固有 CLAUDE.md - プロジェクト設定
3. ~/.claude/.claude.json - Claude Code設定
4. MCPサーバー設定ファイル

統合ポイント

Claude Code統合

• スラッシュコマンド注入
• 行動指示インジェクション
• セッション永続化

MCPサーバー

1. Context7: ライブラリドキュメント
2. Sequential: 複雑な分析
3. Magic: UIコンポーネント生成
4. Playwright: ブラウザテスト
5. Morphllm: 一括変換
6. Serena: セッション永続化
7. Tavily: Web検索
8. Chrome DevTools: パフォーマンス分析

拡張ポイント

新規コンポーネント追加

1. setup/components/ に実装
2. setup/data/ に設定追加
3. テストを tests/ に追加
4. ドキュメントを docs/ に追加

新規エージェント追加

1. トリガーキーワード定義
2. 機能説明作成
3. 統合テスト追加
4. ユーザーガイド更新