ECC — система оптимизации AI-агентов для мульти-харнес разработки
📂 Исходный код на GitHubОператорная система для оптимизации AI-агентов с навыками, инстинктами, памятью, безопасностью и research-first разработкой. Поддерживает Claude Code, Codex, OpenCode, Cursor, Gemini, Zed и GitHub Copilot.
ECC (Evolved Context Harness) — это операторная система для оптимизации работы AI-агентов в харнесах разработки. Проект объединяет навыки, инстинкты, память, непрерывное обучение, безопасность и research-first подход к разработке. Более 10 месяцев ежедневного использования в реальных продуктах легли в основу production-ready решения с 63 агентами, 251 навыком и 79 командами.
Система работает через 7 AI-харнесов: Claude Code, OpenAI Codex, Cursor, OpenCode, Gemini, Zed и GitHub Copilot. ECC не просто набор конфигураций — это полноценная экосистема для агентной разработки.
Архитектура
ECC построен как плагин для Claude Code с возможностью ручной установки. Основные компоненты:
- Agents — 63 специализированных сабагента для делегирования задач: планировщик, архитектор, TDD-гайд, ревьюер кода, анализатор безопасности, резолвер ошибок сборки для 12+ языков
- Skills — 251 навык для workflow и domain-знаний: от coding standards и backend-паттернов до Django, Laravel, Spring Boot, Go, C++, Rust и ML-пайплайнов
- Commands — 79 слеш-команд (устаревающий слой, миграция на skills), включая
/plan,/code-review,/build-fix,/security-scan - Rules — always-follow гайдлайны, организованные по языкам:
common/,typescript/,python/,golang/,swift/,php/,arkts/ - Hooks — триггерные автоматизации на события инструментов: memory persistence, strategic compact, session lifecycle
- Contexts — динамические инъекции в системный промпт для режимов dev/review/research
Ключевые возможности
Токенная оптимизация
Выбор модели, сжатие системных промптов, фоновые процессы — всё направлено на эффективное использование контекстного окна. Hook runtime позволяет управлять объёмом контекста через переменные окружения:
export ECC_HOOK_PROFILE=standard
export ECC_SESSION_START_MAX_CHARS=4000
export ECC_CONTEXT_MONITOR_COST_WARNINGS=off
Memory Persistence
Хуки автоматически сохраняют и загружают контекст между сессиями. SessionStart загружает накопленный контекст, SessionEnd — сохраняет состояние сессии.
Непрерывное обучение (Continuous Learning v2)
Система инстинктов с confidence scoring: паттерны автоматически извлекаются из сессий и становятся reusable-навыками:
/instinct-status # Показать изученные инстинкты
/instinct-import <file> # Импорт инстинктов
/instinct-export # Экспорт для обмена
/evolve # Кластеризация инстинктов в навыки
AgentShield — аудит безопасности
Отдельный инструмент для сканирования конфигурации Claude Code на уязвимости: 1282 теста, 102 правила статического анализа, 5 категорий (secrets detection, permission auditing, hook injection, MCP risk profiling, agent config review). Флаг --opus запускает red-team/blue-team/auditor пайплайн на трёх агентах Claude Opus.
npx ecc-agentshield scan # Быстрое сканирование
npx ecc-agentshield scan --fix # Авто-фикс безопасных проблем
npx ecc-agentshield scan --opus # Глубокий анализ с Opus
Dashboard GUI
Tkinter-приложение для визуального исследования компонентов ECC: табы Agents/Skills/Commands/Rules/Settings, переключение dark/light темы, настройка шрифтов, поиск и фильтрация.
npm run dashboard
# или
python3 ./ecc_dashboard.py
Установка
Рекомендуемый путь — установка как плагин 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
Для минимальной установки без hooks:
./install.sh --profile minimal --target claude
Важно: не комбинируйте методы установки. Либо плагин, либо ручной инсталлер — не оба одновременно.
Для подбора нужных компонентов можно использовать консультант:
npx ecc consult "security reviews" --target claude
Мульти-язычная поддержка
Правила (rules) организованы по языковым экосистемам:
| Язык | Что включено |
|---|---|
| TypeScript/JS | Паттерны, инструменты, стиль |
| Python | Идиомы, pytest, Django, ML |
| Go | Паттерны, тестирование, бенчмарки |
| Swift | Actors, concurrency, DI |
| PHP | Laravel-паттерны |
| Java | Spring Boot, Quarkus, JPA |
| Kotlin | Android, KMP |
| C++ | Coding standards, GoogleTest |
| Rust | Паттерны, тестирование |
| Perl | Modern Perl, taint mode |
| ArkTS | HarmonyOS |
Skill Creator
Генерация навыков из git-истории репозитория двумя способами:
- Локальный анализ — команда
/skill-createанализирует коммиты и генерирует SKILL.md - GitHub App — для продвинутых кейсов: 10K+ коммитов, auto-PRs, командный доступ
Версии
- v2.0.0-rc.1 — Dashboard GUI, Hermes operator, ECC 2.0 alpha на Rust, operator workflows
- v1.9.0 — Selective install, 6 новых агентов, SQLite state store, 12 языковых экосистем
- v1.8.0 — Рефрейминг как harness performance system, hook reliability overhaul, NanoClaw v2
- v1.7.0 — Codex app/CLI, frontend-slides skill, бизнес-навыки
- v1.6.0 — AgentShield, GitHub Marketplace, 30+ community PRs
- v1.3.0 — Полная интеграция с OpenCode
Технические детали
- Лицензия: MIT
- Языки: TypeScript, Python, Go, Shell
- Звёзды: 182K+
- Форки: 28K+
- Контрибьюторы: 170+
- npm-пакеты:
ecc-universal,ecc-agentshield - GitHub App: ecc-tools
Репозиторий: https://github.com/affaan-m/ECC
Источник: https://github.com/affaan-m/ECC