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 엔진에 의해 처리되어 다음 세 가지 유형의 아티팩트를 추출합니다:

  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: 세션 히스토리를 탐색하고 학습된 스킬 및 설정을 편집할 수 있는 웹 UI(localhost:3001)를 제공합니다.