bluecore

bluecore

Claude Code 向けの汎用プラグイン集です。エージェント、スキル、コマンド、フック、永続メモリをひとまとめに導入し、計画・実装・検証・レビューの流れを揃えます。

これは何か

bluecore は、Claude Code の作業を「最初の計画からレビューまで」通して支えるプラグインです。 ユーザープロジェクトの言語ランタイムに依存せず、必要なときだけ個別のツールやコマンドを使います。

---

想定読者

本 README は bluecore プラグインを Claude Code に導入する開発者 向けです。

• Claude Code 自体の基本操作（プロンプト送信、ファイル編集の許可など）は前提とします。
• Claude Code がまだの場合は、まず公式の Claude Code を導入してから本プラグインを使ってください。
• 初心者は WF-2（バグ修正） から試すと最も簡単で、効果を体感しやすいです。

---

特長

項目	内容
Agents	計画、レビュー、TDD、セキュリティ、性能、探索などの専門サブエージェント
Skills	ワークフローや運用知識を段階的に案内
Commands	定番作業をすぐ呼び出し
Hooks	ツール実行の前後に自動チェックや記録を実行
Memory	セッション履歴とチーム共有メモリを保持

---

用語

5つの要素を理解すれば bluecore の全フローが追えます。

用語	種別	起動方法	例
Command	ユーザーが明示的に呼ぶ	/<name> [args]	/plan, /review, /feat-dev
Agent	内部から委譲される専門家	コマンド / skill から Task ツール経由で subagent_type 指定起動	reviewer, architect, tdd-writer
Skill	条件発火 or 委譲先の知識モジュール	description マッチで Claude Code が自動起動 / fork コンテキストで委譲	grillme, tdd, skill-make
Instinct	観測から学習したパターン	SessionStart で <mem-context> として自動注入	/instinct で管理
Hook	ツール実行時に自動発火するスクリプト	hooks.json 登録 → Claude Code が呼ぶ	PreToolUse, SessionStart, SessionEnd

ざっくりまとめると: ユーザーは Command だけを覚えれば OK。Command が内部で必要な Agent / Skill を自動で連れてきます。Instinct と Hook はバックグラウンドで動く仕組みです。

---

クイックスタート

プラグインマーケットプレイス

claude plugin marketplace add aokumablue/bluecore
claude plugin install bluecore@bluecore

インストール後、まず試すなら:

/bugfix "ログイン時に 500 エラーが出る" src/auth/

---

設定

チーム同期を使う場合だけ、~/.bluecore/settings.json を以下のように設定します。

{
  "mem": {
    "sync": {
      "enabled": true,
      "postgres_url": "postgresql://bluecore:PASSWORD@localhost:5432/bluecore_mem"
    }
  }
}

mem.sync.enabled が false の場合は、ローカル利用のみで動きます。

---

🚀 Commands (10)

各コマンドの詳細はリンク先 .md ファイル参照。

コマンド	用途	引数	一言説明
/plan	実装前計画	[要件説明]	要件言い換え→リスク評価→段階的計画。コード前にユーザー確認
/feat-dev	新機能開発	[機能説明]	発見→探索→質問→設計→実装→レビュー の7段階一気通貫
/bugfix	バグ修正	[症状] [パス]	再現→原因分析→最小修正→回帰防止→レビュー の一気通貫
/refactor	リファクタリング	[パス] [--mode=simplify|clean]	clean→simplify→perf→review の安全な自動連鎖。--mode で部分実行
/review	コードレビュー	[パス]（省略=差分）	reviewer + security-auditor 並列。READ-ONLY 完全保証
/harness	品質管理	[scope] [--audit-only] [--format=text|json]	スコア取得→harness-tuner で改善→再採点
/skill-gen	スキル作成	[--commits=N] [--output=path] [--instincts]	入力収集→skill-make→skill-tune→grader/comparator/bench-analyzer 評価
/instinct	インスティンクト管理	<export|import|promote|prune|evolve>	学習成果の昇格・削除・スキル化
/dashboard	利用率可視化	[--days=N] [--output=path] [--format=html|json]	個人(SQLite) と チーム(PostgreSQL) の使用率比較 HTML
/test-gen	テストコード自動生成	[パス]（省略=差分）	デシジョンテーブル設計→承認→実装。言語非依存

---

🧭 Workflows

bluecore が「どの場面でどう動くか」を 11 のワークフロー図で示します。各図には コマンド・エージェント・スキル・自動処理 が登場します。

凡例

WF 図で繰り返し使う色・線・記号の意味は以下で統一しています。

色	種別	役割
🔵 青 (#2563eb)	Command	ユーザーが明示的に呼ぶ
🟢 緑 (#059669)	Agent	内部から委譲される専門家
🟣 紫 (#7c3aed)	Skill / Hook	条件発火する知識モジュール
🟠 橙 (#ea580c)	自動処理	システム側で自動発火（SessionStart 等）
⬛ 灰 (#374151)	永続化ストア	SQLite / PostgreSQL

線種	意味
実線 -->	同期的呼び出し・必須遷移（処理が完了するまで次に進まない）
点線 -.->	任意・条件付き・並行参照（補助的に動く）
& 連結	並列実行（複数を同時に走らせて結果をマージ）
subgraph 枠	1つのコマンド内部の処理単位（外から見ると1コマンド）
菱形 {...}	条件分岐（YES/NO 判定）

初心者向けの読み方: まず 🔵 のコマンドだけ目で追えば「ユーザー操作の流れ」がわかります。🟢🟣 は気にしなくて OK。慣れてきたら subgraph の中を覗いてください。

---

WF-1: 新機能開発

flowchart LR
  classDef cmd    fill:#2563eb,stroke:#1e40af,color:#fff,rx:6
  classDef agent  fill:#059669,stroke:#047857,color:#fff,rx:6
  classDef skill  fill:#7c3aed,stroke:#6d28d9,color:#fff,rx:4
  classDef auto   fill:#ea580c,stroke:#c2410c,color:#fff,rx:4

  U(["👤 新機能依頼"]) --> CP["/plan"]:::cmd
  CP --> CF["/feat-dev"]:::cmd

  subgraph featdev["⚙️ feat-dev 内部（7ステップ）"]
    direction TB
    SG1["grillme"]:::skill -.-> AE
    AE["🔍 explorer × 3<br/>並列探索"]:::agent --> SG2["grillme<br/>質問確定"]:::skill
    SG2 --> AA["🏗️ architect<br/>決定モード"]:::agent
    AA & APO["⚡ perf-optimizer"]:::agent --> AT["🧪 tdd-writer<br/>RED→GREEN"]:::agent
    AT --> AR["✅ reviewer"]:::agent
    AT --> ASEC["🛡️ security-auditor"]:::agent
    SS["search"]:::skill -.-> AE
    SA["adr"]:::skill -.-> AA
  end

  CF --> featdev
  featdev --> CR["/review"]:::cmd
  CR --> CH["/harness<br/>--scope=hooks"]:::cmd