ECC — система оптимизации AI-агентов для мульти-харнес разработки

ECC (Evolved Context Harness) — операционная система для AI-харнесов разработки. Проект вырос из ежедневного использования Claude Code в нескольких production-приложениях и собрал вокруг себя навыки, инстинкты, память, непрерывное обучение, безопасность и research-first подход. Сегодня это 68 агентов, 292 навыка и 94 поддерживаемые команды-шима.

Система работает поверх десятка AI-харнесов: Claude Code, OpenAI Codex, Kimi Code, Cursor, OpenCode, GitHub Copilot, а также Gemini, Zed, Antigravity, Qwen, Hermes, OpenClaw, CodeBuddy и JoyCode. Корень репозитория — источник истины, платформенные адаптеры пакуют одни и те же workflow, а не ведут отдельные копии.

Архитектура

Основные компоненты:

• Agents — 68 специализированных сабагентов для делегирования задач: планировщик, архитектор, TDD-гайд, ревьюер кода, анализатор безопасности, резолверы ошибок сборки под Rust, C++, Go, Java и Kotlin, плюс отдельные ревьюеры под F#, Python, TypeScript, базы данных и продакшн-ML
• Skills — 292 навыка для workflow и доменных знаний: TDD, security-review, research-first, verification loop, документы, фронтенд, данные, ML, эксплуатация
• Commands — 94 слеш-команды как точки входа и шимы совместимости, пока проект мигрирует на skills-first поверхность; новые workflow пишутся сначала в skills/, а вышедшие из строя короткие шимы переехали в legacy-command-shims/
• Rules — always-follow гайдлайны, организованные по языкам: common/, typescript/, python/, golang/, swift/, php/, arkts/
• Hooks — триггерные автоматизации на события инструментов: memory persistence, strategic compact, session lifecycle, GateGuard перед деструктивными shell-командами
• Contexts — динамические инъекции в системный промпт для режимов dev, review и research

Ключевые возможности

Memory Vault — общий контекст между харнесами

Единый локальный формат ecc.memory.v1 (Markdown) для долговременного контекста и хендоверов между Claude, Codex, Hermes, Kimi и другими агентами. Проектные памяти живут в .ecc/memory/ под fail-closed .gitignore, пользовательские — в ~/.ecc/memory/. Формат намеренно не копирует транскрипты вендоров: это переносимый документ, который можно прочитать глазами. npm-рантайм ставится отдельно:

npm install -g ecc-universal
ecc memory init --scope project
ecc memory handoff --from hermes --target codex \
  --title "Continue authentication migration" --body-file ./handoff.md
ecc memory search "authentication migration" --target-harness codex
ecc memory doctor

Тела записей принимаются только через --stdin или --body-file, но не аргументом командной строки. Первая версия держит каждую запись в режиме create-only: человеческая проверка переносит принятые знания в управляемую документацию проекта, а не повышает доверие к памяти. Важное ограничение доверия: память — это непроверенный контекст, а не исполняемая политика, поэтому агенты обязаны сверять важные утверждения с авторитетными источниками. Опциональный ecc-memory-mcp открывает только save, search, read и doctor, требует явной идентификации харнеса через ECC_MEMORY_HARNESS и не даёт доступ к user scope без ECC_MEMORY_ALLOW_USER_SCOPE=1.

Непрерывное обучение (Continuous Learning v2)

Система инстинктов с confidence scoring: паттерны извлекаются из реальных сессий и превращаются в переиспользуемые навыки.

/instinct-status        # Показать изученные инстинкты
/instinct-import <file> # Импорт инстинктов
/instinct-export        # Экспорт для обмена
/evolve                 # Кластеризация инстинктов в навыки

Инстинкты ранжируются по уверенности плюс релевантность проекту и стеку, поэтому паттерн по Terraform всплывает выше постороннего, но более уверенного.

AgentShield — аудит безопасности

Сканер конфигурации агента на уязвимости: 1282 теста, 98% покрытия, 102 правила статического анализа, 5 категорий — secrets detection, permission auditing, hook injection, MCP risk profiling и agent config review. Флаг --opus запускает red-team/blue-team/auditor пайплайн на трёх агентах Claude Opus 4.6: атакующий ищет цепочки эксплуатации, защитник оценивает меры, аудитор сводит всё в приоритизированную оценку рисков. Проект требует установленный и проверенный бинарник — скачивание одноразовых скриптов не рекомендуется:

agentshield scan --path .          # Быстрое сканирование
agentshield scan --path . --fix    # Авто-фикс безопасных проблем
agentshield scan --path . --opus --stream
agentshield init                   # Сгенерировать безопасный конфиг с нуля

