ReflexioAI/claude-smart

Turns corrections into Preferences, Project-specific skills, and Shared skills for Claude Code, Codex, and OpenCode.

What it solves

claude-smart は AI コーディングアシスタント（Claude Code、Codex、OpenCode）向けの自己改善プラグインで、アシスタントが同じミスを繰り返すのを防ぎます。単に履歴（メモリ）を記録するだけでなく、ユーザーの修正や成功パスから実行可能なルールと永続的なスキルを抽出し、将来のセッションで AI がそれらのルールに従うようにします。

How it works

プラグインはライフサイクルフックを利用して、すべてのユーザーターン、ツール呼び出し、アシスタントの応答をキャプチャします。これらのやり取りは reflexio エンジンで処理され、以下の 3 種類のアーティファクトが抽出されます。

  1. Preferences：プロジェクトスコープの設定（例："uses pnpm, not npm"）。
  2. Project-specific skills：特定リポジトリ内の修正から学習したルール（例："always pass --run to npm test"）。
  3. Shared skills：プロジェクト固有スキルから集約された一般パターンで、異なるプロジェクト間で再利用可能です。

これらのアーティファクトはローカルの SQLite データベースに保存され、プロセス内の ONNX embedder を用いたハイブリッド検索（ベクトル + BM25）で取得されます。関連するルールは新しいプロンプト時に AI のコンテキストに注入され、動作をガイドします。

Who it’s for

Claude Code、Codex、OpenCode を使用する開発者で、AI アシスタントにプロジェクト固有の癖やコーディング標準、修正を手動でドキュメントを更新したりプロンプトが肥大化したりせずに覚えてほしい方。

Highlights

  • Automatic Learning：やり取りからルールを抽出し、手動入力は不要です（ただし手動フラグ用に /claude-smart:learn コマンドも用意）。
  • Self-Tuning：新たな証拠が蓄積されるたびにルールを継続的に洗練・統合・アーカイブし、スキルライブラリを鋭く保ちます。
  • Local-First Privacy：埋め込みや設定を含むすべてのデータはユーザーのマシンにローカル保存され、セマンティック検索のための外部 API 呼び出しは行われません。
  • Management Dashboard：セッション履歴の閲覧や学習したスキル・設定の編集ができる Web UI（localhost:3001）を提供します。