🧠 Что это

Continuous Learning V2 (Instinct System) — это система непрерывного обучения для Claude Code, которая автоматически извлекает повторяющиеся паттерны из ваших сессий и превращает их в атомарные «инстинкты» — маленькие, взвешенные по уверенности правила поведения.

Система работает через детерминированные хуки (100% срабатывание), а не вероятностные скиллы, что гарантирует полный захват всех инструментальных вызовов.

Ключевое нововведение v2.1 — проектный скоуп: инстинкты, специфичные для React-проекта, остаются внутри него, а универсальные (например, «всегда проверять входные данные») попадают в глобальное хранилище. Это решает проблему кросс-проектного загрязнения, когда паттерны одного проекта бесконтрольно применяются к другому.

⚙️ Как работает

🔍 Наблюдение и захват

Хуки PreToolUse и PostToolUse перехватывают каждый вызов инструмента в сессии. Наблюдения записываются в файл observations.jsonl внутри проекта (~/.claude/homunculus/projects/hash/observations.jsonl).

Идентификация проекта происходит автоматически: проверяется CLAUDE_PROJECT_DIR, затем git remote get-url origin (хэшируется для портируемости между машинами), и наконец путь к репозиторию. Если проект не обнаружен — инстинкт создаётся как глобальный.

🧬 Анализ и создание инстинктов

Фоновый агент (на базе Haiku от Anthropic) периодически сканирует накопленные наблюдения и выявляет паттерны:

• Исправления пользователя → инстинкт «предпочитать такой-то стиль»
• Повторяющиеся рабочие процессы → инстинкт «всегда выполнять шаги A, B, C»
• Сходные ошибки → инстинкт «проверять граничные условия»

Каждый инстинкт — это YAML-файл с полями:

• id — уникальный идентификатор (например, prefer-functional-style)
• trigger — условие срабатывания
• confidence — оценка уверенности от 0.3 до 0.9
• domain — область (code-style, testing, git, workflow)
• scope — project или global
• project_id / project_name — для проектных инстинктов
• Секция Evidence — на каких наблюдениях он основан

📊 Шкала уверенности (Confidence Score)

Уверенность растёт при повторении паттерна, отсутствии исправлений или согласованности с другими инстинктами. Падает при явных исправлениях или долгом отсутствии паттерна.

🚀 Эволюция: из инстинктов в команды, скиллы и агентов

Команда /evolve кластеризует связанные инстинкты и превращает их в полноценные артефакты:

• Commands — одношаговые CLI-команды (new-feature, fix-bug)
• Skills — описание рабочего процесса с несколькими шагами (testing-workflow)
• Agents — специализированные агенты для задач (refactor-specialist)

Сгенерированные артефакты сохраняются в ~/.claude/homunculus/evolved/{agents,skills,commands}/ (или внутри проекта).

🆕 Проектный скоуп и продвижение (v2.1)

Система автоматически определяет область действия инстинкта:

• Проектный скоуп — для специфичных языковых/фреймворковых конвенций, стиля кода, структуры файлов, стратегий обработки ошибок.
• Глобальный скоуп — для универсальных практик: безопасность, тестирование, git-рабочий процесс.

Когда один и тот же инстинкт с высокой уверенностью (>=0.8) появляется в двух и более проектах, он кандидат на автоматическое продвижение в глобальный скоуп.

Команда /promote [id] (или --dry-run для предпросмотра) выполняет продвижение вручную, команда /projects показывает все проекты и количество инстинктов в каждом.

🔧 Команды и CLI

✅ Когда использовать

• Онбординг в новый проект: система быстро выучит принятые в команде конвенции и не даст их нарушать.
• Работа с разнородными проектами: вы избегаете кросс-проектного загрязнения — ваш Python-проект не замусорится React-паттернами.
• Стандартизация workflows: если вы часто повторяете одни и те же команды (например, grep → edit → test), система автоматически предложит команду /evolve.
• Обучение агента: из цепочки действий, которые вы часто делаете руками, система может сгенерировать специализированного агента.
• Дегустация паттернов сообщества: через /instinct-import вы можете импортировать инстинкты от коллег или из публичных репозиториев.

❗ Важно знать

• Данные локальны: все наблюдения хранятся локально, в ~/.claude/homunculus/. Никакой код или содержимое диалогов не передаются вовне.
• Только инстинкты экспортируются: при экспорте вы делитесь именно абстрактными паттернами, а не сырыми данными.
• Требуется инициализация в settings.json: необходимо добавить хуки в ~/.claude/settings.json, как показано в документации по быстрому старту.
• Обратная совместимость: v2.1 полностью совместима с v2.0 и v1 — глобальные инстинкты и скиллы из прошлых версий продолжают работать. Можно мигрировать постепенно.
• Фоновый анализатор отключён по умолчанию: включите его в config.json (observer.enabled: true) и настройте интервал проверки (run_interval_minutes) и минимальное количество наблюдений для анализа (min_observations_to_analyze).

💻 Пример настройки хуков (плагин)

# Добавьте в ~/.claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/hooks/observe.sh"
          }
        ]
      }
    ]
  }
}

Синхронизируйте навыки с Claude Cowork, Claude Code, Codex и другими.

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code continuous-learning-v2