Выход — терминал с оценкой от A до F, JSON, Markdown и HTML; код выхода 2 на критических находках, поэтому сканер можно ставить в build-гейты. Есть отдельный GitHub Action для CI.

Dashboard GUI

Tkinter-приложение для визуального исследования компонентов ECC: табы Agents/Skills/Commands/Rules/Settings, переключение dark/light темы, настройка шрифтов, поиск и фильтрация.

npm run dashboard
# или
python3 ./ecc_dashboard.py

Установка

Главное изменение последних релизов — guided setup. Вместо ручного клонирования и подбора профиля мастер сам инвентаризирует маркетплейс и все нативные scope Claude Code, показывает план файлов и только потом пишет на диск:

npx ecc-universal setup

Мастер понимает npm, pnpm, Yarn и Bun, а ./install.sh и install.ps1 остаются для Windows и оффлайн-сценариев. Чтобы настроить сразу несколько харнесов в одном ревью-проходе:

npx ecc-universal install --guided

Для Codex нативный путь выглядит так:

codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc

Альтернатива для Claude Code — нативные команды плагина:

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Или полностью ручная установка из чекаута:

git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile full

Требуется Node.js 18+ и Claude Code CLI v2.1.0+. Важно: не комбинируйте методы установки — дублирование вызывает двойное срабатывание хуков. Начиная с Claude Code v2.1 плагинные хуки загружаются автоматически, и явное объявление hooks в plugin.json вызывает ошибку дублирования. Плагины Claude Code не умеют распространять rules, поэтому нужные языковые паки копируются в ~/.claude/rules/ecc/ вручную.

Поддержка харнесов и платформ

Ядро на Node.js работает на Windows, macOS и Linux, но часть опциональных возможностей (continuous learning, GAN-пути, оркестрация) требует Bash или Python.

Что нового в ветке 2.2

• Guided setup — установка по манифесту с учётом владения файлами, а также doctor, repair и uninstall для Claude Code, Codex и Kimi Code
• Antigravity 2.0 — нативная установка в .agents/: правила, workflow, навыки и адаптированные агенты
• Plan Canvas — ревью плана прямо в браузере
• Единое хранилище памяти — ecc memory вместо разрозненных реализаций
• Itô compute — семейство навыков для self-hosted моделей и CLI-моста ecc ito к GPU-контенту
• Политика MCP-коннекторов — дефолтный набор сокращён до единственного коннектора chrome-devtools, шесть прежних выведены из дефолта по итогам аудита июня 2026

Мульти-язычная поддержка

• TypeScript и JavaScript — coding standards, frontend- и backend-паттерны
• Python — идиомы, pytest, Django: паттерны, security, TDD, верификация
• Go — идиомы, тестирование, бенчмарки
• Rust, C++, Kotlin, Java, F# — отдельные ревью-агенты и резолверы ошибок сборки
• PHP, Laravel, Rails, Spring Boot, Quarkus, JPA — фреймворковые навыки с security и TDD
• Perl — Modern Perl 5.36+, security с taint mode, тесты на Test2::V0
• Swift — actors, approachable concurrency 6.2, протокольная DI, дизайн-система Liquid Glass
• ArkTS и HarmonyOS — отдельный агент и правила
• ML — mle-workflow и mle-reviewer: data contracts, evals, деплой, мониторинг

Skill Creator

Генерация навыков из git-истории репозитория двумя способами:

• Локальный анализ — команда /skill-create разбирает коммиты и генерирует SKILL.md, а флаг --instincts дополнительно собирает инстинкты для continuous-learning-v2
• GitHub App — для продвинутых кейсов: репозитории от 10K коммитов, auto-PRs, командный доступ и приватные репозитории

Технические детали

• Лицензия: MIT
• Звёзды: 268K+ (267 682 на момент проверки)
• Форки: 40K+ (39 983)
• Контрибьюторы: 380+
• npm-пакеты: ecc-universal, ecc-agentshield
• GitHub App: ecc-tools, приватные репозитории от $19 за место в месяц
• Сайт: ecc.tools
• Сообщество: Discord
• Гайды: Shorthand, Longform, Security и CHANGELOG

OSS остаётся бесплатным, а работу финансируют спонсоры и подписчики ECC Pro — поэтому один мейнтейнер выпускает релизы еженедельно сразу по семи харнесам. Авторы предупреждают: ставьте ECC только из официальных источников — сторонние зеркала не проверяются и могут содержать малварь.