**Система повышения эффективности для сред агентного ИИ. От победителя хакатона Anthropic.**
Не просто конфиги. Это полноценная система: навыки, инстинкты, оптимизация памяти, непрерывное обучение, сканирование безопасности и разработка с приоритетом исследований. Готовые к рабочему использованию агенты, навыки, хуки, правила, конфигурации MCP и устаревшие совместимые заглушки команд, отточенные за 10+ месяцев интенсивного ежедневного использования при создании реальных продуктов.
Работает в **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **Gemini** и других средах агентного ИИ.
ECC v2.0.0-rc.1 добавляет публичную историю оператора Hermes поверх этого переиспользуемого слоя: начните с [руководства по настройке Hermes](../HERMES-SETUP.md), затем прочитайте [примечания к выпуску rc.1](../releases/2.0.0-rc.1/release-notes.md) и [архитектуру для разных сред](../architecture/cross-harness.md).
---
## Руководства
В этом репозитории находится только исходный код. Руководства объясняют всё остальное.
| Оркестрация субагентов | Проблема контекста, паттерн итеративного извлечения |
---
## Что нового
### v2.0.0-rc.1 — Обновление публичного контура, операторские рабочие процессы и ECC 2.0 Alpha (апрель 2026)
- **Dashboard GUI** — новое настольное приложение на Tkinter (`ecc_dashboard.py` или `npm run dashboard`) с переключателем тёмной/светлой темы, настройкой шрифта и логотипом проекта в заголовке и панели задач.
- **Публичный контур синхронизирован с текущим репозиторием** — метаданные, счётчики каталога, манифесты плагинов и документация для установки теперь соответствуют реальному OSS-набору: 50 агентов, 185 навыков и 68 устаревших совместимых заглушек команд.
- **Расширение операторских и outbound-рабочих процессов** — `brand-voice`, `social-graph-ranker`, `connections-optimizer`, `customer-billing-ops`, `ecc-tools-cost-audit`, `google-workspace-ops`, `project-flow-ops` и `workspace-surface-audit` закрывают операторское направление.
- **Медиа и инструменты запуска** — `manim-video`, `remotion-video-creation` и обновлённые интерфейсы публикации в соцсетях делают технические объяснения и launch-контент частью той же системы.
- **Рост поддержки фреймворков и продуктов** — `nestjs-patterns`, более развитые пути установки для Codex/OpenCode и расширенная упаковка для разных сред сохраняют полезность репозитория не только для Claude Code.
- **ECC 2.0 alpha находится в дереве репозитория** — прототип control plane на Rust в `ecc2/` теперь собирается локально и предоставляет команды `dashboard`, `start`, `sessions`, `status`, `stop`, `resume` и `daemon`. Это пригодная к использованию alpha-версия, но ещё не общий релиз.
- **Укрепление экосистемы** — AgentShield, контроль затрат ECC Tools, работа над billing portal и обновления сайта продолжают поставляться вокруг основного плагина, а не расползаются по отдельным направлениям.
### v1.9.0 — Выборочная установка и расширение языковой поддержки (март 2026)
- **Архитектура выборочной установки** — установка на основе манифестов через `install-plan.js` и `install-apply.js` для точечной установки компонентов. Хранилище состояния отслеживает установленные компоненты и поддерживает инкрементальные обновления.
- **6 новых агентов** — `typescript-reviewer`, `pytorch-build-resolver`, `java-build-resolver`, `java-reviewer`, `kotlin-reviewer`, `kotlin-build-resolver` расширяют языковое покрытие до 10 языков.
- **Новые навыки** — `pytorch-patterns` для рабочих процессов глубокого обучения, `documentation-lookup` для исследования API-справочников, `bun-runtime` и `nextjs-turbopack` для современных JS-инструментов, а также 8 операционных предметных навыков и `mcp-server-patterns`.
- **Инфраструктура сессий и состояния** — SQLite-хранилище состояния с CLI для запросов, адаптеры сессий для структурированной записи, фундамент эволюции навыков для самоулучшающихся skills.
- **Переработка оркестрации** — оценка аудита среды стала детерминированной, статус оркестрации и совместимость launcher укреплены, предотвращение observer loops реализовано 5-уровневой защитой.
- **Надёжность observer** — исправление взрывного роста памяти через throttling и tail sampling, исправление доступа к песочнице, lazy-start логика и защита от повторного входа.
- **12 языковых экосистем** — новые правила для Java, PHP, Perl, Kotlin/Android/KMP, C++ и Rust добавлены к существующим правилам TypeScript, Python, Go и общим правилам.
- **Вклад сообщества** — переводы на корейский и китайский, оптимизация biome hook, навыки обработки видео, операционные навыки, PowerShell-установщик, поддержка Antigravity IDE.
- **Укрепление CI** — исправлены 19 падений тестов, добавлена принудительная проверка счётчиков каталога, валидация установочного манифеста, полный набор тестов проходит.
### v1.8.0 — Система повышения эффективности сред агентного ИИ (март 2026)
- **Релиз с фокусом на средах агентного ИИ** — ECC теперь явно позиционируется как система повышения эффективности таких сред, а не просто набор конфигов.
- **Переработка надёжности хуков** — fallback корня для SessionStart, сводки сессий в фазе Stop и скриптовые хуки вместо хрупких inline-однострочников.
- **Управление хуками во время выполнения** — `ECC_HOOK_PROFILE=minimal|standard|strict` и `ECC_DISABLED_HOOKS=...` для runtime-ограничений без редактирования файлов хуков.
- **Новые команды для сред** — `/harness-audit`, `/loop-start`, `/loop-status`, `/quality-gate`, `/model-route`.
- **Паритет между средами** — поведение ужесточено для Claude Code, Cursor, OpenCode и Codex app/CLI.
- **997 внутренних тестов проходят** — весь набор зелёный после рефакторинга hooks/runtime и обновлений совместимости.
### v1.7.0 — Расширение на другие платформы и конструктор презентаций (февраль 2026)
- **Поддержка Codex app + CLI** — прямая поддержка Codex через `AGENTS.md`, выбор цели установщика и документация по Codex
- **Навык `frontend-slides`** — HTML-конструктор презентаций без зависимостей, с рекомендациями по конвертации PPTX и строгими правилами подгонки под viewport
- **5 новых общих бизнес- и контент-навыков** — `article-writing`, `content-engine`, `market-research`, `investor-materials`, `investor-outreach`
- **Более широкое покрытие инструментов** — поддержка Cursor, Codex и OpenCode усилена так, чтобы один репозиторий аккуратно поставлялся во все основные среды
- **992 внутренних теста** — расширенная валидация и регрессионное покрытие для плагина, хуков, навыков и упаковки
### v1.6.0 — Codex CLI, AgentShield и Marketplace (февраль 2026)
- **Поддержка Codex CLI** — новая команда `/codex-setup` генерирует `codex.md` для совместимости с OpenAI Codex CLI
- **Интеграция AgentShield** — навык `/security-scan` запускает AgentShield прямо из Claude Code; 1282 теста, 102 правила
- **GitHub Marketplace** — GitHub App ECC Tools доступен на [github.com/marketplace/ecc-tools](https://github.com/marketplace/ecc-tools) с тарифами free/pro/enterprise
- **Объединено 30+ PR сообщества** — вклад 30 участников на 6 языках
- **978 внутренних тестов** — расширенный набор валидации для агентов, навыков, команд, хуков и правил
### v1.4.1 — Исправление ошибки (февраль 2026)
- **Исправлена потеря содержимого при импорте инстинктов** — `parse_instinct_file()` незаметно отбрасывал всё содержимое после frontmatter (разделы Action, Evidence, Examples) во время `/instinct-import`. ([#148](https://github.com/affaan-m/everything-claude-code/issues/148), [#161](https://github.com/affaan-m/everything-claude-code/pull/161))
### v1.4.0 — Многоязычные правила, мастер установки и PM2 (февраль 2026)
- **Интерактивный мастер установки** — новый навык `configure-ecc` предоставляет пошаговую настройку с обнаружением merge/overwrite
- **PM2 и многоагентная оркестрация** — 6 новых команд (`/pm2`, `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend`, `/multi-workflow`) для управления сложными многоcервисными рабочими процессами
- **Архитектура многоязычных правил** — правила реструктурированы из плоских файлов в директории `common/` + `typescript/` + `python/` + `golang/`. Устанавливайте только нужные языки
- **Переводы на китайский (zh-CN)** — полный перевод всех агентов, команд, навыков и правил (80+ файлов)
- **Поддержка GitHub Sponsors** — поддержите проект через GitHub Sponsors
- **Улучшенный CONTRIBUTING.md** — подробные шаблоны PR для каждого типа вклада
### v1.3.0 — Поддержка плагина OpenCode (февраль 2026)
- **Полная интеграция OpenCode** — 12 агентов, 24 команды, 16 навыков с поддержкой хуков через систему плагинов OpenCode (20+ типов событий)
- **Навыки Java Spring Boot** — паттерны, безопасность, TDD и верификация для Spring Boot
- **Управление сессиями** — команда `/sessions` для истории сессий
- **Непрерывное обучение v2** — обучение на основе инстинктов с оценкой уверенности, импортом/экспортом и эволюцией
Полный журнал изменений смотрите в [Releases](https://github.com/affaan-m/everything-claude-code/releases).
---
## Быстрый старт
Запустите всё менее чем за 2 минуты:
### Выберите только один путь
Большинству пользователей Claude Code нужен ровно один путь установки:
- **Рекомендуемый вариант по умолчанию:** установите плагин Claude Code, затем скопируйте только те папки правил, которые вам действительно нужны.
- **Используйте ручной установщик только если** вам нужен более тонкий контроль, вы хотите полностью избежать пути через плагин или ваша сборка Claude Code не может разрешить self-hosted запись в marketplace.
- **Не накладывайте методы установки друг на друга.** Самая частая сломанная конфигурация: сначала `/plugin install`, затем `install.sh --profile full` или `npx ecc-install --profile full`.
Если вы уже наложили несколько установок и видите дублирование, сразу переходите к разделу [Сброс / удаление ECC](#сброс--удаление-ecc).
### Путь с малым контекстом / без хуков
Если хуки кажутся слишком глобальными или вам нужны только правила, агенты, команды и основные навыки рабочих процессов ECC, пропустите плагин и используйте минимальный ручной профиль:
```bash
./install.sh --profile minimal --target claude
```
```powershell
.\install.ps1--profileminimal--targetclaude
# или
npxecc-install--profileminimal--targetclaude
```
Этот профиль намеренно исключает `hooks-runtime`.
Если вам нужен обычный core-профиль, но без хуков, используйте:
```bash
./install.sh --profile core --without baseline:hooks --target claude
```
Добавляйте хуки позже только если вам нужно runtime-принуждение:
```bash
./install.sh --target claude --modules hooks-runtime
```
### Сначала найдите нужные компоненты
Если вы не уверены, какой профиль ECC или компонент установить, спросите упакованный advisor из любого проекта:
```bash
npx ecc consult "security reviews" --target claude
```
Он вернёт подходящие компоненты, связанные профили и команды предпросмотра/установки. Используйте команду предпросмотра перед установкой, если хотите посмотреть точный план файлов.
### Шаг 1: Установите плагин (рекомендуется)
> ПРИМЕЧАНИЕ: Плагин удобен, но OSS-установщик ниже всё ещё остаётся самым надёжным путём, если ваша сборка Claude Code не может разрешить self-hosted записи marketplace.
- идентификатор Claude marketplace/plugin: `ecc@ecc`
- npm-пакет: `ecc-universal`
Это сделано намеренно. Установки Anthropic marketplace/plugin ключуются каноническим идентификатором плагина, поэтому ECC использует `ecc@ecc`, чтобы имена инструментов и пространства имен slash-команд оставались достаточно короткими для строгих валидаторов Desktop/API. Старые публикации могут всё ещё показывать прежний длинный marketplace-идентификатор; считайте его только устаревшим alias. Отдельно npm-пакет остался `ecc-universal`, поэтому npm-установки и marketplace-установки намеренно используют разные имена.
### Шаг 2: Установите правила (обязательно)
> ПРЕДУПРЕЖДЕНИЕ: **Важно:** плагины Claude Code не могут автоматически распространять `rules`.
>
> Если вы уже установили ECC через `/plugin install`, **не запускайте после этого `./install.sh --profile full`, `.\install.ps1 --profile full` или `npx ecc-install --profile full`**. Плагин уже загружает навыки, команды и хуки ECC. Запуск полного установщика после установки плагина скопирует те же компоненты в пользовательские директории и может создать дублирующиеся навыки и дублирующееся runtime-поведение.
>
> Для установки через плагин вручную скопируйте только нужные директории `rules/` в `~/.claude/rules/ecc/`. Начните с `rules/common` плюс один языковой или framework-пакет, который вы действительно используете. Не копируйте все директории правил, если явно не хотите весь этот контекст в Claude.
>
> Используйте полный установщик только если делаете полностью ручную установку ECC вместо пути через плагин.
>
> Если ваша локальная установка Claude была очищена или сброшена, это не значит, что нужно повторно покупать ECC. Начните с `node scripts/ecc.js list-installed`, затем запустите `node scripts/ecc.js doctor` и `node scripts/ecc.js repair` перед любой переустановкой. Обычно это восстанавливает файлы, управляемые ECC, без пересборки всей настройки. Если проблема связана с аккаунтом или marketplace-доступом к ECC Tools, восстановление billing/account нужно делать отдельно.
# Полностью ручной путь установки ECC (используйте вместо /plugin install)
# .\install.ps1 --profile full
# npx ecc-install --profile full
```
Инструкции по ручной установке смотрите в README в папке `rules/`. При ручном копировании правил копируйте всю языковую директорию целиком (например, `rules/common` или `rules/golang`), а не файлы внутри неё, чтобы относительные ссылки продолжали работать и имена файлов не конфликтовали.
### Полностью ручная установка (fallback)
Используйте это только если вы намеренно пропускаете путь через плагин:
```bash
./install.sh --profile full
```
```powershell
.\install.ps1--profilefull
# или
npxecc-install--profilefull
```
Если выбираете этот путь, на нём и остановитесь. Не запускайте дополнительно `/plugin install`.
### Сброс / удаление ECC
Если ECC кажется дублированным, навязчивым или сломанным, не переустанавливайте его снова поверх самого себя.
- **Путь через плагин:** удалите плагин из Claude Code, затем удалите конкретные папки правил, которые вы вручную скопировали в `~/.claude/rules/ecc/`.
- **Ручной установщик / CLI-путь:** из корня репозитория сначала посмотрите preview удаления:
```bash
node scripts/uninstall.js --dry-run
```
Затем удалите файлы, управляемые ECC:
```bash
node scripts/uninstall.js
```
Также можно использовать lifecycle-wrapper:
```bash
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run
```
ECC удаляет только файлы, записанные в его install-state. Он не удалит посторонние файлы, которые сам не устанавливал.
Если вы смешали методы, очищайте в таком порядке:
1. Удалите установку плагина Claude Code.
2. Запустите команду удаления ECC из корня репозитория, чтобы удалить файлы, управляемые install-state.
3. Удалите любые дополнительные папки правил, которые вы скопировали вручную и больше не хотите использовать.
4. Переустановите один раз, используя один путь.
### Шаг 3: Начните использовать
```bash
# Навыки — основной рабочий интерфейс.
# Существующие slash-style имена команд продолжают работать, пока ECC мигрирует с commands/.
# Установка через плагин использует каноническую форму с namespace
/ecc:plan "Добавить аутентификацию пользователей"
# Ручная установка сохраняет более короткую slash-форму:
# /plan "Добавить аутентификацию пользователей"
# Проверить доступные команды
/plugin list ecc@ecc
```
**Готово.** Теперь у вас есть доступ к 50 агентам, 185 навыкам и 68 устаревшим совместимым заглушкам команд.
### Dashboard GUI
Запустите настольную панель управления, чтобы визуально изучить компоненты ECC:
```bash
npm run dashboard
# или
python3 ./ecc_dashboard.py
```
**Возможности:**
- интерфейс с вкладками: Agents, Skills, Commands, Rules, Settings
- переключение тёмной/светлой темы
- настройка шрифта (семейство и размер)
- логотип проекта в заголовке и панели задач
- поиск и фильтрация по всем компонентам
### Мультимодельные команды требуют дополнительной настройки
> ПРЕДУПРЕЖДЕНИЕ: команды `multi-*` **не** покрываются базовой установкой плагина/правил выше.
>
> Чтобы использовать `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend` и `/multi-workflow`, нужно также установить runtime `ccg-workflow`.
>
> Инициализируйте его через `npx ccg-workflow`.
>
> Этот runtime предоставляет внешние зависимости, которых ожидают эти команды, включая:
> - `~/.claude/bin/codeagent-wrapper`
> - `~/.claude/.ccg/prompts/*`
>
> Без `ccg-workflow` эти `multi-*` команды не будут работать корректно.
---
## Кроссплатформенная поддержка
Плагин теперь полностью поддерживает **Windows, macOS и Linux**, а также плотно интегрирован с основными IDE (Cursor, OpenCode, Antigravity) и CLI-средами. Все хуки и скрипты переписаны на Node.js для максимальной совместимости.
### Определение пакетного менеджера
Плагин автоматически определяет предпочитаемый пакетный менеджер (npm, pnpm, yarn или bun) в таком порядке приоритета:
- **файлы SKILL.md** — готовые к использованию навыки для Claude Code
- **коллекции инстинктов** — для continuous-learning-v2
- **извлечение паттернов** — обучение на вашей истории коммитов
### AgentShield — аудитор безопасности
> Создан на Claude Code Hackathon (Cerebral Valley x Anthropic, февраль 2026). 1282 теста, 98% покрытия, 102 правила статического анализа.
Сканирует вашу конфигурацию Claude Code на уязвимости, неправильные настройки и риски инъекций.
```bash
# Быстрое сканирование (установка не нужна)
npx ecc-agentshield scan
# Автоисправление безопасных проблем
npx ecc-agentshield scan --fix
# Глубокий анализ с тремя агентами Opus 4.6
npx ecc-agentshield scan --opus --stream
# Генерировать безопасный конфиг с нуля
npx ecc-agentshield init
```
**Что сканируется:** CLAUDE.md, settings.json, MCP configs, хуки, определения агентов и навыки по 5 категориям: обнаружение секретов (14 паттернов), аудит разрешений, анализ hook injection, профилирование рисков MCP-серверов и ревью конфигураций агентов.
**Флаг `--opus`** запускает три агента Claude Opus 4.6 в pipeline red-team/blue-team/auditor. Атакующий ищет цепочки эксплойтов, защитник оценивает защиты, а аудитор синтезирует оба результата в приоритизированную оценку рисков. Это adversarial reasoning, а не просто matching паттернов.
**Форматы вывода:** терминал (цветовая оценка A-F), JSON (CI pipelines), Markdown, HTML. Exit code 2 при критических находках для build gates.
Используйте `/security-scan` в Claude Code, чтобы запустить его, или добавьте в CI через [GitHub Action](https://github.com/affaan-m/agentshield).
Система обучения на основе инстинктов автоматически изучает ваши паттерны:
```bash
/instinct-status # Показать изученные инстинкты с уверенностью
/instinct-import <file> # Импортировать инстинкты от других
/instinct-export # Экспортировать ваши инстинкты для обмена
/evolve # Кластеризовать связанные инстинкты в skills
```
Полную документацию смотрите в `skills/continuous-learning-v2/`.
Оставляйте `continuous-learning/` только если вам явно нужен legacy v1 Stop-hook поток learned-skill.
---
## Требования
### Версия Claude Code CLI
**Минимальная версия: v2.1.0 или новее**
Этот плагин требует Claude Code CLI v2.1.0+ из-за изменений в том, как система плагинов обрабатывает хуки.
Проверьте версию:
```bash
claude --version
```
### Важно: поведение автозагрузки хуков
> ПРЕДУПРЕЖДЕНИЕ: **Для контрибьюторов:** НЕ добавляйте поле `"hooks"` в `.claude-plugin/plugin.json`. Это закреплено регрессионным тестом.
Claude Code v2.1+ **автоматически загружает**`hooks/hooks.json` из любого установленного плагина по соглашению. Явное объявление в `plugin.json` вызывает ошибку обнаружения дубликата:
```
Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
```
**История:** это уже приводило к повторяющимся циклам fix/revert в репозитории ([#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103)). Поведение менялось между версиями Claude Code, что вызывало путаницу. Теперь есть регрессионный тест, который не даёт вернуть эту ошибку.
---
## Установка
### Вариант 1: установить как плагин (рекомендуется)
Самый простой способ использовать этот репозиторий — установить его как плагин Claude Code:
Или добавьте напрямую в `~/.claude/settings.json`:
```json
{
"extraKnownMarketplaces":{
"ecc":{
"source":{
"source":"github",
"repo":"affaan-m/everything-claude-code"
}
}
},
"enabledPlugins":{
"ecc@ecc":true
}
}
```
Это сразу даёт доступ ко всем командам, агентам, навыкам и хукам.
> **Примечание:** система плагинов Claude Code не поддерживает распространение `rules` через плагины ([ограничение upstream](https://code.claude.com/docs/en/plugins-reference)). Правила нужно установить вручную:
# Retired shims находятся в legacy-command-shims/commands/.
# Копируйте отдельные файлы оттуда только если вам всё ещё нужны старые имена вроде /tdd.
```
#### Установить хуки
Не копируйте сырой repo-файл `hooks/hooks.json` в `~/.claude/settings.json` или `~/.claude/hooks/hooks.json`. Этот файл ориентирован на плагин/репозиторий и должен устанавливаться через установщик ECC или загружаться как плагин, поэтому прямое копирование не является поддерживаемым ручным способом установки.
Используйте установщик, чтобы установить только Claude hook runtime и корректно переписать пути команд:
```bash
# macOS / Linux
bash ./install.sh --target claude --modules hooks-runtime
Это записывает разрешённые хуки в `~/.claude/hooks/hooks.json` и не трогает существующий `~/.claude/settings.json`.
Если вы установили ECC через `/plugin install`, не копируйте эти хуки в `settings.json`. Claude Code v2.1+ уже автоматически загружает plugin `hooks/hooks.json`, а дублирование в `settings.json` вызывает двойное выполнение и кроссплатформенные конфликты хуков.
Примечание для Windows: директория конфигурации Claude — `%USERPROFILE%\\.claude`, а не `~/claude`.
#### Настроить MCP
Установки Claude plugin намеренно не включают автоматически bundled MCP server definitions ECC. Это предотвращает слишком длинные имена plugin MCP tools на строгих сторонних gateway, но оставляет доступной ручную настройку MCP.
Для live-изменений серверов Claude Code используйте команду Claude Code `/mcp` или CLI-managed MCP setup. Используйте `/mcp` для отключений во время выполнения Claude Code; Claude Code сохраняет эти решения в `~/.claude.json`.
Для repo-local MCP-доступа скопируйте нужные определения MCP-серверов из `mcp-configs/mcp-servers.json` в project-scoped `.mcp.json`.
Если у вас уже запущены собственные копии MCP, bundled в ECC, задайте:
ECC-managed install и Codex sync flows будут пропускать или удалять эти bundled servers вместо повторного добавления дубликатов. `ECC_DISABLED_MCPS` — это фильтр установки/синхронизации ECC, а не live-переключатель Claude Code.
**Важно:** замените placeholders `YOUR_*_HERE` на реальные API keys.
---
## Ключевые концепции
### Агенты
Субагенты выполняют делегированные задачи с ограниченной областью. Пример:
```markdown
---
name:code-reviewer
description:Проверяет код на качество, безопасность и сопровождаемость
tools:["Read","Grep","Glob","Bash"]
model:opus
---
Вы — senior code reviewer...
```
### Навыки
Навыки — основной рабочий интерфейс. Их можно вызывать напрямую, предлагать автоматически и переиспользовать агентами. ECC всё ещё поставляет поддерживаемые `commands/` во время миграции, а retired short-name shims живут в `legacy-command-shims/` только для явного opt-in. Новая разработка рабочих процессов должна сначала попадать в `skills/`.
```markdown
# TDD Workflow
1. Сначала определите интерфейсы
2. Напишите падающие тесты (RED)
3. Реализуйте минимальный код (GREEN)
4. Выполните рефакторинг (IMPROVE)
5. Проверьте покрытие 80%+
```
### Хуки
Хуки срабатывают на события инструментов. Пример — предупреждение о `console.log`:
Детали установки и структуры смотрите в [`rules/README.md`](../../rules/README.md).
---
## Какого агента использовать?
Не знаете, с чего начать? Используйте эту краткую справку. Skills — канонический рабочий интерфейс; поддерживаемые slash entries остаются доступными для command-first workflows.
Slash-формы ниже показаны там, где они остаются частью поддерживаемого командного интерфейса. Retired short-name shims вроде `/tdd` и `/eval` живут в `legacy-command-shims/` только для явного opt-in.
Показывает всех доступных агентов, команды и навыки из плагина.
</details>
<details>
<summary><b>Хуки не работают / я вижу ошибки "Duplicate hooks file"</b></summary>
Это самая частая проблема. **НЕ добавляйте поле `"hooks"` в `.claude-plugin/plugin.json`.** Claude Code v2.1+ автоматически загружает `hooks/hooks.json` из установленных плагинов. Явное объявление вызывает ошибки обнаружения дубликатов. См. [#29](https://github.com/affaan-m/everything-claude-code/issues/29), [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/everything-claude-code/issues/103).
</details>
<details>
<summary><b>Можно ли использовать ECC с Claude Code на custom API endpoint или model gateway?</b></summary>
Да. ECC не хардкодит транспортные настройки Anthropic-hosted окружения. Он запускается локально через обычный CLI/plugin-интерфейс Claude Code, поэтому работает с:
- Anthropic-hosted Claude Code
- официальными Claude Code gateway-настройками через `ANTHROPIC_BASE_URL` и `ANTHROPIC_AUTH_TOKEN`
- совместимыми custom endpoints, которые говорят на Anthropic API, ожидаемом Claude Code
Если ваш gateway переименовывает модели, настраивайте это в Claude Code, а не в ECC. Хуки, навыки, команды и правила ECC не зависят от model provider, если CLI `claude` уже работает.
- [Claude Code model configuration docs](https://docs.anthropic.com/en/docs/claude-code/model-config)
</details>
<details>
<summary><b>Контекстное окно сжимается / у Claude заканчивается контекст</b></summary>
Слишком много MCP-серверов съедают контекст. Каждое описание MCP tool потребляет токены из вашего окна 200k, потенциально сокращая его до ~70k. Контекст SessionStart по умолчанию ограничен 8000 символами; уменьшите его через `ECC_SESSION_START_MAX_CHARS=4000` или отключите через `ECC_SESSION_START_CONTEXT=off` для local-model или low-context setups.
**Решение:** отключите неиспользуемые MCP в Claude Code через `/mcp`. Claude Code записывает эти runtime-решения в `~/.claude.json`; `.claude/settings.json` и `.claude/settings.local.json` не являются надёжными переключателями для уже загруженных MCP-серверов.
Держите включёнными менее 10 MCP и менее 80 активных tools.
</details>
<details>
<summary><b>Можно ли использовать только часть компонентов, например только агентов?</b></summary>
Да. Используйте вариант 2 (ручная установка) и копируйте только то, что нужно:
<summary><b>Работает ли это с Cursor / OpenCode / Codex / Antigravity?</b></summary>
Да. ECC кроссплатформенный:
- **Cursor**: предварительно адаптированные конфиги в `.cursor/`. См. [Поддержка Cursor IDE](#поддержка-cursor-ide).
- **Gemini CLI**: экспериментальная project-local поддержка через `.gemini/GEMINI.md` и общий plumbing установщика.
- **OpenCode**: полная поддержка плагина в `.opencode/`. См. [Поддержка OpenCode](#поддержка-opencode).
- **Codex**: первоклассная поддержка macOS app и CLI, с guards против adapter drift и SessionStart fallback. См. PR [#257](https://github.com/affaan-m/everything-claude-code/pull/257).
- Предметные знания (ML, data engineering, mobile)
### Заметки об экосистеме сообщества
Они не поставляются вместе с ECC и не аудируются этим репозиторием, но о них стоит знать, если вы изучаете более широкую экосистему Claude Code skills:
- [claude-seo](https://github.com/AgriciDaniel/claude-seo) — SEO-focused коллекция skills и agents
- [claude-ads](https://github.com/AgriciDaniel/claude-ads) — коллекция ad-audit и paid-growth workflows
- [claude-cybersecurity](https://github.com/AgriciDaniel/claude-cybersecurity) — security-oriented коллекция skills и agents
---
## Поддержка Cursor IDE
ECC предоставляет поддержку Cursor IDE с хуками, правилами, агентами, навыками, командами и MCP-конфигами, адаптированными под layout проекта Cursor.
### Быстрый старт (Cursor)
```bash
# macOS/Linux
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php
```
```powershell
# Windows PowerShell
.\install.ps1--targetcursortypescript
.\install.ps1--targetcursorpythongolangswiftphp
```
### Что включено
| Компонент | Количество | Детали |
|-----------|------------|--------|
| Hook Events | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt и ещё 10 |
| Hook Scripts | 16 | Тонкие Node.js скрипты, делегирующие в `scripts/hooks/` через общий adapter |
| Commands | Shared | `.cursor/commands/` при установке |
| MCP Config | Shared | `.cursor/mcp.json` при установке |
### Заметки о загрузке Cursor
ECC не устанавливает root `AGENTS.md` в `.cursor/`. Cursor воспринимает вложенные `AGENTS.md` как directory context, поэтому копирование identity ECC-репозитория в host project загрязняло бы этот проект.
Cursor-native loading behavior может различаться между сборками Cursor. ECC устанавливает агентов как `.cursor/agents/ecc-*.md`; если ваша сборка Cursor не показывает project agents, эти файлы всё равно работают как явные reference definitions, а не скрытый global prompt context.
### Архитектура хуков (DRY adapter pattern)
В Cursor **больше hook events, чем в Claude Code** (20 против 8). Модуль `.cursor/hooks/adapter.js` преобразует stdin JSON Cursor в формат Claude Code, позволяя переиспользовать существующие `scripts/hooks/*.js` без дублирования.
Правила Cursor используют YAML frontmatter с`description`, `globs` и `alwaysApply`:
```yaml
---
description:"TypeScript coding style extending common rules"
globs:["**/*.ts","**/*.tsx","**/*.js","**/*.jsx"]
alwaysApply:false
---
```
---
## Поддержка Codex macOS App + CLI
ECC предоставляет **первоклассную поддержку Codex** как для macOS app, так и для CLI: reference configuration, Codex-specific supplement `AGENTS.md` и общие skills.
### Быстрый старт (Codex App + CLI)
```bash
# Запустить Codex CLI в репозитории — AGENTS.md и .codex/ определяются автоматически
# или: bun install && bash scripts/sync-ecc-to-codex.sh
# Или вручную: скопировать reference config в домашнюю директорию
cp .codex/config.toml ~/.codex/config.toml
```
Sync script безопасно сливает MCP-серверы ECC в существующий `~/.codex/config.toml` через стратегию **add-only**: он никогда не удаляет и не изменяет ваши существующие серверы. Запускайте с `--dry-run`, чтобы посмотреть изменения, или с `--update-mcp`, чтобы принудительно обновить ECC-серверы до последнего рекомендуемого конфига.
Для Context7 ECC использует каноническое имя секции Codex `[mcp_servers.context7]`, но всё ещё запускает пакет `@upstash/context7-mcp`. Если у вас уже есть legacy-запись `[mcp_servers.context7-mcp]`, `--update-mcp` мигрирует её на каноническое имя секции.
Codex macOS app:
- Откройте этот репозиторий как workspace.
- Root `AGENTS.md` определяется автоматически.
-`.codex/config.toml` и `.codex/agents/*.toml` лучше всего работают, когда остаются project-local.
- Reference `.codex/config.toml` намеренно не фиксирует `model` или `model_provider`, поэтому Codex использует свой текущий default, если вы его не переопределили.
- Опционально: скопируйте `.codex/config.toml` в `~/.codex/config.toml` для global defaults; multi-agent role files оставляйте project-local, если также не копируете `.codex/agents/`.
Skills в `.agents/skills/` автоматически загружаются Codex:
Канонические Anthropic skills вроде `claude-api`, `frontend-design` и `skill-creator` намеренно не переупакованы здесь. Устанавливайте их из [`anthropics/skills`](https://github.com/anthropics/skills), когда нужны официальные версии.
| video-editing | AI-assisted video editing workflows с FFmpeg и Remotion |
| x-api | Интеграция X/Twitter API для posting и analytics |
### Ключевое ограничение
Codex **пока не предоставляет parity с Claude-style hook execution**. Принуждение ECC там instruction-based через `AGENTS.md`, опциональные overrides `model_instructions_file` и настройки sandbox/approval.
- **AGENTS.md** в корне — универсальный cross-tool файл (читается всеми 4 инструментами)
- **DRY adapter pattern** позволяет Cursor переиспользовать hook scripts Claude Code без дублирования
- **Формат Skills** (SKILL.md с YAML frontmatter) работает в Claude Code, Codex и OpenCode
- Отсутствие хуков в Codex компенсируется `AGENTS.md`, опциональными overrides `model_instructions_file` и sandbox permissions
---
## Предыстория
Я использую Claude Code с экспериментального rollout. В сентябре 2025 выиграл Anthropic x Forum Ventures hackathon вместе с [@DRodriguezFX](https://x.com/DRodriguezFX) — мы построили [zenith.chat](https://zenith.chat) полностью с помощью Claude Code.
Эти конфиги проверены в бою на нескольких production-приложениях.
---
## Оптимизация токенов
Использование Claude Code может быть дорогим, если не управлять потреблением токенов. Эти настройки заметно снижают затраты без потери качества.
### Рекомендуемые настройки
Добавьте в `~/.claude/settings.json`:
```json
{
"model":"sonnet",
"env":{
"MAX_THINKING_TOKENS":"10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE":"50"
}
}
```
| Настройка | По умолчанию | Рекомендуется | Эффект |
| `model` | opus | **sonnet** | ~60% снижение затрат; справляется с 80%+ coding tasks |
| `MAX_THINKING_TOKENS` | 31,999 | **10,000** | ~70% снижение скрытой стоимости thinking на request |
| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 95 | **50** | Более ранняя compaction — лучшее качество в длинных сессиях |
Переключайтесь на Opus только когда нужно глубокое архитектурное рассуждение:
```
/model opus
```
### Команды ежедневного workflow
| Команда | Когда использовать |
|---------|--------------------|
| `/model sonnet` | Default для большинства задач |
| `/model opus` | Сложная архитектура, debugging, deep reasoning |
| `/clear` | Между несвязанными задачами (бесплатный мгновенный reset) |
| `/compact` | В логических точках разрыва задачи (исследование завершено, milestone готов) |
| `/cost` | Мониторинг расходов токенов во время сессии |
### Стратегическая компактификация
Навык `strategic-compact` (включён в этот плагин) предлагает `/compact` в логических точках, а не полагается на auto-compaction при 95% контекста. Полный decision guide смотрите в `skills/strategic-compact/SKILL.md`.
**Когда compact:**
- после research/exploration, перед implementation
- после завершения milestone, перед началом следующего
- после debugging, перед продолжением работы над feature
- после неудачного подхода, перед пробой нового
**Когда НЕ compact:**
- в середине implementation (потеряете имена переменных, пути файлов, partial state)
### Управление контекстным окном
**Критично:** не включайте все MCP сразу. Каждое описание MCP tool потребляет токены из вашего окна 200k, потенциально сокращая его до ~70k.
- Держите включёнными менее 10 MCP на проект
- Держите активными менее 80 tools
- Используйте `/mcp`, чтобы отключать неиспользуемые Claude Code MCP servers; эти runtime-решения сохраняются в `~/.claude.json`
- Используйте `ECC_DISABLED_MCPS` только для фильтрации MCP-конфигов, генерируемых ECC, во время install/sync flows
### Предупреждение о стоимости Agent Teams
Agent Teams создаёт несколько context windows. Каждый участник команды потребляет токены независимо. Используйте это только для задач, где параллелизм даёт явную пользу (multi-module work, parallel reviews). Для простых последовательных задач subagents эффективнее по токенам.
---
## Важные предупреждения
### Оптимизация токенов
Упираетесь в дневные лимиты? Смотрите **[Руководство по оптимизации токенов](../token-optimization.md)** с рекомендуемыми настройками и workflow-советами.
Быстрые выигрыши:
```json
// ~/.claude/settings.json
{
"model":"sonnet",
"env":{
"MAX_THINKING_TOKENS":"10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE":"50",
"CLAUDE_CODE_SUBAGENT_MODEL":"haiku"
}
}
```
Используйте `/clear` между несвязанными задачами, `/compact` в логических breakpoints и `/cost` для мониторинга расходов.
### Кастомизация
Эти конфиги работают для моего workflow. Вам стоит:
1. Начать с того, что резонирует
2. Адаптировать под ваш стек
3. Удалить то, чем не пользуетесь
4. Добавить собственные паттерны
---
## Проекты сообщества
Проекты, построенные на Everything Claude Code или вдохновлённые им:
| Проект | Описание |
|--------|----------|
| [EVC](https://github.com/SaigonXIII/evc) | Marketing agent workspace — 42 команды для content operators, brand governance и multi-channel publishing. [Визуальный обзор](https://saigonxiii.github.io/evc). |
Построили что-то с ECC? Откройте PR, чтобы добавить это сюда.
---
## Спонсоры
Этот проект бесплатный и open source. Спонсоры помогают поддерживать и развивать его.
[](https://star-history.com/#affaan-m/everything-claude-code&Date)
---
## Ссылки
- **Краткое руководство (начните здесь):** [The Shorthand Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2012378465664745795)
- **Подробное руководство (продвинутый уровень):** [The Longform Guide to Everything Claude Code](https://x.com/affaanmustafa/status/2014040193557471352)
- **Руководство по безопасности:** [Security Guide](../../the-security-guide.md) | [Тред](https://x.com/affaanmustafa/status/2033263813387223421)
