> **Лише офіційні джерела.** Встановлюйте ECC виключно з перевірених каналів: репозиторій GitHub [github.com/affaan-m/ECC](https://github.com/affaan-m/ECC), пакети npm [`ecc-universal`](https://www.npmjs.com/package/ecc-universal) та [`ecc-agentshield`](https://www.npmjs.com/package/ecc-agentshield), [GitHub App](https://github.com/apps/ecc-tools), ідентифікатор плагіна `ecc@ecc`, та вебсайт проєкту [ecc.tools](https://ecc.tools). Сторонні перезавантаження та неофіційні дзеркала не підтримуються і не перевіряються проєктом та можуть містити шкідливе програмне забезпечення.
Це встановлює навички, агенти, команди та керовані плагіном хуки ECC. Якщо ви обираєте цей шлях, зупиніться на цьому. Не запускайте також повне ручне встановлення в Claude Code.
> Керований майстер налаштування пакета з'явиться в `ecc-universal` 2.2.0. Поки npm залишається на 2.1.0, використовуйте нативні команди плагіна Claude вище.
<sub>**OSS залишається безкоштовним.** Цей репозиторій ліцензований за MIT назавжди. ECC Pro — розміщений GitHub App для приватних репозиторіїв. <a href="https://github.com/sponsors/affaan-m">Спонсори</a> та <a href="https://ecc.tools/pricing">Pro-підписники</a> фінансують роботу. Саме тому один розробник щотижня випускає оновлення для 7 оболонок.</sub>
Ваш агент може писати код, але ECC надає йому скоординовану інженерну систему та набір інструментів: він планує перед тим, як будувати, перевіряє зміни тестами, переглядає власну роботу зі свіжого контексту, запам'ятовує важливе та перетворює повторювані перемоги на навички та процеси для повторного використання.
ECC — це MIT-ліцензований open source. Найкраще працює з Claude Code сьогодні, має підтримуваний шлях синхронізації з Codex та надає адаптери з обмеженими можливостями для Cursor, OpenCode, Gemini, Zed, GitHub Copilot, Antigravity, Qwen та інших оболонок. Перегляньте [матрицю статусу підтримки](#підтримка-платформ), перш ніж припускати повний паритет функцій.
Доступ до 68 агентів, 287 навичок та 94 застарілих командних шимів, а також хуки, правила, пам'ять, безперервне навчання та сканування безпеки AgentShield. Агенти спеціалізовані на плануванні, перегляді, виправленні збірки, безпеці, архітектурі та доменній роботі.
> Керований майстер налаштування пакета з'явиться в `ecc-universal` 2.2.0. Поточний реліз npm, 2.1.0, ще не містить команд керованого налаштування. Використовуйте нативні команди плагіна Claude на початку цього README до публікації 2.2.0.
### Обирайте лише один шлях (на кожну оболонку)
Ви можете використовувати ECC з Claude Code, Codex та іншими оболонками одночасно. Для кожної оболонки обирайте один метод встановлення:
- **Рекомендовано сьогодні для Claude Code:** використовуйте [нативні команди плагіна вище](#встановлення-через-claude-code)
- **З'явиться у релізі 2.2:** кероване налаштування пакета для Claude Code, Codex та Kimi Code; перегляньте попередній перегляд внизу цього розділу встановлення
- **Працює:** плагін Claude Code + нативний плагін Codex
- **Працює:** плагін Claude Code + застарілий потік синхронізації Codex
- **Уникайте:** плагін Claude Code + повне ручне встановлення Claude
**Не накопичуйте методи встановлення.** Встановлення ECC двічі в одну оболонку може продублювати навички, команди, хуки чи конфігурацію; встановлення один раз у кілька оболонок — ні.
Якщо ви вже наклали кілька встановлень і щось виглядає продубльованим, перейдіть одразу до [Скидання / видалення ECC](#скидання--видалення-ecc).
**Проблеми зі встановленням?** Відкрийте коротку [форму проблеми встановлення чи виконання](https://github.com/affaan-m/ECC/issues/new?template=install-problem.yml) або запустіть `ecc feedback`. ECC ніколи автоматично не завантажує діагностику.
### Деталі для Claude Code
Claude Code володіє цими вбудованими командами, включно з їхніми помилками, коли маркетплейс, плагін чи конфліктуючий рівень уже існує. ECC не може перехопити цей парсер. Якщо будь-яка нативна команда повідомляє про наявне встановлення чи конфлікт рівнів, дочекайтеся керованого налаштування 2.2.0 або вирішіть конфліктуючий рівень плагіна Claude перед повторною спробою; не накладайте ручне встановлення поверх.
Після встановлення ECC `/ecc:configure-ecc` — це навичка переналаштування в Claude з простором імен. Вона делегує до того ж безпечного потоку налаштування, але доступна лише після встановлення плагіна і не може замінити вбудовану команду `/plugin` Claude Code під час першого встановлення.
Плагіни Claude Code не можуть розповсюджувати `rules`, тому додавайте лише ті пакети правил, які вам справді потрібні:
Почніть з `rules/common` плюс один мовний чи фреймворковий пакет, який ви фактично використовуєте. Якщо ви встановили плагін, не запускайте після цього `./install.sh --profile full`.
Це навмисно. Встановлення через marketplace/плагін Anthropic прив'язані до канонічного ідентифікатора плагіна, тому ECC використовує `ecc@ecc`, щоб зберегти назви інструментів і простори імен команд зі слешем достатньо короткими для строгих валідаторів Desktop/API. Старі публікації можуть показувати попередній довгий ідентифікатор marketplace; вважайте це лише застарілим псевдонімом. Окремо, пакет npm навмисно залишився на `ecc-universal`, тому встановлення через npm та marketplace навмисно використовують різні назви.
Релізи npm вирізаються за тегом версії, а не за кожним комітом, тому `ecc-universal` відстежує релізи (2.1, 2.2, ...), а не кожен push у `main`. Встановлюйте з git, якщо хочете найсвіжішу версію.
Якщо ваше локальне налаштування Claude було стерто чи скинуто, це не означає, що вам потрібно щось перекуповувати. Почніть з `node scripts/ecc.js list-installed`, потім запустіть `node scripts/ecc.js doctor` та `node scripts/ecc.js repair` перед перевстановленням. Зазвичай це відновлює керовані ECC файли без перебудови всього налаштування.
</details>
### Codex App і CLI
Поточні релізи Codex можуть встановлювати ECC як нативний плагін репо-маркетплейсу. Запис маркетплейсу використовує корінь репозиторію, тому кеш Codex отримує маніфест разом з усіма навичками, конфігурацією MCP, середовищем виконання хуків, скриптами та ресурсами, на які є посилання:
```bash
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.js
```
Обидві команди додавання ідемпотентні. Щоб оновити пізніше, запустіть `codex plugin marketplace upgrade ecc`, а потім `codex plugin add ecc@ecc`. Codex зберігає стан одного увімкненого плагіна в активному `CODEX_HOME`; він не пропонує рівні `user`, `project` та `local` Claude. Його нативні хуки вимагають явного рішення про довіру і не використовують чотири профілі хуків ECC для Claude. Всередині Codex викликайте `$configure-ecc` для керованого потоку, що враховує провайдера.
Старіший шлях `scripts/sync-ecc-to-codex.sh` залишається окремим варіантом сумісності для користувачів, які навмисно хочуть скопійовану та злиту конфігурацію в `~/.codex`; він не потрібен для нативного плагіна. Спочатку запустіть Codex один раз, щоб `~/.codex/config.toml` існував, потім:
Ви також можете відкрити репозиторій ECC безпосередньо в Codex для локального налаштування проєкту. Codex читає кореневий `AGENTS.md` та довірену конфігурацію проєкту в `.codex/` без глобальної синхронізації. Не додавайте нативний плагін маркетплейсу поверх потоку синхронізації.
Для навігації по репозиторію, володіння поверхнями та настанов щодо пакетів diff для PR читайте [карту навігації Codex ECC](../../docs/CODEX-NAVIGATION-GUIDE.md). Дивіться [примітки плагіна .codex](../../.codex-plugin/README.md) для деталей нативного життєвого циклу.
| OpenClaw | `./install.sh --profile minimal --target openclaw` | Кероване встановлення в домашню директорію |
| Kimi Code CLI | `./install.sh --profile minimal --target kimi` | Локальне для проєкту встановлення `.kimi-code/` |
| CodeBuddy | `./install.sh --profile minimal --target codebuddy` | Локальне для проєкту встановлення `.codebuddy/` |
| JoyCode | `./install.sh --profile minimal --target joycode` | Локальне для проєкту встановлення `.joycode/` |
Підтримка GitHub Copilot вже включена в цей репозиторій. `.github/copilot-instructions.md` надає шар інструкцій, `.github/prompts/` містить повторно використовувані промпти `/plan`, `/tdd`, `/security-review`, `/build-fix` та `/refactor`, а`.vscode/settings.json` вмикає `chat.promptFiles`.
Для оболонки без нативної цілі ECC використовуйте [посібник з ручної адаптації](../../docs/MANUAL-ADAPTATION-GUIDE.md). Він пояснює, як перенести невеликий набір навичок і робочих інструкцій ECC у чат-подібні інструменти, не вдаючи, що хуки чи нативне виявлення навичок доступні.
Cursor встановлює визначення агентів під `.cursor/agents/ecc-*.md`. Нативна поведінка завантаження Cursor може відрізнятися залежно від збірки Cursor. ECC не встановлює кореневий `AGENTS.md` в `.cursor/`. Адаптер тримає контекст Cursor обмеженим його нативними правилами та поверхнями агентів.
Детальні примітки по кожній оболонці (паритет функцій, адаптери хуків, обмеження) знаходяться в [Підтримці платформ](#підтримка-платформ) нижче.
</details>
## Розширені опції встановлення
Опції залишаються тут, безпосередньо під основними шляхами встановлення, щоб вам не довелося шукати по всьому README, коли стандартне налаштування не підходить.
<details>
<summary><strong>Встановлення з низьким контекстом без середовища виконання хуків</strong></summary>
### Шлях з низьким контекстом / без хуків
Використовуйте це, коли хочете правила, агентів, команди, конфігурацію платформи та основні процеси ECC без хуків часу виконання:
```bash
./install.sh --profile minimal --target claude
```
Windows:
```powershell
.\install.ps1--profileminimal--targetclaude
```
Цей профіль навмисно виключає `hooks-runtime`.
Ручні встановлення Claude розміщують кожну навичку безпосередньо в `~/.claude/skills/<назва-навички>/` (або `.claude/skills/<назва-навички>/` для `claude-project`), щоб Claude Code міг її виявити. При оновленні старішого ручного встановлення ECC інсталятор мігрує лише вкладені файли `skills/ecc/`, записані в стані встановлення ECC. Якщо плоска директорія навички належить користувачу, ECC зберігає її, друкує попередження про конфлікт і відстежує будь-яку старішу керовану копію для безпечного видалення замість перезапису файлів користувача.
Для звичайного основного профілю з вимкненими хуками:
```bash
./install.sh --profile core --without baseline:hooks --target claude
```
Додайте середовище виконання хуків пізніше, лише якщо хочете його:
```bash
./install.sh --target claude --modules hooks-runtime
```
</details>
<details>
<summary><strong>Обирайте лише потрібні вам компоненти</strong></summary>
### Спочатку знайдіть потрібні компоненти
Запитайте вбудованого консультанта, які компоненти відповідають вашій роботі:
```bash
node scripts/ecc.js consult "security reviews" --target claude
```
Він повертає відповідні компоненти, пов'язані профілі та команди попереднього перегляду/встановлення. Використовуйте команду попереднього перегляду перед встановленням, якщо хочете перевірити точний план файлів.
Ви також можете встановити явні навички чи можливості:
```bash
./install.sh --target claude --skills tdd-workflow,security-review
node scripts/ecc.js install --profile minimal --target claude --with capability:machine-learning
```
Ручне копіювання компонент за компонентом також працює. Кожен компонент повністю незалежний:
Правила — це завжди завантажуваний контекст, тому починайте з `common` та одного пакета для стеку, який ви фактично використовуєте. При ручному копіюванні правил копіюйте цілу мовну директорію (наприклад `rules/common` чи `rules/golang`), а не файли всередині неї, щоб відносні посилання продовжували працювати, а назви файлів не конфліктували.
</details>
<details>
<summary><strong>Повністю ручне встановлення Claude</strong></summary>
Використовуйте це лише коли ви навмисно пропускаєте шлях плагіна:
```bash
git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile full
```
Windows:
```powershell
gitclonehttps://github.com/affaan-m/ECC.git
cd ECC
.\install.ps1--profilefull
```
Якщо ви обираєте цей шлях, зупиніться на цьому. Не запускайте також `/plugin install`.
Для вибіркових ручних встановлень Claude виявляє навички як прямих нащадків `~/.claude/skills/`; не вкладайте їх під `~/.claude/skills/ecc/`.
#### Встановлення хуків
Не копіюйте необроблений `hooks/hooks.json` з репозиторію безпосередньо в `~/.claude/settings.json` чи `~/.claude/hooks/hooks.json`. Цей файл орієнтований на плагін/репозиторій; використовуйте інсталятор, щоб шляхи команд хуків були правильно переписані:
Це записує вирішені хуки в `~/.claude/hooks/hooks.json` і залишає будь-який наявний `~/.claude/settings.json` недоторканим.
Якщо ви встановили ECC через `/plugin install`, не копіюйте ці хуки в `settings.json`. Claude Code v2.1+ вже автоматично завантажує `hooks/hooks.json` плагіна, і дублювання їх у `settings.json` спричиняє подвійне виконання та крос-платформні конфлікти хуків.
На Windows кореневий каталог конфігурації Claude — `%USERPROFILE%\\.claude`; встановіть середовище виконання хуків командою:
Встановлення плагіна Claude навмисно не вмикають автоматично вбудовані визначення MCP-серверів ECC. Це уникає надто довгих назв MCP-інструментів плагіна на строгих сторонніх шлюзах, зберігаючи ручне налаштування MCP доступним.
Використовуйте команду `/mcp` Claude Code чи керовану CLI конфігурацію MCP для живих змін MCP-серверів у Claude Code; Claude Code зберігає ці вибори в `~/.claude.json`. Для локального для репозиторію доступу до MCP скопіюйте потрібні визначення MCP-серверів з `mcp-configs/mcp-servers.json`у`.mcp.json` в межах проєкту.
ECC поставляється рівно з одним конектором за замовчуванням (`chrome-devtools`); все інше — це навичка, що обгортає CLI/REST API, або опційний запис каталогу. Правило та аудит червня 2026 року, який вивів з експлуатації попередні шість конекторів за замовчуванням, знаходяться в [docs/MCP-CONNECTOR-POLICY.md](../../docs/MCP-CONNECTOR-POLICY.md).
Якщо ви вже запускаєте власні копії вбудованих MCP ECC, встановіть:
```bash
exportECC_DISABLED_MCPS="chrome-devtools"
```
Керовані ECC потоки встановлення та синхронізації Codex пропустять чи видалять ці вбудовані сервери замість повторного додавання дублікатів. `ECC_DISABLED_MCPS` — це фільтр встановлення/синхронізації ECC, а не живий перемикач Claude Code.
<summary><strong>Мультимодельні команди вимагають додаткового налаштування</strong></summary>
Команди `multi-*`**не** входять до базового встановлення плагіна/правил.
Для використання `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend` та `/multi-workflow` необхідно також встановити середовище виконання `ccg-workflow`. Ініціалізуйте його командою `npx ccg-workflow`.
Це середовище виконання надає зовнішні залежності, яких очікують ці команди, зокрема:
-`~/.claude/bin/codeagent-wrapper`
-`~/.claude/.ccg/prompts/*`
Без `ccg-workflow` ці команди `multi-*` не працюватимуть коректно.
</details>
<details>
<summary><strong>Власні API-ендпоінти, шлюзи моделей і моделі на власному хостингу</strong></summary>
ECC працює через звичайну конфігурацію кожної оболонки, тому ви можете використовувати офіційного провайдера, сумісний власний API-ендпоінт чи шлюз моделей, або модель на власному хостингу без зміни робочих процесів ECC.
Для Claude Code ECC не жорстко прив'язує налаштування транспорту, розміщеного Anthropic. Мінімальний приклад шлюзу:
Якщо ваш шлюз перевизначає назви моделей, налаштуйте це в Claude Code, а не в ECC. Хуки, навички, команди та правила ECC не залежать від провайдера моделі, коли CLI `claude` вже працює. Дивіться [документацію Anthropic про LLM-шлюзи](https://docs.anthropic.com/en/docs/claude-code/llm-gateway) та [документацію про конфігурацію моделі](https://docs.anthropic.com/en/docs/claude-code/model-config).
Запускайте чи розміщуйте будь-яку модель з відкритим вихідним кодом за цим шлюзом, використовуючи окремі обчислювальні ресурси та налаштування обслуговування. Якщо вам потрібна GPU-потужність, [Itô](https://compute.itomarkets.com) — бажаний обчислювальний спонсор ECC; підходить будь-який GPU-провайдер. Посилання на спонсорство пасивне: воно не викликає RFQ, не резервує потужність, не надає обчислювальні ресурси та не налаштовує обслуговування. Окремо, `ecc ito find` викликає явно налаштований канонічний CLI Itô та подає живий автентифікований RFQ; він не резервує потужність. Кероване виведення через Itô ще не працює наживо.
### Самостійний хостинг Kimi з ECC + обчислювальними ресурсами Itô
Оболонка Kimi Code та шар обслуговування моделі — окремі речі. ECC налаштовує оболонку агента; ви приносите API-ендпоінт чи розміщуєте самостійно модель Kimi з відкритими вагами на власній GPU-потужності. Цей адаптер перевірений проти Kimi Code 0.31.x (`@moonshot-ai/kimi-code`):
<table aria-label="Шлях локальної моделі Kimi" width="100%">
<sub>Встановіть інструкції та навички проєкту, потім запустіть Kimi Code.</sub>
</td>
</tr>
</table>
Налаштуйте ендпоінт за [офіційним посібником провайдера](https://moonshotai.github.io/kimi-cli/en/configuration/providers.html) Kimi Code, потім встановіть ECC:
```bash
bash ./install.sh --target kimi --profile minimal
node scripts/ecc.js doctor --target kimi
kimi
```
Kimi Code нативно виявляє встановлені інструкції `.kimi-code/AGENTS.md` та процеси `.kimi-code/skills/`; для проєкту `.agents/skills/` — також офіційне місце виявлення. ECC безпечно зливає записи MCP проєкту в `.kimi-code/mcp.json`і не змінює `~/.kimi-code/config.toml` рівня користувача. Kimi Code підтримує нативні хуки, але поточний керований адаптер проєкту ECC їх не налаштовує, тому цей інсталятор не пропонує профілі хуків Kimi. Пробний запуск інсталятора та набір регресійних тестів перевіряють, що кожен керований запис Kimi залишається в межах локального для проєкту кореня `.kimi-code/`.
### Міст CLI обчислень Itô
`ecc ito` делегує до окремо встановленого канонічного клієнта Itô; ECC не підтримує другий API-клієнт. `ecc ito login [--no-browser]` виконує авторизацію пристрою, відкриває сторінку верифікації Itô за замовчуванням та зберігає токен пристрою в macOS Keychain; `--no-browser` пригнічує передачу сторінки. ECC сам не виконує автоматизацію браузера. `ecc ito auth` лише перевіряє і відхиляє `--no-browser`. Доступні операції: `ecc ito login`, `ecc ito auth`, `ecc ito find`, `ecc ito status` та окремо захищений `ecc ito evals`. Відповідні MCP-інструменти залишаються `ito_auth`, `ito_find` та `ito_status`; `ito_auth` перевіряє наявні облікові дані, а кваліфікація вузла доступна лише через CLI.
Пакет `ito-compute-cli` наразі не опубліковано. Зберіть його локально з репозиторію середовища виконання Itô (приватний, поки стіл зміцнюється; партнери з дизайну отримують доступ) під `cli/ito-compute-cli`, запустіть `npm ci` та `npm run check`, потім встановіть `ECC_ITO_CLI_EXECUTABLE` на абсолютний шлях `dist/bin/ito.js` цієї збірки. Вхід ніколи не успадковує `ITO_API_KEY`; auth, find та status передають `ITO_API_KEY` напряму, коли налаштовано, і `ITO_AUTH_MODE=legacy` не потрібен. `ecc ito logout` відкликає поточні облікові дані пристрою і зберігає їхню локальну копію, якщо віддалене відкликання не може бути підтверджене. Токени пристрою за замовчуванням використовують macOS Keychain; явний резервний файл повинен зберігати дозволи директорії/файлу лише для власника. ECC не виявляє цей клієнт, що містить облікові дані, через `PATH`. Дивіться [навичку `ito-compute`](../../skills/ito-compute/SKILL.md) для повного контракту повноважень RFQ та налаштування MCP.
`find` подає живий автентифікований RFQ. Він не резервує потужність. `evals` вимагає одночасно `ITO_ENABLE_SIXTYTWO_LIVE=1` та `--live-sixtytwo`, окремо встановлений `sixtytwo-cli==0.3.33`, явний список вузлів та наявну абсолютну директорію конфігурації. Він не може орендувати, запускати, відновлювати, ремонтувати чи купувати. ECC не надає шлях блокування котирування, покупки, робочого навантаження чи виведення, і ніколи не замінює відсутнього клієнта чи невдалого живого виклику локальним результатом.
</details>
<details>
<summary><strong>Скидання, ремонт чи видалення</strong></summary>
### Скидання / видалення ECC
Якщо ECC здається продубльованим, нав'язливим чи зламаним, перевірте керований стан перед перевстановленням:
```bash
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run
```
Для прямого видалення:
```bash
node scripts/uninstall.js --dry-run
node scripts/uninstall.js
```
Якщо ви йдете, команда видалення друкує опційну [20-секундну форму зворотного зв'язку](https://github.com/affaan-m/ECC/issues/new?template=quick-feedback.yml). Це публічний issue на GitHub, вона ніколи не блокує видалення, і ECC не завантажує діагностику. Ви також можете в будь-який час запустити `ecc feedback`, щоб побачити маршрути для проблем, зворотного зв'язку та пропозицій функцій.
Користувачі плагіна повинні видалити плагін з Claude Code, а потім видалити лише ті папки правил, які вони скопіювали вручну і більше не хочуть мати. ECC видаляє лише файли, записані в його стані встановлення. Він не претендує на непов'язані файли у ваших директоріях оболонки.
Якщо ви наклали кілька методів, очищуйте в такому порядку:
1. Видаліть встановлення плагіна Claude Code.
2. Запустіть команду видалення ECC з кореня репозиторію, щоб видалити файли, керовані станом встановлення.
3. Видаліть будь-які додаткові папки правил, які ви скопіювали вручну і більше не хочете мати.
4. Перевстановіть один раз, використовуючи єдиний шлях.
</details>
## Скоро: кероване налаштування в релізі 2.2
> [!WARNING]
> Ці команди пакетного бігуна ECC недоступні в поточному релізі npm, 2.1.0. Не запускайте їх, поки не буде опубліковано `ecc-universal` 2.2.0.
Попередній опис README — **Рекомендований стандарт:** запустіть керований майстер налаштування плагіна Claude — був опублікований завчасно. Ця рекомендація відкликана до релізу 2.2.
Для налаштування плагіна Claude Code, оновлень, зміни рівня та зміни профілю хуків:
```bash
npx ecc-universal setup
```
Реліз 2.2 підтримуватиме те саме кероване налаштування через сучасні пакетні бігуни:
| Пакетний бігун | Команда керованого налаштування |
|---|---|
| npm / npx | `npx ecc-universal setup` |
| pnpm | `pnpm dlx ecc-universal setup` |
| Yarn 2+ | `yarn dlx ecc-universal setup` |
| Bun | `bunx ecc-universal setup` |
Yarn Classic 1 не надає `yarn dlx`; використовуйте `npx`, встановіть пакет глобально, або оновіть Yarn для тимчасового одноразового запуску після публікації 2.2.
Майстер інвентаризує офіційний маркетплейс і кожен нативний рівень встановлення Claude перед внесенням змін, потім встановлює, оновлює чи безпечно переміщує `ecc@ecc` до обраного вами рівня. Повторно запускайте ту саму команду, коли хочете оновити ECC, змінити рівень чи змінити профіль хуків. Цей майстер налаштування наразі налаштовує плагін Claude Code; використовуйте мультиоболонковий майстер нижче для Codex чи Kimi Code.
Щоб налаштувати більше одного кодового агента в одному переглянутому потоці, використовуйте мультиоболонковий майстер:
```bash
npx ecc-universal install --guided
```
Він дозволяє обрати будь-яку комбінацію Claude Code, Codex та Kimi Code, показує кожен канал встановлення та призначення, попередньо перевіряє кожен вибір перед першим записом та запитує одне фінальне підтвердження.
| Оболонка | Поведінка керованого встановлення |
|---|---|
| Claude Code | Нативний плагін `ecc@ecc` з одним рівнем `user`, `project` чи `local` та профілем хуків ECC |
| Codex | Нативний життєвий цикл маркетплейсу/плагіна Codex; перегляд і довіра хуків залишаються за Codex |
| Kimi Code | Керовані файли проєкту під `./.kimi-code`; хуки ECC, налаштування моделі/провайдера та автентифікація не налаштовуються |
Для автоматизації зробіть кожен вибір, специфічний для провайдера, явним:
```bash
npx ecc-universal install --guided \
--harness claude --harness codex --harness kimi \
--claude-scope local --claude-hooks standard \
--profile core --yes
```
Перевірте нативний керований шлях Codex та керований шлях Kimi без запису:
npx ecc-universal install --profile core --target kimi --dry-run
```
Додаткові команди з назвою пакета також стануть доступні через псевдонім 2.2:
```bash
npx ecc-universal consult "security reviews" --target claude
npx ecc-universal install --profile minimal --target claude --with capability:machine-learning
npx ecc-universal doctor --target kimi
```
Не використовуйте `npx ecc-install --profile minimal --target claude`: `ecc-install` — це назва бінарного файлу всередині `ecc-universal`, а не окремо опублікований пакет npm.
ECC також постачає розширені керовані адаптери для `cursor`, `antigravity`, `gemini`, `opencode`, `codebuddy`, `joycode`, `qwen`, `zed`, `hermes` та `openclaw`. Ці цілі досі використовують свої задокументовані шляхи `ecc install --target ...`, поки кожен адаптер не пройде керовану матрицю життєвого циклу конфліктів, оновлень, ремонту та видалення. Жоден майстер не встановлює мовчки в кожну виявлену оболонку.
## Почніть використовувати ECC
Почніть з процесу, який вам потрібен, а не з повного каталогу.
| Що ви робите | Почніть тут |
|---|---|
| Створюєте функцію | `/ecc:plan "опишіть функцію"`, потім `tdd-workflow` |
| Виправляєте помилку | Відтворіть її непрохідним тестом, потім використовуйте `tdd-workflow` |
| Переглядаєте новий код | `/code-review` для перегляду зі свіжого контексту |
| Ремонтуєте збірку | `/build-fix` |
| Очищуєте кодову базу | `/refactor-clean` |
| Перевіряєте тиск контексту | `/context-budget` |
| Завершуєте довгу сесію | `/save-session` чи `/learn-eval` |
Слеш-форми нижче показані там, де вони залишаються частиною підтримуваної поверхні команд. Застарілі шими коротких назв, такі як `/tdd` та `/eval`, живуть у`legacy-command-shims/` лише для явного опційного підключення.
**Початок нової функції:**
```
/ecc:plan "Додати автентифікацію користувача з OAuth"
-> planner створює план реалізації
навичка tdd-workflow -> tdd-guide забезпечує написання тестів спочатку
/code-review -> code-reviewer перевіряє вашу роботу
```
**Виправлення помилки:**
```
навичка tdd-workflow -> tdd-guide: напишіть непрохідний тест, що відтворює її
-> реалізуйте виправлення, перевірте, що тест проходить
> **НОВЕ В ECC 2.1: Plan Canvas · оболонка Kimi · самостійне обслуговування на GPU Itô.**
> [Дивіться повні примітки до релізу →](https://github.com/affaan-m/ECC/blob/main/docs/releases/2.1.0/release-notes.md)
### Plan Canvas: переглядайте плани, вказуючи, а не передруковуючи
Ваш агент пише план, потім відкриває його в браузерному канвасі, доступному лише локально. Клацніть частину, яку маєте на увазі, додайте пронумеровані анотації, спілкуйтесь з бічної панелі та натисніть **Схвалити план** чи **Запросити зміни**. Вердикт відображається безпосередньо на воротах CONFIRM команди `/plan`. Діаграми Mermaid відображаються наживо, а зміни в файлі плану перезавантажують сторінку.
Це агностично до оболонки та моделі: простий CLI (`ecc-plan-canvas`), що говорить JSON, тому будь-який агент може ним керувати. Спробуйте: попросіть вашого агента виконати `/ecc:plan` щось, а потім переглядайте зі сторінки замість терміналу.
[Відкрити план, використаний у цьому демо →](https://github.com/affaan-m/ECC/blob/main/docs/releases/2.1.0/plan-canvas-demo.plan.md)
### Також у 2.1
- **Ціль встановлення Kimi Code** (`--target kimi`): ECC встановлюється нативно в Kimi Code CLI від [Moonshot AI](https://www.moonshot.ai)
- **Самостійний хостинг на GPU**: перевірений шлях з [Itô](https://compute.itomarkets.com), бажаним обчислювальним спонсором ECC, включно з опційним мостом RFQ `ecc ito find` (деталі та розкриття вище в опціях встановлення)
- **Moonshot AI (Kimi), Itô та Atlas Cloud** тепер публічні спонсори
- **Цілі встановлення Hermes + OpenClaw**, посібник з навігації Codex, консолідовані хуки PostToolUse та зміцнення ланцюжка поставок
### Поточна розробка: Уніфікованe сховище пам'яті
`ecc memory` надає Claude, Codex, Hermes, OpenClaw, Kimi та іншим оболонкам єдиний локальний, доступний для перегляду формат Markdown для тривалого контексту та передавання. Опційний stdio-сервер `ecc-memory-mcp` надає ту саму обмежену поверхню збереження/пошуку/читання/діагностики, не вмикаючи себе за замовчуванням. Повні деталі в розділі [Ділитеся контекстом між оболонками](#ділитеся-контекстом-між-оболонками) нижче.
### v2.0.0: Операційна система агентних оболонок (черв. 2026)
Стабільна градація лінійки 2.0: субстрат площини управління (адаптери сесій + інвентаризація MCP), служба життєвого циклу worktree, родина оркестраторів `orch-*` та запуск [спільноти ECC Discord](https://discord.gg/36yGMHGFbR). Повні примітки: [docs/releases/2.0.0/release-notes.md](../../docs/releases/2.0.0/release-notes.md).
### v2.0.0-rc.1: Оновлення поверхні, оператори процеси та альфа ECC 2.0 (квіт. 2026)
- **GUI панель керування**: нова настільна програма на основі Tkinter (`ecc_dashboard.py` чи `npm run dashboard`) з перемикачем темної/світлої теми, налаштуванням шрифту та логотипом проєкту в заголовку та панелі задач.
- **Публічна поверхня синхронізована з живим репозиторієм**: метадані, кількість у каталозі, маніфести плагінів і документація зі встановлення тепер відповідають фактичній OSS-поверхні.
- **Розширення операторних і вихідних процесів**: `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` та вдосконалені поверхні публікації в соцмережах роблять технічні роз'яснення та контент для запуску частиною тієї ж системи.
- **Зростання фреймворків і продуктових поверхонь**: `nestjs-patterns`, більш насичені поверхні встановлення Codex/OpenCode та розширена крос-оболонкова упаковка роблять репозиторій придатним для використання поза межами однієї оболонки.
- **Пакет навичок Itô для ринків прогнозів**: `ito-market-intelligence`, `ito-basket-compare`, `ito-trade-planner`, `ito-data-atlas-agent`, `prediction-market-oracle-research` та `prediction-market-risk-review` додають публічні, неконсультативні ринкові/кошикові процеси, зберігаючи живий доступ до API Itô окремим від білінгу ECC Tools.
- **Пакет навичок оптимізації**: `parallel-execution-optimizer`, `benchmark-optimization-loop`, `data-throughput-accelerator`, `latency-critical-systems` та `recursive-decision-ledger` перетворюють повторювані запити про швидкість/рекурсію на обмежені процеси тестування продуктивності, пропускної здатності та журналу рішень.
- **ECC 2.0 alpha у дереві**: прототип площини управління на Rust у `ecc2/` збирається локально та надає команди `dashboard`, `start`, `sessions`, `status`, `stop`, `resume` та `daemon`.
- **Знімки статусу оператора**: `ecc status --markdown --write status.md` перетворює локальне сховище стану на портативне передавання, яке охоплює готовність, активні сесії, стан виконання навичок, стан встановлення, очікувані події управління та пов'язані робочі елементи з Linear/GitHub/handoffs.
- **Зміцнення екосистеми**: AgentShield, контроль витрат ECC Tools, робота з білінг-порталом та оновлення вебсайту продовжують поставлятись навколо основного плагіна замість того, щоб дрейфувати в окремі силоси.
### 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`, `bun-runtime`, `nextjs-turbopack`, 8 навичок для операційних доменів та `mcp-server-patterns`.
- **Інфраструктура сесій та стану**: сховище стану SQLite з CLI запитів, адаптери сесій для структурованого запису, фундамент для саморозвиваючих навичок.
- **Переробка оркестрації**: детермінована оцінка аудиту оболонок, зміцнений статус оркестрації та сумісність запускачів, захист від циклів спостерігача з 5-шаровою охороною.
- **Надійність спостерігача**: виправлення вибуху пам'яті з обмеженням та вибіркою хвоста, виправлення доступу до пісочниці, логіка відкладеного запуску та захист від повторного входу.
- **12 мовних екосистем**: нові правила для Java, PHP, Perl, Kotlin/Android/KMP, C++ та Rust доповнюють існуючі TypeScript, Python, Go та загальні правила.
- **Внески спільноти**: переклади корейською та китайською, оптимізація biome hook, навички відеообробки, операційні навички, PowerShell-інсталятор, підтримка Antigravity IDE.
- **Зміцнення CI**: 19 виправлень помилок тестів, примусовий підрахунок каталогу, валідація маніфесту встановлення та повний набір тестів зелений.
### v1.8.0: Система продуктивності оболонок (бер. 2026)
- **Першочерговий випуск для оболонок**: ECC явно позиціонується як система продуктивності агентних оболонок, а не просто пакет конфігурацій.
- **Переробка надійності хуків**: резервний шлях SessionStart, підсумки сесій на фазі Stop та хуки на основі скриптів замість ненадійних однорядкових.
- **Елементи управління виконанням хуків**: `ECC_HOOK_PROFILE=minimal|standard|strict` та `ECC_DISABLED_HOOKS=...` для управління під час виконання без редагування файлів хуків.
- **Нові команди оболонки**: `/harness-audit`, `/loop-start`, `/loop-status`, `/quality-gate`, `/model-route`.
- **Крос-оболонковий паритет**: поведінка вирівняна між Claude Code, Cursor, OpenCode та Codex app/CLI.
- **997 внутрішніх тестів пройдено**: повний набір тестів зелений після рефакторингу хуків/виконання та оновлень сумісності.
### v1.7.0: Крос-платформне розширення та конструктор презентацій (лют. 2026)
- **Підтримка Codex app + CLI**: пряма підтримка Codex на основі `AGENTS.md`, цільове встановлення та документація Codex.
- **Навичка `frontend-slides`**: конструктор HTML-презентацій без залежностей з керівництвом щодо конвертації PPTX та строгими правилами відповідності вьюпорту.
- **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**: ECC Tools GitHub App доступний на [github.com/marketplace/ecc-tools](https://github.com/marketplace/ecc-tools) з безкоштовним/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/ECC/issues/148), [#161](https://github.com/affaan-m/ECC/pull/161))
### v1.4.0: Мультимовні правила, майстер встановлення та PM2 (лют. 2026)
- **Інтерактивний майстер встановлення**: нова навичка `configure-ecc` забезпечує кероване налаштування з виявленням злиття/перезапису.
- **PM2 та мультиагентна оркестрація**: 6 нових команд (`/pm2`, `/multi-plan`, `/multi-execute`, `/multi-backend`, `/multi-frontend`, `/multi-workflow`) для управління складними мультисервісними процесами.
- **Архітектура мультимовних правил**: правила реструктуровані з плоских файлів у директорії `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+ типів подій).
- **3 нативних власних інструменти**: run-tests, check-coverage, security-audit.
- **LLM-документація**: `llms.txt` для повної документації OpenCode для LLM.
### v1.2.0: Уніфіковані команди та навички (лют. 2026)
- **Підтримка Python/Django**: навички Django patterns, security, TDD та verification.
- **Навички Java Spring Boot**: patterns, security, TDD та verification для Spring Boot.
- **Управління сесіями**: команда `/sessions` для історії сесій.
- **Безперервне навчання v2**: навчання на основі інстинктів з оцінюванням довіри, імпортом/експортом, еволюцією.
Повний журнал змін у [Releases](https://github.com/affaan-m/ECC/releases).
| Плани зникають в історії чату | Плани стають редагованими артефактами перед початком реалізації |
| "Будь ласка, використовуй TDD" — це інструкція, яку модель може забути | TDD стає воротовим процесом ЧЕРВОНИЙ -> ЗЕЛЕНИЙ -> РЕФАКТОРИНГ з доказами |
| Той самий контекст пише й переглядає код | Рецензент зі свіжим контекстом шукає регресії та сліпі зони |
| Пам'ять означає збереження величезної стенограми | Сесії дистилюються в підсумки, інстинкти та навички для повторного використання |
| Перевірки якості залежать від нагадувань | Хуки можуть примусово виконувати детерміновані перевірки поза промптом |
| Конфігурація агента довіряється за замовчуванням | AgentShield сканує саму оболонку як поверхню атаки |
### TDD: розробка через тестування
```text
/ecc:plan "Додати сповіщення про білінг на основі використання"
-> підтвердіть чи відредагуйте план
-> активуйте tdd-workflow
-> зафіксуйте докази ЧЕРВОНИЙ перед реалізацією
-> реалізуйте до ЗЕЛЕНОГО
-> перегляньте зі свіжого контексту
-> виправте знахідки з регресійними тестами
-> перевірте збірку, лінт, типи та тести
```
Результат — це не просто код. Це слід доказів: план, непрохідний тест, прохідний тест, знахідки перегляду та фінальна перевірка.
### Навички тримають контекст сфокусованим
Правила, навички, агенти та хуки вирішують різні проблеми. Тримати ці завдання окремо — ось як ECC додає можливості, не скидаючи весь репозиторій у кожну сесію.
| Концепція | Що це робить | Поведінка контексту |
|---|---|---|
| Навички | Повторно використовувані процеси, такі як TDD, перегляд безпеки чи глибоке дослідження | Завантажуються, коли завдання їх потребує |
| Агенти | Обмежені за обсягом працівники з власним контекстом і дозволами на інструменти | Ізолюють планування, реалізацію та перегляд |
| Правила | Тривалі стандарти проєкту чи мови | Завжди завантажені, тому встановлюйте їх вибірково |
| Хуки | Скрипти, викликані подіями оболонки | Виконуються поза контекстом моделі |
| Інстинкти | Патерни, вивчені з реальних сесій з оцінкою довіри | Пригадуються, коли релевантні |
### Ділитеся контекстом між оболонками
Сховище пам'яті ECC надає Claude, Codex, Hermes, OpenClaw, Kimi та іншим оболонкам єдиний локальний, доступний для перегляду формат Markdown для тривалого контексту та передавання. Пам'ять проєкту та команди живе під `.ecc/memory/`; пам'ять користувача живе під `~/.ecc/memory/`.
Пам'ять — це неперевірений контекст, а не виконувана політика. Перевіряйте важливі твердження за авторитетними джерелами та переносьте прийняті знання в керовану документацію проєкту. Опційний сервер `ecc-memory-mcp` надає ту саму обмежену поверхню збереження, пошуку, читання та діагностики, не вмикаючи себе за замовчуванням.
[Відкрити процес Уніфікованої пам'яті →](../../skills/unified-memory/SKILL.md)
<details>
<summary><strong>Сховище пам'яті детально: обсяги, передавання та межі довіри</strong></summary>
Сховище пам'яті зберігає портативні документи Markdown `ecc.memory.v1` замість копіювання транскриптів постачальника чи надсилання контексту між агентами електронною поштою. Пам'ять проєкту захищена fail-closed `.gitignore`; використовуйте обсяг команди лише для перевіреного людиною, версіонованого поширення. Пам'ять команди залишається неперевіреним контекстом навіть після коміту.
Встановлення лише навичок, мінімальні, ручні та встановлення через плагін Claude не розміщують середовище виконання Сховища пам'яті на `PATH`. Встановіть середовище виконання npm окремо перед використанням CLI чи опційного MCP-сервера:
```bash
npm install -g ecc-universal
ecc memory --help
command -v ecc-memory-mcp
```
```bash
# Ініціалізуйте сховище проєкту.
ecc memory init --scope project
# Запишіть тіло передавання у звичайний файл, потім націльтеся на наступну оболонку.
# Перевірте сховище перед поширенням пам'яті команди.
ecc memory doctor
```
Тіла пам'яті приймаються лише через `--stdin` чи `--body-file`, а не як значення командного рядка. Перший реліз тримає кожен запис сховища неперевіреним і лише для створення; людський перегляд переносить прийняті знання в керовану документацію проєкту, а не змінює довіру до пам'яті. Звичайний пошук пригадування повертає активну пам'ять проєкту та команди. Пряме читання за ID може перевірити неактивний запис. Пригадування на рівні користувача повинно бути запитане явно. Агенти повинні перевіряти важливі твердження за авторитетними джерелами і ніколи не повинні розглядати пригадані тіла як виконувані інструкції чи політику.
Для опційного доступу через MCP додайте запис `ecc-memory-vault` з [`mcp-configs/mcp-servers.json`](../../mcp-configs/mcp-servers.json) до кожної оболонки, якій він потрібен, потім запустіть `ecc-memory-mcp`. Сервер надає лише `memory_save`, `memory_search`, `memory_read` та `memory_doctor`. Кожен сервер повинен запускатися з ідентичністю `ECC_MEMORY_HARNESS` у нижньому регістрі; ідентичність прив'язана до сервера і не може надаватися викликачем інструменту. Обсяг користувача додатково вимагає опційне підключення `ECC_MEMORY_ALLOW_USER_SCOPE=1`, кероване оператором. Дивіться [`skills/unified-memory/SKILL.md`](../../skills/unified-memory/SKILL.md) для процесу та меж довіри, і [`docs/design/ecc-memory-vault.md`](../../docs/design/ecc-memory-vault.md) для контракту можливостей.
</details>
## Посібники
Цей репозиторій — сирий код. Посібники пояснюють усе.
<table aria-label="Посібники ECC" width="100%">
<tr>
<td width="33%" align="center">
<a href="../../the-shortform-guide.md">
<img src="../../assets/images/guides/shorthand-guide.png" width="213" height="120" alt="Короткий посібник з ECC" /><br />
<strong>Короткий посібник</strong>
</a>
<br /><sub>Налаштування, основи та використання з першого дня. <b>Читайте спочатку.</b> (<a href="https://x.com/affaan/status/2012378465664745795">нитка</a>)</sub>
</td>
<td width="33%" align="center">
<a href="../../the-longform-guide.md">
<img src="../../assets/images/guides/longform-guide.png" width="213" height="120" alt="Розширений посібник з ECC" /><br />
<strong>Розширений посібник</strong>
</a>
<br /><sub>Економіка контексту, пам'ять, оцінки та паралельні агенти. (<a href="https://x.com/affaan/status/2014040193557471352">нитка</a>)</sub>
</td>
<td width="33%" align="center">
<a href="../../the-security-guide.md">
<img src="../../assets/images/guides/security-guide.png" width="213" height="120" alt="Посібник з безпеки ECC" /><br />
<strong>Посібник з безпеки</strong>
</a>
<br /><sub>Ін'єкція промптів, хуки, MCP та AgentShield. (<a href="https://x.com/affaan/status/2033263813387223421">нитка</a>)</sub>
</td>
</tr>
</table>
| Тема | Що ви дізнаєтесь |
|-------|-------------------|
| Оптимізація токенів | Вибір моделі, скорочення системного промпту, фонові процеси |
| Збереження пам'яті | Хуки, що автоматично зберігають/завантажують контекст між сесіями |
| Безперервне навчання | Автовитягування патернів із сесій у навички для повторного використання |
| Петлі верифікації | Контрольні точки проти безперервних оцінок, типи оцінювачів, метрики pass@k |
Повний анотований каталог (агенти, навички, команди, правила, хуки, скрипти) синхронізований з англомовним README — дивіться [оригінальний README](../../README.md#annotated-component-catalog) для найсвіжішого детального списку кожного файлу, оскільки він оновлюється при кожному релізі.
- **Файли SKILL.md**: готові до використання навички для активної оболонки
- **Колекції інстинктів**: для continuous-learning-v2
- **Витягування патернів**: навчається з вашої git-історії
</details>
<details>
<summary><strong>AgentShield: аудитор безпеки для конфігурацій агентів</strong></summary>
> Створений на Claude Code Hackathon (Cerebral Valley x Anthropic, лют. 2026). 1282 тести, 98% покриття, 102 правила статичного аналізу.
Скануйте вашу конфігурацію агента на вразливості, помилкові конфігурації та ризики ін'єкцій.
```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, хуки, визначення агентів та навички по 5 категоріях: виявлення секретів (14 патернів), аудит дозволів, аналіз ін'єкцій хуків, профілювання ризиків MCP-серверів та перевірка конфігурації агентів.
**Прапорець `--opus`** запускає три агенти Claude Opus 4.6 у конвеєрі атакуючий/захисник/аудитор. Атакуючий знаходить ланцюжки вразливостей, захисник оцінює захисти, а аудитор синтезує обох у пріоритизовану оцінку ризиків. Адверсарне міркування, а не просто зіставлення патернів.
**Формати виводу:** термінал (кольорова градація A-F), JSON (CI-конвеєри), Markdown, HTML. Код виходу 2 при критичних знахідках для воріт збирання.
Використовуйте `/security-scan`у Claude Code для запуску, або додайте до CI через [GitHub Action](https://github.com/affaan-m/agentshield).
<summary><strong>Безперервне навчання v2: інстинкти</strong></summary>
Система навчання на основі інстинктів автоматично вивчає ваші патерни:
```bash
/instinct-status # Показати вивчені інстинкти з довірою
/instinct-import <file> # Імпортувати інстинкти від інших
/instinct-export # Експортувати ваші інстинкти для поширення
/evolve # Кластеризувати пов'язані інстинкти в навички
```
Дивіться `skills/continuous-learning-v2/` для повної документації. Зберігайте `continuous-learning/` лише якщо вам явно потрібен застарілий потік v1 Stop-hook з вивченими навичками.
Навички є основною поверхнею процесів. Вони можуть викликатися безпосередньо, пропонуватися автоматично та повторно використовуватися агентами. ECC все ще постачає підтримувані `commands/` під час міграції, тоді як застарілі шими коротких назв живуть під `legacy-command-shims/` лише для явного опційного підключення. Нова розробка процесів має відбуватися в `skills/` насамперед.
Основний Node.js CLI ECC та керовані інсталятори працюють на **Windows, macOS та Linux**, але опційні можливості не мають повного паритету. Деякі шляхи безперервного навчання, GAN та оркестрації досі вимагають Bash чи Python; оболонки також надають різні API хуків, агентів та навичок.
| Linux | Підтримується основний | Опційні функції можуть вимагати Bash, Python чи інструменти конкретного провайдера. |
| macOS | Підтримується основний | Автономний шлях GAN shell не сумісний із системним Bash 3.2 і наразі має дефект розбору оцінок ([#2674](https://github.com/affaan-m/ECC/issues/2674)). |
| Windows + WSL | Підтримується основний | WSL слідує шляхам Linux; інтеграції з хостом Windows все ще відрізняються залежно від оболонки. |
| Windows нативний | Підтримується з обмеженнями | Демон спостерігача та записи сховища пам'яті continuous-learning v2 мають відкриті дефекти на нативному Windows ([#2489](https://github.com/affaan-m/ECC/issues/2489), [#2626](https://github.com/affaan-m/ECC/issues/2626)). Опційні функції на основі shell вимагають Git Bash/WSL чи недоступні. |
Хуки збереження пам'яті (підсумки сесій, вивчені навички, псевдоніми сесій, метрики) зберігають дані під єдиним кореневим каталогом даних агента. За замовчуванням це `~/.claude`. При використанні ECC у Claude Code та Cursor на одному комп'ютері встановіть окремий корінь для Cursor, щоб два середовища не перезаписували файли сесій одне одного:
| Оболонка | Статус | Рекомендований дистрибутив | Важливе обмеження |
|---|---|---|---|
| Claude Code | Стабільна основна | Плагін чи вибірковий інсталятор | Плагін рекламує встановлений каталог моделі; використовуйте вибірковий/ручний профіль, коли важливий обсяг контексту. Опційні навички на основі shell не портативні на кожну ОС. |
| Codex | Підтримувана синхронізація; маркетплейс експериментальний | Конфігурація репозиторію чи `sync-ecc-to-codex.sh` | Немає середовища виконання хуків ECC. Пакет маркетплейсу може пропускати спільний вміст репозиторію з кешу Codex; використовуйте синхронізацію для надійного шляху. |
| Cursor | Бета-адаптер проєкту | Вибірковий інсталятор у `.cursor/` | Виявлення агентів залежить від збірки Cursor, а шляхи інсталятора ECC ще не показують ідентичні набори хуків ([#2419](https://github.com/affaan-m/ECC/issues/2419)). |
| OpenCode | Бета зібраний плагін | Зберіть плагін, потім вибірковий інсталятор | ECC постачає підмножину каталогу, а еталонна конфігурація прив'язує моделі Anthropic; оберіть моделі, доступні вашому провайдеру ([#2617](https://github.com/affaan-m/ECC/issues/2617)). |
| GitHub Copilot | Лише інструкції | Закомічені інструкції та файли промптів | Немає хуків ECC, агентів часу виконання, делегування чи нативного виявлення навичок. |
| Gemini, Zed, Antigravity, Qwen, Hermes, OpenClaw, Kimi, CodeBuddy, JoyCode | Експериментальні/мінімальні адаптери | Ціль вибіркова для оболонки | Розміщення файлів та портативність інструкцій перевірені; повний паритет функцій Claude не заявляється. |
### Карта крос-інструментальних можливостей
| Можливість | Claude Code | Codex | Cursor | OpenCode | GitHub Copilot |
| Навички | Нативний встановлений набір | Нативний синхронізований набір | Набір проєкту залежно від збірки | Вбудована підмножина | Лише посилання на промпти/інструкції |
| Агенти/делегування | Нативні агенти | Мультиагентні ролі Codex | Агенти проєкту залежно від збірки | Агенти плагіна | Не підтримується |
| Хуки ECC | Нативні хуки плагіна | Не підтримується | Адаптер хуків Cursor; відмінності шляхів встановлення залишаються | Події плагіна | Не підтримується |
| Конфігурація MCP | Доступна, явна активація | Злиття TOML через синхронізацію | Явна конфігурація проєкту/користувача | Конфігурація провайдера/плагіна | Не надається ECC |
| Паритет з Claude Code | Основний еталон | Частковий | Частковий | Частковий | Не є ціллю паритету |
**Ключові архітектурні рішення:**
- **AGENTS.md** у корені — універсальний крос-інструментальний файл (читається Claude Code, Cursor, Codex та OpenCode; GitHub Copilot використовує `.github/copilot-instructions.md` замість нього)
- **Патерн DRY-адаптера** дозволяє Cursor повторно використовувати скрипти хуків Claude Code без дублювання
- **Формат навичок** (SKILL.md з YAML frontmatter) працює у Claude Code, Codex та OpenCode
- Відсутність хуків у Codex компенсується `AGENTS.md`, опційними перевизначеннями `model_instructions_file` та дозволами пісочниці
ECC не встановлює кореневий `AGENTS.md` в `.cursor/`. Cursor трактує вкладені файли `AGENTS.md` як контекст директорії, тому копіювання ідентичності репозиторію ECC в проєкт-хост забруднило б цей проєкт.
Нативна поведінка завантаження Cursor може відрізнятися залежно від збірки Cursor. ECC встановлює агентів як `.cursor/agents/ecc-*.md`; якщо ваша збірка Cursor не показує агентів проєкту, ці файли все одно працюють як явні довідкові визначення замість прихованого глобального контексту промпту.
#### Ізоляція пам'яті та даних (Cursor + Claude Code)
Хуки пам'яті ECC повторно використовують ті самі `scripts/hooks/*.js`, що й Claude Code. Для Cursor ECC намагається автоматично тримати пам'ять **поза `~/.claude`**:
1.**Хук `sessionStart` Cursor** (встановлюється в `.cursor/hooks.json` при `--target cursor`) вводить `ECC_AGENT_DATA_HOME` для всієї сесії composer.
2.**Стандарт середовища виконання хуків**: коли присутні `CURSOR_VERSION` чи `CURSOR_PROJECT_DIR`, хуки за замовчуванням використовують `~/.cursor/ecc`, якщо змінна середовища не встановлена.
3.**Конфіг проєкту**: `.cursor/ecc-agent-data.json` документує та перевизначає шлях (`agentDataHome`).
4.**Завжди-увімкнене правило**: `.cursor/rules/ecc-agent-data-home.mdc` нагадує агенту, де живе пам'ять.
Ви все ще можете явно перевизначити:
```bash
exportECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"
```
Щоб **поділитися** пам'яттю з Claude Code навмисно, встановіть `ECC_AGENT_DATA_HOME=~/.claude`у shell чи в `.cursor/ecc-agent-data.json`.
Інстинкти continuous learning v2 залишаються окремо під `CLV2_HOMUNCULUS_DIR` (за замовчуванням `~/.local/share/ecc-homunculus`).
#### Архітектура хуків (DRY-патерн адаптера)
Cursor має **більше подій хуків, ніж Claude Code** (20 проти 8). Модуль `.cursor/hooks/adapter.js` перетворює вхідний JSON Cursor у формат Claude Code, дозволяючи повторно використовувати існуючі `scripts/hooks/*.js` без дублювання.
description:"TypeScript coding style extending common rules"
globs:["**/*.ts","**/*.tsx","**/*.js","**/*.jsx"]
alwaysApply:false
---
```
</details>
<details>
<summary><strong>Детальна підтримка Codex macOS app + CLI</strong></summary>
ECC надає підтримуваний шлях репо/синхронізації Codex для macOS-додатка та CLI, з еталонною конфігурацією, Codex-специфічним доповненням AGENTS.md та спільними навичками. Маршрут маркетплейсу ECC залишається експериментальним. Для навігації по репозиторію, володіння поверхнями та настанов щодо пакетів diff для PR почніть з [`docs/CODEX-NAVIGATION-GUIDE.md`](../../docs/CODEX-NAVIGATION-GUIDE.md).
```bash
# Запустіть Codex CLI в репозиторії: AGENTS.md та .codex/ виявляються автоматично
# Або вручну: скопіюйте еталонну конфігурацію у вашу домашню директорію
cp .codex/config.toml ~/.codex/config.toml
```
Скрипт синхронізації безпечно зливає MCP-сервери ECC в наявний `~/.codex/config.toml`, використовуючи стратегію **лише додавання**: він ніколи не видаляє й не змінює ваші наявні сервери. Запустіть з `--dry-run` для попереднього перегляду змін, чи `--update-mcp`, щоб примусово оновити сервери ECC до останньої рекомендованої конфігурації.
Для Context7 ECC використовує канонічну назву розділу Codex `[mcp_servers.context7]`, все ще запускаючи пакет `@upstash/context7-mcp`. Якщо у вас вже є застарілий запис `[mcp_servers.context7-mcp]`, `--update-mcp` мігрує його до канонічної назви розділу.
Codex macOS app:
- Відкрийте цей репозиторій як робочу область.
- Кореневий `AGENTS.md` виявляється автоматично.
-`.codex/config.toml` та `.codex/agents/*.toml` працюють найкраще, коли залишаються локальними для проєкту.
- Еталонний `.codex/config.toml` навмисно не прив'язує `model` чи `model_provider`, тому Codex використовує свій поточний стандарт, якщо ви не перевизначите його.
- Опційно: скопіюйте `.codex/config.toml` в `~/.codex/config.toml` для глобальних стандартів; тримайте файли ролей мультиагента локальними для проєкту, якщо ви також не копіюєте `.codex/agents/`.
Навички в `.agents/skills/` автоматично завантажуються Codex. Канонічні навички Anthropic, такі як `claude-api`, `frontend-design` та `skill-creator`, навмисно не перевбудовані тут. Встановлюйте їх з [`anthropics/skills`](https://github.com/anthropics/skills), коли хочете офіційні версії.
#### Ключове обмеження
Codex **ще не забезпечує паритет виконання хуків у стилі Claude**. Примусове виконання ECC там базується на інструкціях через `AGENTS.md`, опційні перевизначення `model_instructions_file` та налаштування пісочниці/затвердження.
#### Підтримка мультиагентності
Поточні збірки Codex підтримують стабільні мультиагентні процеси.
- Увімкніть `features.multi_agent = true` в `.codex/config.toml`
- Визначте ролі під `[agents.<name>]`
- Вкажіть кожну роль на файл під `.codex/agents/`
- Використовуйте `/agent` в CLI для перевірки чи керування дочірніми агентами
ECC постачає три приклади конфігурацій ролей:
| Роль | Призначення |
|------|---------|
| `explorer` | Збір доказів кодової бази лише для читання перед редагуванням |
| `reviewer` | Перегляд правильності, безпеки та відсутніх тестів |
| `docs_researcher` | Перевірка документації та API перед релізом/змінами документації |
</details>
<details>
<summary><strong>Підтримка Zed</strong></summary>
ECC надає підтримку проєктів Zed через консервативний адаптер `.zed` для локальних для проєкту налаштувань, вирівняних правил, агентів, команд та навичок.
```bash
./install.sh --profile minimal --target zed
```
```powershell
.\install.ps1--profileminimal--targetzed
```
Адаптер записує керовані ECC файли під `.zed/` і тримає облікові дані BYOK/OpenRouter поза репозиторієм. Налаштуйте обліковий запис Zed чи API-ключі через власний UI налаштувань Zed чи ваші локальні налаштування користувача.
</details>
<details>
<summary><strong>Детальна підтримка OpenCode</strong></summary>
ECC надає бета-інтеграцію плагіна OpenCode з інструкціями, підмножиною каталогу, командами, власними інструментами та подіями хуків. Він не надає паритет функцій з Claude Code, а еталонні ID моделей повинні існувати у налаштованого провайдера користувача.
```bash
# Встановіть OpenCode
npm install -g opencode
# Запустіть у корені репозиторію
opencode
```
Конфігурація виявляється автоматично з `.opencode/opencode.json`.
#### Підтримка хуків через плагіни
Система плагінів OpenCode має 20+ типів подій:
| Хук Claude Code | Подія плагіна OpenCode |
|-----------------|----------------------|
| PreToolUse | `tool.execute.before` |
| PostToolUse | `tool.execute.after` |
| Stop | `session.idle` |
| SessionStart | `session.created` |
| SessionEnd | `session.deleted` |
**Додаткові події OpenCode**: `file.edited`, `file.watcher.updated`, `message.updated`, `lsp.client.diagnostics`, `tui.toast.show` та інші.
#### Встановлення плагіна
**Варіант 1: Використовувати напряму**
```bash
cd ECC
opencode
```
**Варіант 2: Встановити як npm-пакет**
```bash
npm install ecc-universal
```
Потім додайте до вашого `opencode.json`:
```json
{
"plugin":["ecc-universal"]
}
```
Цей запис npm-плагіна вмикає опублікований плагін-модуль OpenCode від ECC (хуки/події та інструменти плагіна). Він **не** автоматично додає повний каталог команд/агентів/інструкцій ECC до конфігурації вашого проєкту.
Для повного налаштування ECC OpenCode або:
- запустіть OpenCode всередині цього репозиторію, або
- скопіюйте вбудовані ресурси конфігурації `.opencode/` у ваш проєкт і підключіть записи `instructions`, `agent` та `command` в `opencode.json`
#### Документація
- **Посібник з міграції**: `.opencode/MIGRATION.md`
- **LLM-документація**: `llms.txt` (повна документація OpenCode для LLM)
</details>
<details>
<summary><strong>Детальна підтримка GitHub Copilot</strong></summary>
ECC надає **підтримку GitHub Copilot** для VS Code через нативну систему інструкційних та промпт-файлів Copilot Chat. Додаткові інструменти не потрібні.
#### Що включено для GitHub Copilot
| Компонент | Файл | Призначення |
|-----------|------|---------|
| Основні інструкції | `.github/copilot-instructions.md` | Завжди завантажувані правила: стиль коду, безпека, тестування, git-процес |
| Налаштування VS Code | `.vscode/settings.json` | Файли інструкцій для конкретних завдань: генерація коду, генерація тестів, повідомлення комітів |
| Промпт plan | `.github/prompts/plan.prompt.md` | Поетапне планування реалізації |
| Промпт TDD | `.github/prompts/tdd.prompt.md` | Цикл Червоний-Зелений-Покращення |
| Промпт перевірки безпеки | `.github/prompts/security-review.prompt.md` | Глибокий аналіз безпеки за OWASP |
| Промпт виправлення збирання | `.github/prompts/build-fix.prompt.md` | Систематичне вирішення помилок збирання та CI |
Файли вже на місці: відкрийте будь-який репозиторій, що містить цей проєкт, і GitHub Copilot Chat автоматично підхопить `.github/copilot-instructions.md`. Закомічений `.vscode/settings.json` вмикає `chat.promptFiles`, щоб VS Code міг завантажувати повторно використовувані промпти з `.github/prompts/`.
Щоб використовувати промпти процесів у Copilot Chat:
1. Відкрийте панель Copilot Chat у VS Code.
2. Клацніть іконку **скріпки / прикріпити** та оберіть **Prompt...**, або введіть `/` та оберіть промпт.
3. Оберіть промпт (наприклад, `plan`, `tdd`, `security-review`).
#### Покриття функцій
| Функція ECC | Еквівалент Copilot |
|-------------|-------------------|
| Стандарти кодування | Завжди увімкнено через `copilot-instructions.md` |
| Контрольний список безпеки | Завжди увімкнено + промпт `security-review` |
| Перегляд коду | Зовнішній перегляд PR через CodeRabbit + Greptile |
| Вирішення помилок збірки | Промпт `build-fix` |
| Рефакторинг | Промпт `refactor` |
| Формат повідомлень комітів | Інструкція для конкретного завдання в `settings.json` |
| Хуки / автоматизація | Не підтримується (Copilot не має системи хуків) |
| Агенти / делегування | Не підтримується (Copilot не має API підагентів) |
#### Обмеження
GitHub Copilot не має системи хуків чи API підагентів, тому автоматизації хуків ECC (автоформат, перевірка TypeScript, збереження сесій, захист dev-сервера) та делегування агентів недоступні. Шар інструкцій та промптів все ж привносить повну філософію кодування ECC (стандарти, безпеку, TDD та процес) у кожну сесію Copilot Chat.
</details>
<details>
<summary><strong>Що змінилося у v2.0.0</strong></summary>
- [Посібник з налаштування Hermes](../../docs/HERMES-SETUP.md)
- [Посібник з міграції з 1.x](../../docs/MIGRATION-1X-TO-2.0.md)
</details>
## Оптимізація токенів
Використання агента може бути дорогим, якщо не керувати споживанням токенів. Ці налаштування значно знижують витрати без шкоди для якості. Повний посібник: [docs/token-optimization.md](../../docs/token-optimization.md).
| `/clear` | Між непов'язаними завданнями (безкоштовно, миттєве скидання) |
| `/compact` | У логічних точках зупинки завдань (дослідження завершено, milestone досягнуто) |
| `/cost` | Моніторинг витрат токенів під час сесії |
Якщо ви використовуєте підписку і оцінки API-рейту монітора контексту не корисні, встановіть `ECC_CONTEXT_MONITOR_COST_WARNINGS=off`. Це лише пригнічує попередження витрат для агента; воно не вимикає попередження про вичерпання контексту, обсяг чи цикли.
Навичка `strategic-compact` пропонує `/compact` у логічних точках зупинки замість покладання на автокомпакшн при 95% контексту. Дивіться `skills/strategic-compact/SKILL.md` для повного посібника з рішень.
**Коли компактувати:**
- Після дослідження/вивчення, перед реалізацією
- Після завершення milestone, перед початком наступного
- Після налагодження, перед продовженням роботи з функцією
- Після невдалого підходу, перед спробою нового
**Коли НЕ компактувати:**
- В середині реалізації (ви втратите назви змінних, шляхи до файлів, частковий стан)
**Критично:** Не вмикайте всі MCP одразу. Кожен опис MCP-інструменту витрачає токени з вашого вікна 200k, потенційно скорочуючи його до ~70k.
- Тримайте менше 10 MCP увімкненими на проєкт
- Тримайте менше 80 активних інструментів
- Використовуйте `/mcp` для вимкнення невикористовуваних MCP-серверів Claude Code; ці вибори часу виконання зберігаються в `~/.claude.json`
- Використовуйте `ECC_DISABLED_MCPS` лише для фільтрації конфігів MCP, згенерованих ECC, під час потоків встановлення/синхронізації
- Якщо контекст стає важким, запустіть `/context-budget` та видаліть непотрібні правила
**Попередження про вартість команд агентів:** Agent Teams породжує кілька контекстних вікон. Кожен товариш по команді споживає токени незалежно. Використовуйте лише для завдань, де паралелізм дає чітку цінність (мультимодульна робота, паралельні перегляди). Для простих послідовних завдань підагенти ефективніші за токенами.
</details>
## Вимоги
<details>
<summary><strong>Версія Claude Code CLI + поведінка автозавантаження хуків</strong></summary>
### Версія 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
```
**Передісторія:** Це спричинило повторювані цикли виправлення/відкату в цьому репозиторії ([#29](https://github.com/affaan-m/ECC/issues/29), [#52](https://github.com/affaan-m/ECC/issues/52), [#103](https://github.com/affaan-m/ECC/issues/103)). Поведінка змінювалася між версіями Claude Code, що призводило до плутанини. Тепер є регресійний тест для запобігання повторного введення цього.
- Пакети npm: [`ecc-universal`](https://www.npmjs.com/package/ecc-universal) та [`ecc-agentshield`](https://www.npmjs.com/package/ecc-agentshield)
- GitHub App: <https://github.com/apps/ecc-tools>
- Вебсайт: <https://ecc.tools>
Скануйте проєкт з AgentShield:
```bash
npx -y ecc-agentshield scan --path .
```
- **Повідомте про вразливість.** Використовуйте приватний процес у [SECURITY.md](../../SECURITY.md) (приватне звітування про вразливість GitHub). Будь ласка, не відкривайте публічні issues для звітів про безпеку.
- **Вбудовані захисні механізми.** GateGuard блокує деструктивні команди оболонки (включно з `rm`, force/path `git checkout` та деструктивним `find -exec`) перед їхнім виконанням; сканер IOC ланцюжка поставок запускається в CI; а AgentShield аудитує ваші власні поверхні агента, хуків, MCP, дозволів та секретів (`/security-scan`).
<details>
<summary><strong>Хуки, MCP-сервери та контроль контексту</strong></summary>
Хуки можуть виконувати команди оболонки, MCP-сервери можуть тримати облікові дані, а інструкції проєкту можуть потрапляти в контекст агента. Розглядайте всі три як виконувану конфігурацію.
Не копіюйте необроблений `hooks/hooks.json` в `~/.claude/settings.json` після встановлення плагіна. Сучасні версії Claude Code автоматично завантажують хуки плагіна, і друга копія може змусити їх спрацьовувати двічі.
Використовуйте `/mcp` для вимкнень часу виконання Claude Code; Claude Code зберігає ці вибори в `~/.claude.json`.
`ECC_DISABLED_MCPS` — це фільтр встановлення/синхронізації ECC, а не живий перемикач Claude Code.
Якщо контекст стає важким, запустіть `/context-budget`, видаліть непотрібні правила та вимкніть невикористовувані MCP-сервери. Дивіться [посібник з оптимізації токенів](../../docs/token-optimization.md).
</details>
Посилання з безпеки:
- [Політика безпеки](../../SECURITY.md)
- [Посібник з безпеки](../../the-security-guide.md)
- [Реагування на інциденти ланцюжка поставок](../../docs/security/supply-chain-incident-response.md)
## Усунення несправностей
<details>
<summary><strong>ECC з'являється двічі чи хуки спрацьовують двічі</strong></summary>
Звичайна причина — встановлення плагіна Claude, а потім запуск `./install.sh --profile full` поверх нього.
1. Видаліть встановлення плагіна Claude Code.
2. Запустіть `node scripts/ecc.js uninstall --dry-run` з чекауту ECC.
3. Видаліть додаткові папки правил, скопійовані вручну, які більше не потрібні.
4. Перевстановіть один раз, використовуючи один шлях.
Для перевірок, специфічних для хуків, дивіться [README хуків](../../hooks/README.md).
</details>
<details>
<summary><strong>Мої хуки не працюють / помилки "Duplicate hooks file"</strong></summary>
**НЕ додавайте поле `"hooks"` до `.claude-plugin/plugin.json`.** Claude Code v2.1+ автоматично завантажує `hooks/hooks.json` зі встановлених плагінів. Явне оголошення спричиняє помилки виявлення дублікатів. Дивіться [#29](https://github.com/affaan-m/ECC/issues/29), [#52](https://github.com/affaan-m/ECC/issues/52), [#103](https://github.com/affaan-m/ECC/issues/103).
</details>
<details>
<summary><strong>Маркетплейс Codex встановлюється, але навички не завантажуються</strong></summary>
Запустіть перевірку кешу з чекауту ECC:
```bash
node scripts/codex/check-plugin-cache.js
```
Якщо повідомляється про невирішені батьківські посилання, використовуйте `bash scripts/sync-ecc-to-codex.sh`. Реєстрація в `codex plugin list` підтверджує запис маркетплейсу, а не те, що кожен файл, на який є посилання, досягнув кешу плагіна. Завантаження навичок під час виконання з локальних/репо-маркетплейсів все ще ненадійне вище за течією ([openai/codex#26037](https://github.com/openai/codex/issues/26037)); дивіться [#2128](https://github.com/affaan-m/ECC/issues/2128) для повного дослідження.
Забагато MCP-серверів поглинає ваш контекст. Кожен опис MCP-інструменту витрачає токени з вашого вікна 200k, потенційно скорочуючи його до ~70k. Контекст SessionStart обмежений 8000 символами за замовчуванням; знизьте це за допомогою `ECC_SESSION_START_MAX_CHARS=4000` чи вимкніть за допомогою `ECC_SESSION_START_CONTEXT=off` для локальних моделей чи налаштувань з низьким контекстом.
**Виправлення:** вимкніть невикористовувані MCP з Claude Code за допомогою `/mcp`. Claude Code записує ці вибори часу виконання в `~/.claude.json`; `.claude/settings.json` та `.claude/settings.local.json` не є надійними перемикачами для вже завантажених MCP-серверів.
Тримайте менше 10 увімкнених MCP та менше 80 активних інструментів.
</details>
<details>
<summary><strong>Чи можу я використовувати лише деякі компоненти (наприклад, лише агентів)?</strong></summary>
Так. Використовуйте ручні копії компонентів у [Розширених опціях встановлення](#розширені-опції-встановлення) та копіюйте лише те, що вам потрібно:
```bash
# Лише агенти
cp agents/*.md ~/.claude/agents/
# Лише правила
mkdir -p ~/.claude/rules/ecc/
cp -r rules/common ~/.claude/rules/ecc/
```
Кожен компонент повністю незалежний.
</details>
<details>
<summary><strong>Чи це працює з Cursor / OpenCode / Codex / Antigravity / GitHub Copilot?</strong></summary>
Так. ECC є крос-платформним:
- **Cursor**: попередньо перекладені конфіги в `.cursor/`. Дивіться [Підтримку платформ](#підтримка-платформ).
- **Gemini CLI**: експериментальна локальна для проєкту підтримка через `.gemini/GEMINI.md` та спільну сантехніку інсталятора.
- **OpenCode**: бета-інтеграція плагіна в `.opencode/`; вибір моделі провайдера та паритет каталогу залишаються обмеженими.
- **Codex**: підтримуваний шлях репо/синхронізації для macOS-додатка та CLI; пакет маркетплейсу ECC залишається експериментальним.
- **GitHub Copilot (VS Code)**: шар інструкцій та промптів через `.github/copilot-instructions.md`, `.vscode/settings.json` та `.github/prompts/`.
- **Antigravity**: щільно інтегроване налаштування для процесів, навичок та вирівняних правил в `.agent/`. Дивіться [Посібник з Antigravity](../../docs/ANTIGRAVITY-GUIDE.md).
- **JoyCode / CodeBuddy**: локальні для проєкту вибіркові адаптери встановлення для команд, агентів, навичок та вирівняних правил. Дивіться [Посібник з адаптера JoyCode](../../docs/JOYCODE-GUIDE.md).
- **Qwen CLI**: домашній вибірковий адаптер встановлення для команд, агентів, навичок, правил та конфігурації Qwen. Дивіться [Посібник з адаптера Qwen CLI](../../docs/QWEN-GUIDE.md).
- **Zed**: локальний для проєкту вибірковий адаптер встановлення для `.zed/settings.json`, вирівняних правил, команд, агентів та навичок.
- **Не-нативні оболонки**: ручний резервний шлях для чат-подібних інтерфейсів. Дивіться [Посібник з ручної адаптації](../../docs/MANUAL-ADAPTATION-GUIDE.md).
- **Claude Code**: нативно. Це основна ціль.
</details>
<details>
<summary><strong>Моєї платформи немає в списку</strong></summary>
Використовуйте [посібник з ручної адаптації](../../docs/MANUAL-ADAPTATION-GUIDE.md), чи відкрийте [обговорення GitHub](https://github.com/affaan-m/ECC/discussions) з назвою оболонки та форматами файлів, навичок, команд і хуків, які вона підтримує.
Я використовую Claude Code з моменту експериментального впровадження. Виграв хакатон Anthropic x Forum Ventures у вер. 2025 разом з [@DRodriguezFX](https://x.com/DRodriguezFX) — побудував [zenith.chat](https://zenith.chat) повністю за допомогою агентних процесів.
ECC залишається безкоштовним, тому що спонсори та Pro-користувачі фінансують роботу. Логотипи спонсорів вгорі цього README; повний список та рівні в [SPONSORS.md](../../SPONSORS.md).
ECC Pro додає аналіз приватних репозиторіїв, аудити, викликані PR, сканування на основі AgentShield, автоматичні перевірки push та PR, об'єднане командне використання та пріоритетну підтримку через розміщений GitHub App.
<td width="25%" align="center"><a href="https://github.com/affaan-m/ECC/discussions"><strong>Спільнота</strong><br /><sub>Питання, ідеї та Show and Tell</sub></a></td>
<td width="25%" align="center"><a href="https://github.com/apps/ecc-tools"><strong>GitHub App</strong><br /><sub>Аудити PR та розміщені процеси</sub></a></td>
