soyun9947/codebase-intel

codebase-intel は何をしますか？

プロジェクトの依存関係をマッピングし、コードベースの意図を文書化することで、AIエージェントに深いアーキテクチャコンテキストを提供します。

概要

codebase-intel スキルは、大規模または複雑なコードベースにおいて、AIエージェント（Claude Code、Cursor、Codexなど）がアーキテクチャを迅速に理解し、依存関係を正確に把握するのを支援します。これにより、エージェントはより正確なコード提案やリファクタリングが可能になります。

対象プラットフォーム

• Claude Code
• Cursor
• Codex
• その他のAIコードアシスタント

動作の仕組み

1. 依存関係のマッピング: プロジェクト内のモジュール間、パッケージ間、またはマイクロサービス間の依存関係を図式的に文書化します。
2. 意図の文書化: 各モジュールや関数の設計上の意図や、なぜ特定の設計選択がされたのかを説明します。
3. コンテキストの提供: AIエージェントがコード生成や変更提案を行う際に、影響範囲を特定しやすくするための情報を提供します。

設定方法

プロジェクトのルートディレクトリに、以下のような設定ファイル（例: codebase-intel.json）を作成します。

{
  "name": "my-project",
  "description": "マイクロサービスベースのEコマースプラットフォーム",
  "dependencies": {
    "user-service": {
      "path": "./services/user-service",
      "description": "ユーザー認証とプロファイル管理",
      "depends_on": ["database", "cache"]
    },
    "product-service": {
      "path": "./services/product-service",
      "description": "商品カタログと在庫管理",
      "depends_on": ["database"]
    },
    "database": {
      "path": "./infrastructure/database",
      "description": "PostgreSQLデータベース設定"
    },
    "cache": {
      "path": "./infrastructure/cache",
      "description": "Redisキャッシュ層"
    }
  },
  "architecture": {
    "description": "RESTful API + イベント駆動型アーキテクチャ",
    "decisions": [
      {
        "id": "ARCH-001",
        "title": "サービス分割戦略",
        "context": "ユーザー管理と商品管理は異なるチームが担当するため",
        "decision": "ユーザーサービスと商品サービスを独立したデプロイ可能なユニットとして分割する",
        "status": "承認済み"
      }
    ]
  }
}

使用方法

AIエージェントにプロジェクトの構造を尋ねるとき、以下のようなプロンプトを使用できます。

@codebase-intel このプロジェクトのアーキテクチャを説明してください。

または、変更提案を行う際に：

@codebase-intel user-serviceに新しいエンドポイントを追加する場合、どのサービスに影響が出ますか？

注意事項

• 設定ファイルはプロジェクトのルートディレクトリに配置してください。
• 依存関係の記述は循環参照を避けるように注意してください。
• 機密情報（パスワード、APIキーなど）は含めないでください。