claude-reflect

Установка

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

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Плагин работает в два этапа. Хуки на каждом запросе распознают поправки вроде «нет, используй X» и одобрение, и складывают их в очередь. Команда /reflect показывает очередь, и после вашего подтверждения переносит правила в глобальный или проектный CLAUDE.md, CLAUDE.local.md, файлы правил или в сами скиллы. Команда /reflect-skills анализирует историю сессий, находит повторяющиеся задачи и предлагает превратить их в команды. Можно просканировать прошлые сессии, найти дубли в CLAUDE.md и посмотреть изменения без применения.

Для кого. Для тех, кто много работает в Claude Code и устал повторять агенту одни и те же поправки.

Пример запроса к агенту

/reflect --dry-run

Ограничения

Работает только в Claude Code, нужен Python 3.6 или новее и перезапуск после установки. Распознавание поправок по шаблонам может пропускать или путать реплики, поэтому применение идет через ручное подтверждение. Анализ истории тратит токены модели.

Как отключить. Удалите плагин командой claude plugin uninstall claude-reflect и при желании файл очереди ~/.claude/learnings-queue.json.

Проверка безопасности

• Хуки на Python запускаются на каждом запросе и читают историю сессий
• Плагин меняет файлы инструкций агента

Коротко о README

README описывает две функции: память из поправок и поиск повторяющихся сценариев в истории. Установка через маркетплейс плагинов Claude Code, после нее нужен перезапуск. Приведены все команды и флаги, хуки и их триггеры, гибридный способ распознавания через регулярные выражения и модель, а также список файлов, куда пишутся правила. Поддерживаются macOS, Linux и Windows. Лицензия MIT.

SKILL.md

---
name: claude-reflect
description: Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md. Use when discussing learnings, corrections, or when the user mentions remembering something for future sessions.
---

# Claude Reflect - Self-Learning System

A two-stage system that helps Claude Code learn from user corrections.

## How It Works

**Stage 1: Capture (Automatic)**
Hooks detect correction patterns ("no, use X", "actually...", "use X not Y") and queue them to `~/.claude/learnings-queue.json`.

**Stage 2: Process (Manual)**
User runs `/reflect` to review and apply queued learnings to CLAUDE.md files.

## Available Commands

| Command | Purpose |
|---------|---------|
| `/reflect` | Process queued learnings with human review |
| `/reflect --scan-history` | Scan past sessions for missed learnings |
| `/reflect --dry-run` | Preview changes without applying |
| `/reflect-skills` | Discover skill candidates from repeating patterns |
| `/skip-reflect` | Discard all queued learnings |
| `/view-queue` | View pending learnings without processing |

## When to Remind Users

Remind users about `/reflect` when:
- They complete a feature or meaningful work unit
- They make corrections you should remember for future sessions
- They explicitly say "remember this" or similar
- Context is about to compact and queue has items

## Correction Detection Patterns

High-confidence corrections:
- Tool rejections (user stops an action with guidance)
- "no, use X" / "don't use Y"
- "actually..." / "I meant..."
- "use X not Y" / "X instead of Y"
- "remember:" (explicit marker)

Похожие