claude-reflect: система самообучения для Claude Code

· 1 мин чтения
claude-code memory self-learning context-engineering productivity
📂 Исходный код на GitHub

Система самообучения для Claude Code, которая запоминает коррекции и паттерны рабочего процесса, синхронизируя их в CLAUDE.md и AGENTS.md.

claude-reflect: система самообучения для Claude Code

claude-reflect — плагин для Claude Code, который превращает временные коррекции в постоянную память. Каждый раз, когда вы поправляете Claude («нет, используй gpt-5.1, а не gpt-5»), система запоминает это и синхронизирует в CLAUDE.md. Со временем Claude учится из ваших замечаний и работает точнее.

Как работает

Процесс состоит из двух этапов: автоматический захват и ручная обработка.

Автоматический захват

Хуки работают в фоне, отслеживая каждый промпт:

Хук Триггер Зачем
session_start_reminder.py Начало сессии Напоминает о queued learnings
capture_learning.py Каждый промпт Детектит паттерны коррекций
check_learnings.py До compaction Бэкапит очередь
post_commit_reminder.py После git commit Напоминает запустить /reflect

Ручная обработка

Запускаете /reflect — Claude показывает таблицу с вариантами:

  • Apply — принять и добавить в CLAUDE.md
  • Edit before applying — отредактировать текст
  • Skip — пропустить

Обнаружение коррекций

Гибридный подход из двух методов:

Regex-паттерны (реалтайм): ловят фразы вроде "no, use X", "don't use Y", "actually...", "remember:".

Семантический AI-фильтр (при /reflect): понимает коррекции на любом языке, отсеивает false positives, извлекает/actionable statements.

Каждое обучение получает confidence score (0.60–0.95), итоговый — максимум regex и semantic.

Синхронизация

Одобрённые коррекции попадают сразу в несколько мест:

  • ~/.claude/CLAUDE.md (глобально)
  • ./CLAUDE.md (проект)
  • ./**/CLAUDE.md (поддиректории)
  • ./.claude/commands/*.md (если коррекция связана со скиллом)
  • AGENTS.md (совместимость с Codex, Cursor, Aider, Jules, Zed, Factory)

Открытие скиллов

Команда /reflect-skills анализирует историю сессий и находит повторяющиеся задачи, которые могут стать переиспользуемыми командами:

/reflect-skills                 # Текущий проект (14 дней)
/reflect-skills --days 30       # Последние 30 дней
/reflect-skills --all-projects  # Все проекты
/reflect-skills --dry-run       # Превью без генерации файлов

Система.semantic similarity — разные формулировки одного намерения объединяются. Пример: «review my productivity», «how was my focus», «check ActivityWatch data» → кандидат на /daily-review.

Сгенерированные скиллы создаются в .claude/commands/ с описанием, списком шагов и guardrails.

Улучшение скиллов

Когда вы корректируете Claude во время использования скилла (например, /deploy), коррекция автоматически маршрутизируется обратно в файл скилла — и команда становится умнее со временем.

Дополнительные возможности

  • Исторический скан — /reflect --scan-history проходит по всем прошлым сессиям
  • Дедупликация — /reflect --dedupe находит и консолидирует похожие записи
  • Умная фильтрация — отсеивает вопросы, одноразовые инструкции, контекстные запросы
  • Поддержка всех платформ — macOS, Linux, Windows

Установка

claude plugin marketplace add bayramannakov/claude-reflect
claude plugin install claude-reflect@claude-reflect-marketplace

После установки нужно перезапустить Claude Code. Хуки настраиваются автоматически.

Источник: https://github.com/BayramAnnakov/claude-reflect

Похожие материалы