ECC/docs/ua-UA at 75fb8a697dce632ca48c613df594b8c8ef342325 - ECC

mirror of https://github.com/affaan-m/ECC.git synced 2026-09-08 02:37:55 +02:00

Files

T

- add ukrainian translation of README.md
- share ua doc link through all concerned readmes

2026-06-24 14:34:20 +02:00

README.md

docs(ua):

2026-06-24 14:34:20 +02:00

README.md

Warning

Лише офіційні джерела. Встановлюйте ECC виключно з перевірених каналів: репозиторій GitHub github.com/affaan-m/ECC, пакети npm ecc-universal та ecc-agentshield, GitHub App, ідентифікатор плагіна ecc@ecc, та вебсайт проєкту ecc.tools. Сторонні перезавантаження та неофіційні дзеркала не підтримуються і не перевіряються проєктом та можуть містити шкідливе програмне забезпечення.

211,9K+ зірок | 32,5K+ форків | 230+ учасників | 12+ мовних екосистем | Крос-агентні робочі процеси

Мова / Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ / Idioma

Нативна оболонка операційної системи для агентної роботи. Побудована на основі реальних мультиоболонкових інженерних процесів.

Не просто конфігурації. Повна система: навички, інстинкти, оптимізація пам'яті, безперервне навчання, сканування безпеки та розробка з пріоритетом досліджень. Готові до продакшну агенти, навички, хуки, правила, конфігурації MCP та застарілі командні шими, що розвивалися протягом 10+ місяців інтенсивного щоденного використання при створенні реальних продуктів.

Працює на Codex, Claude Code, Cursor, OpenCode, Gemini, Zed, GitHub Copilot та інших оболонках агентів ШІ.

ECC v2.0.0 додає публічну історію оператора Hermes поверх повторно використовуваного шару: почніть з посібника з налаштування Hermes, потім перегляньте примітки до версії 2.0.0 та крос-агентну архітектуру.

⚡ ECC Pro
_{Приватні репо · GitHub App · $19/місць/міс}

❤️ Спонсор
_{Підтримати OSS · Від $5/міс}

💬 Спільнота
_{Обговорення · Питання та відповіді · Демонстрація}

🤖 GitHub App
_{Встановлення · Аудит PR · Безкоштовний рівень}

_{OSS залишається безкоштовним. Цей репозиторій ліцензований за MIT назавжди. ECC Pro — розміщений GitHub App для приватних репозиторіїв. Спонсори та Pro-підписники фінансують роботу — саме тому один розробник щотижня випускає оновлення для 7 оболонок.}

_{Бізнес-спонсори}

CodeRabbit

Greptile

Atlas Cloud

_{Спонсори спільноти: Mike Morgan · @jasonwu513 · @1anter · @massimotodaro · @meadmccabe}

_{Стати спонсором · Рівні спонсорства · Програма спонсорства}

Посібники

Цей репозиторій містить лише вихідний код. Посібники пояснюють усе.

Короткий посібник
_{Налаштування, основи, філософія. Читайте спочатку. (нитка)}

Розширений посібник
_{Оптимізація токенів, збереження пам'яті, оцінки, паралелізація. (нитка)}

Короткий посібник з усього, що стосується безпеки агентів

Посібник з безпеки
_{Вектори атак, пісочниця, санітизація, CVE, AgentShield. (нитка)}

Тема	Що ви дізнаєтесь
Оптимізація токенів	Вибір моделі, скорочення системного промпту, фонові процеси
Збереження пам'яті	Хуки, що автоматично зберігають/завантажують контекст між сесіями
Безперервне навчання	Автовитягування патернів із сесій у навички для повторного використання
Петлі верифікації	Контрольні точки проти безперервних оцінок, типи оцінювачів, метрики pass@k
Паралелізація	Git worktrees, каскадний метод, коли масштабувати інстанції
Оркестрація підагентів	Проблема контексту, патерн ітеративного отримання

Що нового

v2.0.0 — Операційна система агентних оболонок (черв. 2026)

Стабільний випуск лінійки 2.0: 261 навичка, субстрат площини управління (адаптери сесій + інвентаризація MCP), служба життєвого циклу worktree, родина оркестраторів orch-*, та запуск спільноти ECC Discord. Повні примітки: docs/releases/2.0.0/release-notes.md.

v2.0.0-rc.1 — Оновлення поверхні, оператори та ECC 2.0 Alpha (квіт. 2026)

GUI панелі керування — Нова настільна програма на основі Tkinter (ecc_dashboard.py або npm run dashboard) з перемикачем темної/світлої теми, налаштуванням шрифту та логотипом проєкту у заголовку та панелі задач.
Публічна поверхня синхронізована з живим репозиторієм — метадані, кількість у каталозі, маніфести плагінів та документація зі встановлення тепер відповідають фактичній OSS-поверхні: 66 агентів, 268 навичок та 84 застарілих командних шими.
Розширення операторних і вихідних процесів — 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 та розширена крос-оболонкова упаковка роблять репозиторій придатним для використання не лише в Claude Code.
Пакет навичок 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. Використовуйте ecc work-items upsert ... для ручних записів та ecc status --exit-code для автоматичного завершення з помилкою.
Зміцнення екосистеми — 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 для дослідження API-документації, bun-runtime та nextjs-turbopack для сучасних JS-інструментальних ланцюжків, плюс 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.
NanoClaw v2 — маршрутизація моделей, гаряче завантаження навичок, розгалуження/пошук/експорт/компакшн/метрики сесій.
Крос-оболонковий паритет — Поведінка вирівняна між Claude Code, Cursor, OpenCode та Codex.
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.
7 нових навичок — search-first, swift-actor-persistence, swift-protocol-di-testing, regex-vs-llm-structured-text, content-hash-cache-pattern, cost-aware-llm-pipeline, skill-stocktake.
Інтеграція AgentShield — Навичка /security-scan запускає AgentShield безпосередньо з Claude Code; 1282 тести, 102 правила.
GitHub Marketplace — ECC Tools GitHub App доступний на 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, #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.

Швидкий старт

Почніть за менш ніж 2 хвилини:

Виберіть один шлях

Більшість користувачів Claude Code повинні використовувати рівно один шлях встановлення:

Рекомендований стандарт: встановіть плагін Claude Code, потім скопіюйте лише ті папки з правилами, які вам справді потрібні.
Використовуйте ручний інсталятор лише якщо ви хочете більш тонкого контролю, хочете уникнути шляху плагіна, або ваша збірка Claude Code має труднощі з вирішенням запису самостійного marketplace.
Не комбінуйте методи встановлення. Найпоширеніша зламана конфігурація: спочатку /plugin install, потім install.sh --profile full або npx ecc-install --profile full.

Якщо ви вже застосували кілька методів і виникло дублювання, перейдіть одразу до Скидання/Видалення ECC.

Шлях з низьким контекстом / без хуків

Якщо хуки здаються надто глобальними або вам потрібні лише правила, агенти, команди та основні навички ECC, пропустіть плагін та використовуйте мінімальний ручний профіль:

./install.sh --profile minimal --target claude

.\install.ps1 --profile minimal --target claude
# або
npx ecc-install --profile minimal --target claude

Цей профіль навмисно виключає hooks-runtime.

Якщо вам потрібен звичайний основний профіль, але з вимкненими хуками:

./install.sh --profile core --without baseline:hooks --target claude

Додайте хуки пізніше лише за потреби примусового виконання під час роботи:

./install.sh --target claude --modules hooks-runtime

Спочатку знайдіть потрібні компоненти

Якщо ви не впевнені, який профіль або компонент ECC встановити, запитайте вбудованого консультанта з будь-якого проєкту:

npx ecc consult "security reviews" --target claude

Він повертає відповідні компоненти, пов'язані профілі та команди попереднього перегляду/встановлення. Використовуйте команду попереднього перегляду перед встановленням, якщо хочете перевірити точний план файлів.

Крок 1: Встановлення плагіна (рекомендовано)

ПРИМІТКА: Плагін зручний, але OSS-інсталятор нижче все ще є найнадійнішим шляхом, якщо ваша збірка Claude Code має труднощі з вирішенням записів самостійного marketplace.

# Додати marketplace
/plugin marketplace add https://github.com/affaan-m/ECC

# Встановити плагін
/plugin install ecc@ecc

Примітка щодо іменування та міграції

ECC має три публічних ідентифікатори, і вони не є взаємозамінними:

Вихідний репозиторій GitHub: affaan-m/ECC
Ідентифікатор marketplace/плагіна Claude: ecc@ecc
Пакет npm: ecc-universal

Це навмисно. Встановлення через marketplace/плагін Anthropic прив'язані до канонічного ідентифікатора плагіна, тому ECC використовує ecc@ecc для збереження коротких назв інструментів і просторів імен для команд зі слешем. Старі публікації можуть показувати попередній довгий ідентифікатор marketplace — вважайте це лише застарілим псевдонімом. Пакет 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. Запуск повного інсталятора після встановлення плагіна копіює ті ж поверхні в директорії користувача і може створити дублювання навичок та дублювання поведінки під час виконання.

Для встановлення через плагін вручну скопіюйте лише директорії rules/, які вам потрібні, до ~/.claude/rules/ecc/. Почніть з rules/common плюс один мовний або фреймворковий пакет, який ви фактично використовуєте. Не копіюйте всі директорії правил, якщо ви явно не хочете весь цей контекст у Claude.

Використовуйте повний інсталятор лише при повністю ручному встановленні ECC замість шляху плагіна.

# Спочатку клонуйте репозиторій
git clone https://github.com/affaan-m/ECC.git
cd ECC

# Встановіть залежності (виберіть менеджер пакетів)
npm install        # або: pnpm install | yarn install | bun install

# Шлях встановлення через плагін: копіюйте лише правила ECC у просторі імен ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/

# Шлях повного ручного встановлення ECC (використовуйте замість /plugin install)
# ./install.sh --profile full

# Windows PowerShell

# Шлях встановлення через плагін: копіюйте лише правила ECC у просторі імен ECC
New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules/ecc" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.claude/rules/ecc/"
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"

# Шлях повного ручного встановлення ECC (використовуйте замість /plugin install)
# .\install.ps1 --profile full
# npx ecc-install --profile full

Для інструкцій з ручного встановлення дивіться README у папці rules/. При ручному копіюванні правил копіюйте цілу директорію мови (наприклад rules/common або rules/golang), а не файли всередині неї, щоб відносні посилання продовжували працювати.

Повне ручне встановлення (запасний варіант)

Використовуйте це лише якщо ви навмисно пропускаєте шлях плагіна:

./install.sh --profile full

.\install.ps1 --profile full
# або
npx ecc-install --profile full

Якщо ви вибрали цей шлях, зупиніться. Не запускайте також /plugin install.

Скидання / Видалення ECC

Якщо ECC здається продубльованим, надто нав'язливим або зламаним, не продовжуйте перевстановлювати поверх себе.

Шлях плагіна: видаліть плагін з Claude Code, потім видаліть конкретні папки правил, які ви вручну скопіювали до ~/.claude/rules/ecc/.
Шлях ручного інсталятора / CLI: з кореня репозиторію спочатку перегляньте видалення:

node scripts/uninstall.js --dry-run

Потім видаліть файли, керовані ECC:

node scripts/uninstall.js

Також можна використати обгортку lifecycle:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run

ECC видаляє лише файли, записані в його стані встановлення. Він не видалятиме неспоріднені файли, які він не встановлював.

Якщо ви комбінували методи, очищуйте в такому порядку:

Видаліть встановлення плагіна Claude Code.
Запустіть команду видалення ECC з кореня репозиторію для видалення файлів, керованих станом встановлення.
Видаліть будь-які додаткові папки правил, скопійовані вручну, які вам більше не потрібні.
Перевстановіть один раз, використовуючи єдиний шлях.

Крок 3: Почніть використовувати

# Навички є основною поверхнею процесів.
# Існуючі назви команд зі слешем продовжують працювати під час міграції з commands/.

# Встановлення через плагін використовує канонічну форму з простором імен
/ecc:plan "Додати автентифікацію користувача"

# Ручне встановлення зберігає коротку форму зі слешем:
# /plan "Додати автентифікацію користувача"

# Перевірте доступні команди
/plugin list ecc@ecc

Ось і все! Тепер у вас є доступ до 67 агентів, 271 навички та 92 застарілих командних шими.

Панель керування GUI

Запустіть настільну панель керування для візуального дослідження компонентів ECC:

npm run dashboard
# або
python3 ./ecc_dashboard.py

Функції:

Вкладки: Агенти, Навички, Команди, Правила, Налаштування
Перемикач темної/світлої теми
Налаштування шрифту (сімейство та розмір)
Логотип проєкту у заголовку та панелі задач
Пошук і фільтрація по всіх компонентах

Мультимодельні команди вимагають додаткового налаштування

УВАГА: Команди multi-* не входять до базового встановлення плагіна/правил.

Для використання /multi-plan, /multi-execute, /multi-backend, /multi-frontend та /multi-workflow необхідно також встановити ccg-workflow.

Ініціалізуйте його командою npx ccg-workflow.

Цей runtime надає зовнішні залежності, яких очікують ці команди, зокрема:

~/.claude/bin/codeagent-wrapper

~/.claude/.ccg/prompts/*

Без ccg-workflow ці команди multi-* не працюватимуть коректно.

Кросплатформна підтримка

Цей плагін тепер повністю підтримує Windows, macOS та Linux, а також тісну інтеграцію з основними IDE (Cursor, Zed, OpenCode, Antigravity) та оболонками CLI. Усі хуки та скрипти переписані на Node.js для максимальної сумісності.

Виявлення менеджера пакетів

Плагін автоматично виявляє ваш бажаний менеджер пакетів (npm, pnpm, yarn або bun) з таким пріоритетом:

Змінна середовища: CLAUDE_PACKAGE_MANAGER
Конфіг проєкту: .claude/package-manager.json
package.json: поле packageManager
Lock-файл: Виявлення з package-lock.json, yarn.lock, pnpm-lock.yaml або bun.lockb
Глобальний конфіг: ~/.claude/package-manager.json
Запасний варіант: Перший доступний менеджер пакетів

Щоб встановити бажаний менеджер пакетів:

# Через змінну середовища
export CLAUDE_PACKAGE_MANAGER=pnpm

# Через глобальний конфіг
node scripts/setup-package-manager.js --global pnpm

# Через конфіг проєкту
node scripts/setup-package-manager.js --project bun

# Виявити поточне налаштування
node scripts/setup-package-manager.js --detect

Або використовуйте команду /setup-pm у Claude Code.

Елементи управління виконанням хуків

Використовуйте прапорці виконання для налаштування суворості або тимчасового вимкнення конкретних хуків:

# Профіль суворості хуків (стандарт за замовчуванням)
export ECC_HOOK_PROFILE=standard

# Через кому ідентифікатори хуків для вимкнення
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

# Обмежити додатковий контекст SessionStart (за замовчуванням: 8000 символів)
export ECC_SESSION_START_MAX_CHARS=4000

# Повністю вимкнути додатковий контекст SessionStart для конфігурацій з низьким контекстом
export ECC_SESSION_START_CONTEXT=off

# Вікно збереження session-tmp у днях (за замовчуванням: 30)
export ECC_SESSION_RETENTION_DAYS=14

# Зберегти попередження щодо контексту/обсягу/циклів, але пригнічити оцінки витрат API
export ECC_CONTEXT_MONITOR_COST_WARNINGS=off

Windows PowerShell:

[Environment]::SetEnvironmentVariable('ECC_CONTEXT_MONITOR_COST_WARNINGS', 'off', 'User')
[Environment]::SetEnvironmentVariable('ECC_SESSION_RETENTION_DAYS', '14', 'User')

Домашня директорія даних агента (мультиоболонкова ізоляція)

Хуки збереження пам'яті (підсумки сесій, вивчені навички, псевдоніми сесій, метрики) зберігають дані під єдиним кореневим каталогом даних агента. За замовчуванням це ~/.claude. При використанні ECC у Claude Code та Cursor на одному комп'ютері, встановіть окремий корінь для Cursor, щоб два середовища не перезаписували файли сесій одне одного:

# Кордон лише для Cursor (Claude Code зберігає стандартний ~/.claude)
export ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"

Шляхи, що вирішуються під цим коренем:

$ECC_AGENT_DATA_HOME/session-data/ — підсумки сесій
$ECC_AGENT_DATA_HOME/skills/learned/ — вивчені навички з evaluate-session
$ECC_AGENT_DATA_HOME/session-aliases.json — псевдоніми сесій
$ECC_AGENT_DATA_HOME/metrics/ — метрики витрат та активності

Дивіться affaan-m/ECC#2065.

Що всередині

Цей репозиторій є плагіном Claude Code — встановіть його безпосередньо або скопіюйте компоненти вручну.

ECC/
|-- .claude-plugin/   # Маніфести плагіна та marketplace
|   |-- plugin.json         # Метадані плагіна та шляхи компонентів
|   |-- marketplace.json    # Каталог marketplace для /plugin marketplace add
|
|-- agents/           # 67 спеціалізованих підагентів для делегування
|   |-- planner.md           # Планування реалізації функцій
|   |-- architect.md         # Рішення щодо системного дизайну
|   |-- tdd-guide.md         # Розробка через тестування
|   |-- code-reviewer.md     # Перевірка якості та безпеки
|   |-- security-reviewer.md # Аналіз вразливостей
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # E2E тестування Playwright
|   |-- refactor-cleaner.md  # Очищення мертвого коду
|   |-- doc-updater.md       # Синхронізація документації
|   |-- docs-lookup.md       # Пошук документації/API
|   |-- chief-of-staff.md    # Триаж комунікацій та чернетки
|   |-- loop-operator.md     # Виконання автономних циклів
|   |-- harness-optimizer.md # Налаштування конфігурації оболонки
|   |-- cpp-reviewer.md      # Перегляд коду C++
|   |-- cpp-build-resolver.md # Вирішення помилок збирання C++
|   |-- fsharp-reviewer.md   # Перегляд функціонального коду F#
|   |-- go-reviewer.md       # Перегляд коду Go
|   |-- go-build-resolver.md # Вирішення помилок збирання Go
|   |-- python-reviewer.md   # Перегляд коду Python
|   |-- database-reviewer.md # Перегляд бази даних/Supabase
|   |-- typescript-reviewer.md # Перегляд коду TypeScript/JavaScript
|   |-- java-reviewer.md     # Перегляд коду Java/Spring Boot
|   |-- java-build-resolver.md # Помилки збирання Java/Maven/Gradle
|   |-- kotlin-reviewer.md   # Перегляд коду Kotlin/Android/KMP
|   |-- kotlin-build-resolver.md # Помилки збирання Kotlin/Gradle
|   |-- harmonyos-app-resolver.md # Розробка додатків HarmonyOS/ArkTS
|   |-- rust-reviewer.md     # Перегляд коду Rust
|   |-- rust-build-resolver.md # Вирішення помилок збирання Rust
|   |-- pytorch-build-resolver.md # Помилки навчання PyTorch/CUDA
|   |-- mle-reviewer.md      # Перегляд конвеєра ML, оцінок, обслуговування та моніторингу
|
|-- skills/           # Визначення процесів та доменні знання
|   |-- coding-standards/           # Найкращі практики мов
|   |-- clickhouse-io/              # Аналітика ClickHouse, запити, інженерія даних
|   |-- backend-patterns/           # Шаблони API, баз даних, кешування
|   |-- frontend-patterns/          # Шаблони React, Next.js
|   |-- frontend-slides/            # HTML-слайди та процеси PPTX (НОВИЙ)
|   |-- article-writing/            # Довгоформне письмо без загального тону ШІ (НОВИЙ)
|   |-- content-engine/             # Мультиплатформний соціальний контент (НОВИЙ)
|   |-- market-research/            # Ринкові та конкурентні дослідження (НОВИЙ)
|   |-- investor-materials/         # Питч-деки, меморандуми та фінансові моделі (НОВИЙ)
|   |-- investor-outreach/          # Персоналізований фандрейзинговий аутріч (НОВИЙ)
|   |-- continuous-learning/        # Застарілий патерн v1 для Stop-hook
|   |-- continuous-learning-v2/     # Навчання на основі інстинктів з оцінюванням довіри
|   |-- iterative-retrieval/        # Прогресивне уточнення контексту для підагентів
|   |-- strategic-compact/          # Ручні пропозиції компакшну (Розширений посібник)
|   |-- tdd-workflow/               # Методологія TDD
|   |-- security-review/            # Контрольний список безпеки
|   |-- eval-harness/               # Оцінка петлі верифікації (Розширений посібник)
|   |-- verification-loop/          # Безперервна верифікація (Розширений посібник)
|   ... (та багато інших)
|
|-- commands/         # Підтримувана сумісність зі слеш-записами; надавайте перевагу skills/
|-- legacy-command-shims/   # Архів для вилучених шимів
|-- rules/            # Завжди дотримувані правила (копіюйте до ~/.claude/rules/ecc/)
|   |-- common/              # Незалежні від мови принципи
|   |-- typescript/          # Специфіка TypeScript/JavaScript
|   |-- python/              # Специфіка Python
|   |-- golang/              # Специфіка Go
|   |-- swift/               # Специфіка Swift
|   |-- php/                 # Специфіка PHP (НОВИЙ)
|   |-- arkts/               # Специфіка HarmonyOS / ArkTS
|
|-- hooks/            # Автоматизації на основі тригерів
|-- scripts/          # Кросплатформні скрипти Node.js
|-- tests/            # Набір тестів
|-- contexts/         # Динамічні контексти ін'єкції системного промпту
|-- examples/         # Приклади конфігурацій та сесій
|-- mcp-configs/      # Конфігурації MCP-серверів
|-- ecc_dashboard.py  # Настільна GUI-панель (Tkinter)
|-- marketplace.json  # Конфігурація самостійного marketplace

Інструменти екосистеми

Конструктор навичок

Два способи генерації навичок Claude Code з вашого репозиторію:

Варіант A: Локальний аналіз (вбудований)

Використовуйте команду /skill-create для локального аналізу без зовнішніх сервісів:

/skill-create                    # Аналізувати поточний репозиторій
/skill-create --instincts        # Також генерувати інстинкти для continuous-learning-v2

Це аналізує вашу git-історію локально та генерує файли SKILL.md.

Варіант B: GitHub App (розширений)

Для розширених функцій (10k+ комітів, автоматичні PR, спільний доступ у команді):

Встановити ECC Tools GitHub App | ecc.tools

# Коментуйте у будь-якому issue:
/ecc-tools analyze

# Або запускайте проти репозиторію з розміщеного додатка

Обидва варіанти створюють:

Файли SKILL.md — Готові до використання навички для активної оболонки
Колекції інстинктів — Для continuous-learning-v2
Витягування патернів — Навчається з вашої git-історії

AgentShield — Аудитор безпеки

Створений на Claude Code Hackathon (Cerebral Valley x Anthropic, лют. 2026). 1282 тести, 98% покриття, 102 правила статичного аналізу.

Скануйте вашу конфігурацію Claude Code на вразливості, помилкові конфігурації та ризики ін'єкцій.

# Швидке сканування (без встановлення)
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.

GitHub | npm

Безперервне навчання v2

Система навчання на основі інстинктів автоматично вивчає ваші патерни:

/instinct-status        # Показати вивчені інстинкти з довірою
/instinct-import <file> # Імпортувати інстинкти від інших
/instinct-export        # Експортувати ваші інстинкти для поширення
/evolve                 # Кластеризувати пов'язані інстинкти в навички

Дивіться skills/continuous-learning-v2/ для повної документації. Зберігайте continuous-learning/ лише якщо вам явно потрібен застарілий потік v1 Stop-hook з вивченими навичками.

Вимоги

Версія Claude Code CLI

Мінімальна версія: v2.1.0 або новіша

Цей плагін вимагає Claude Code CLI v2.1.0+ через зміни в тому, як система плагінів обробляє хуки.

Перевірте свою версію:

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, #52, #103). Поведінка змінювалася між версіями Claude Code, що призводило до плутанини. Тепер у нас є регресійний тест для запобігання повторного введення цього.

Встановлення

Варіант 1: Встановлення як плагін (рекомендовано)

Найпростіший спосіб використання цього репозиторію — встановлення як плагін Claude Code:

# Додати цей репозиторій як marketplace
/plugin marketplace add https://github.com/affaan-m/ECC

# Встановити плагін
/plugin install ecc@ecc

Або додайте безпосередньо до вашого ~/.claude/settings.json:

{
  "extraKnownMarketplaces": {
    "ecc": {
      "source": {
        "source": "github",
        "repo": "affaan-m/ECC"
      }
    }
  },
  "enabledPlugins": {
    "ecc@ecc": true
  }
}

Це надає миттєвий доступ до всіх команд, агентів, навичок та хуків.

Примітка: Система плагінів Claude Code не підтримує розповсюдження rules через плагіни. Вам потрібно встановити правила вручну:

# Спочатку клонуйте репозиторій
git clone https://github.com/affaan-m/ECC.git
cd ECC

# Варіант A: Правила рівня користувача (застосовуються до всіх проєктів)
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/typescript ~/.claude/rules/ecc/   # оберіть свій стек
cp -r rules/python ~/.claude/rules/ecc/
cp -r rules/golang ~/.claude/rules/ecc/
cp -r rules/php ~/.claude/rules/ecc/

# Варіант B: Правила рівня проєкту (застосовуються лише до поточного проєкту)
mkdir -p .claude/rules/ecc
cp -r rules/common .claude/rules/ecc/
cp -r rules/typescript .claude/rules/ecc/     # оберіть свій стек

Варіант 2: Ручне встановлення

Якщо ви надаєте перевагу ручному контролю над тим, що встановлено:

# Клонуйте репозиторій
git clone https://github.com/affaan-m/ECC.git
cd ECC

# Скопіюйте агентів до вашої конфігурації Claude
cp agents/*.md ~/.claude/agents/

# Скопіюйте директорії правил (common + мовноспецифічні)
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/typescript ~/.claude/rules/ecc/   # оберіть свій стек

# Спочатку скопіюйте навички (основна поверхня процесів)
mkdir -p ~/.claude/skills
cp -r .agents/skills/* ~/.claude/skills/
cp -r skills/search-first ~/.claude/skills/

# Необов'язково: збережіть сумісність зі слеш-командами
mkdir -p ~/.claude/commands
cp commands/*.md ~/.claude/commands/

Встановлення хуків

Не копіюйте hooks/hooks.json безпосередньо. Використовуйте інсталятор:

# macOS / Linux
bash ./install.sh --target claude --modules hooks-runtime

# Windows PowerShell
pwsh -File .\install.ps1 --target claude --modules hooks-runtime

Налаштування MCP

Встановлення плагінів Claude навмисно не вмикають автоматично визначення вбудованих MCP-серверів ECC. Використовуйте команду /mcp Claude Code або налаштування MCP через CLI.

Ключові концепції

Агенти

Підагенти виконують делеговані завдання з обмеженим обсягом. Приклад:

---
name: code-reviewer
description: Переглядає код на якість, безпеку та підтримуваність
tools: ["Read", "Grep", "Glob", "Bash"]
model: opus
---

Ви — старший рецензент коду...

Навички

Навички є основною поверхнею процесів. Вони можуть викликатися безпосередньо, пропонуватися автоматично та повторно використовуватися агентами.

# Процес TDD

1. Спочатку визначте інтерфейси
2. Напишіть непрохідні тести (ЧЕРВОНИЙ)
3. Реалізуйте мінімальний код (ЗЕЛЕНИЙ)
4. Рефакторинг (ПОКРАЩЕННЯ)
5. Перевірте покриття 80%+

Хуки

Хуки спрацьовують на події інструментів. Приклад — попередження про console.log:

{
  "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
  "hooks": [{
    "type": "command",
    "command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Видаліть console.log' >&2"
  }]
}

Правила

Правила — це завжди дотримувані настанови, організовані у common/ (незалежні від мови) + мовноспецифічні директорії:

rules/
  common/          # Універсальні принципи (завжди встановлювати)
  typescript/      # Специфічні патерни та інструменти TS/JS
  python/          # Специфічні патерни та інструменти Python
  golang/          # Специфічні патерни та інструменти Go
  swift/           # Специфічні патерни та інструменти Swift
  php/             # Специфічні патерни та інструменти PHP
  arkts/           # Патерни та обмеження HarmonyOS / ArkTS

Який агент використовувати?

Не знаєте, з чого почати? Використовуйте цей довідник.

Я хочу...	Поверхня	Агент
Спланувати нову функцію	`/ecc:plan "Додати автентифікацію"`	planner
Спроєктувати архітектуру системи	`/ecc:plan` + агент architect	architect
Писати код з попереднім тестуванням	Навичка `tdd-workflow`	tdd-guide
Переглянути щойно написаний код	`/code-review`	code-reviewer
Виправити помилки збирання	`/build-fix`	build-error-resolver
Запустити наскрізні тести	Навичка `e2e-testing`	e2e-runner
Знайти вразливості безпеки	`/security-scan`	security-reviewer
Видалити мертвий код	`/refactor-clean`	refactor-cleaner
Оновити документацію	`/update-docs`	doc-updater
Переглянути код Go	`/go-review`	go-reviewer
Переглянути код Python	`/python-review`	python-reviewer
Переглянути ML-зміни для продакшну	Навичка `mle-workflow` + агент `mle-reviewer`	mle-reviewer

Типові процеси

Початок нової функції:

/ecc:plan "Додати автентифікацію користувача з OAuth"
                                              → planner створює план реалізації
Навичка tdd-workflow                          → tdd-guide забезпечує написання тестів спочатку
/code-review                                  → code-reviewer перевіряє вашу роботу

Виправлення помилки:

Навичка tdd-workflow                          → tdd-guide: написати непрохідний тест, що відтворює її
                                              → реалізувати виправлення, перевірити що тест проходить
/code-review                                  → code-reviewer: перевірити регресії

Підготовка до продакшну:

/security-scan                                → security-reviewer: аудит OWASP Top 10
Навичка e2e-testing                           → e2e-runner: тести критичних процесів
/test-coverage                                → перевірити покриття 80%+

Поширені запитання

Як перевірити, які агенти/команди встановлено?

/plugin list ecc@ecc

Це показує всі доступні агенти, команди та навички з плагіна.

Мої хуки не працюють / я бачу помилки "Duplicate hooks file"

Це найпоширеніша проблема. НЕ додавайте поле "hooks" до .claude-plugin/plugin.json. Claude Code v2.1+ автоматично завантажує hooks/hooks.json з встановлених плагінів. Явне оголошення спричиняє помилки виявлення дублікатів. Дивіться #29, #52, #103.

Чи можна використовувати ECC з Claude Code на власному API-ендпоінті або шлюзі моделей?

Так. ECC не прив'язує налаштування транспорту Anthropic жорстко. Він працює локально через звичайну CLI/плагін-поверхню Claude Code, тому працює з:

Розміщеним Anthropic Claude Code
Офіційними налаштуваннями шлюзу Claude Code через ANTHROPIC_BASE_URL та ANTHROPIC_AUTH_TOKEN
Сумісними власними ендпоінтами, що розуміють Anthropic API

Мінімальний приклад:

export ANTHROPIC_BASE_URL=https://your-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=your-token
claude

Моє контекстне вікно скорочується / Claude вичерпує контекст

Забагато MCP-серверів поглинає ваш контекст. Кожен опис інструменту MCP витрачає токени з вашого вікна 200k, потенційно скорочуючи його до ~70k. Контекст SessionStart обмежений 8000 символами за замовчуванням; знизьте це за допомогою ECC_SESSION_START_MAX_CHARS=4000 або вимкніть за допомогою ECC_SESSION_START_CONTEXT=off для конфігурацій з локальними моделями або низьким контекстом.

Виправлення: Вимкніть невикористовувані MCP у Claude Code за допомогою /mcp. Тримайте менше 10 активних MCP та менше 80 активних інструментів.

Чи можу я використовувати лише деякі компоненти (наприклад, лише агентів)?

Так. Використовуйте Варіант 2 (ручне встановлення) та скопіюйте лише те, що вам потрібно. Кожен компонент повністю незалежний.

Чи це працює з Cursor / OpenCode / Codex / Antigravity / GitHub Copilot?

Так. ECC є кросплатформним. Дивіться відповідні розділи нижче для деталей кожної оболонки.

Як зробити внесок новою навичкою або агентом?

Дивіться CONTRIBUTING.md. Коротко:

Зробіть форк репозиторію
Створіть навичку в skills/your-skill-name/SKILL.md (з YAML frontmatter)
Або створіть агента в agents/your-agent.md
Надішліть PR з чітким описом того, що він робить і коли використовувати

Запуск тестів

Плагін містить комплексний набір тестів:

# Запустити всі тести
node tests/run-all.js

# Запустити окремі тестові файли
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

Участь у розробці

Внески вітаються та заохочуються.

Цей репозиторій призначений бути ресурсом спільноти. Якщо у вас є:

Корисні агенти або навички
Розумні хуки
Кращі конфігурації MCP
Покращені правила

Будь ласка, зробіть внесок! Дивіться CONTRIBUTING.md для настанов.

Ідеї для внесків

Мовноспецифічні навички (Rust, C#, Kotlin, Java) — Go, Python, Perl, Swift, TypeScript та HarmonyOS/ArkTS вже включені
Конфіги для фреймворків (Rails, FastAPI) — Django, NestJS, Spring Boot та Laravel вже включені
DevOps-агенти (Kubernetes, Terraform, AWS, Docker)
Стратегії тестування (різні фреймворки, візуальна регресія)
Доменні знання (ML, інженерія даних, мобільна розробка)

Підтримка Cursor IDE

ECC надає підтримку Cursor IDE з хуками, правилами, агентами, навичками, командами та конфігами MCP, адаптованими для макету проєктів Cursor.

Швидкий старт (Cursor)

# macOS/Linux
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php

# Windows PowerShell
.\install.ps1 --target cursor typescript
.\install.ps1 --target cursor python golang swift php

Що включено

Компонент	Кількість	Деталі
Події хуків	15	sessionStart, beforeShellExecution, afterFileEdit, beforeMCPExecution, beforeSubmitPrompt та ще 10
Скрипти хуків	16	Тонкі Node.js-скрипти, що делегують до `scripts/hooks/` через спільний адаптер
Правила	34	9 загальних (alwaysApply) + 25 мовноспецифічних (TypeScript, Python, Go, Swift, PHP)
Агенти	48	`.cursor/agents/ecc-*.md` при встановленні; з префіксом для уникнення конфліктів
Навички	Спільні + вбудовані	`.cursor/skills/` для перекладених доповнень
Команди	Спільні	`.cursor/commands/` якщо встановлено
Конфіг MCP	Спільний	`.cursor/mcp.json` якщо встановлено

Архітектура хуків (DRY-патерн адаптера)

Cursor має більше подій хуків, ніж Claude Code (20 проти 8). Модуль .cursor/hooks/adapter.js перетворює вхідний JSON Cursor у формат Claude Code, дозволяючи повторно використовувати існуючі scripts/hooks/*.js без дублювання.

Вхідний JSON Cursor → adapter.js → перетворює → scripts/hooks/*.js
                                              (спільний з Claude Code)

Підтримка Codex macOS App + CLI

ECC надає першокласну підтримку Codex як для macOS-додатка, так і для CLI, з еталонною конфігурацією, Codex-специфічним доповненням AGENTS.md та спільними навичками.

Швидкий старт (Codex App + CLI)

# Запустіть Codex CLI в репозиторії — AGENTS.md та .codex/ виявляються автоматично
codex

# Автоматичне налаштування: синхронізація активів ECC у ~/.codex
npm install && bash scripts/sync-ecc-to-codex.sh

Ключове обмеження

Codex поки не забезпечує паритет виконання хуків у стилі Claude. Виконання ECC там базується на інструкціях через AGENTS.md, необов'язкові перевизначення model_instructions_file та налаштування пісочниці/затвердження.

Підтримка Zed

ECC надає підтримку проєктів Zed через консервативний адаптер .zed для локальних налаштувань проєкту, вирівняних правил, агентів, команд та навичок.

./install.sh --profile minimal --target zed

Підтримка OpenCode

ECC надає повну підтримку OpenCode, включаючи плагіни та хуки.

Паритет функцій

Функція	Claude Code	OpenCode	Статус
Агенти	67 агентів	12 агентів	Claude Code лідирує
Команди	92 команди	35 команд	Claude Code лідирує
Навички	271 навичка	37 навичок	Claude Code лідирує
Хуки	8 типів подій	11 подій	OpenCode більше!
Правила	29 правил	13 інструкцій	Claude Code лідирує
MCP-сервери	14 серверів	Повний	Повний паритет
Власні інструменти	Через хуки	6 нативних інструментів	OpenCode краще

Підтримка GitHub Copilot

ECC надає підтримку GitHub Copilot для VS Code через нативну систему інструкційних та промпт-файлів Copilot Chat — без додаткових інструментів.

Що включено

Компонент	Файл	Призначення
Основні інструкції	`.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`	Систематичне вирішення помилок збирання
Промпт рефакторингу	`.github/prompts/refactor.prompt.md`	Очищення мертвого коду

Обмеження

GitHub Copilot не має системи хуків або API підагентів, тому автоматизації хуків ECC (автоформат, перевірка TypeScript, збереження сесій, захист від dev-сервера) та делегування агентів недоступні. Шар інструкцій та промптів все ж привносить повну філософію кодування ECC — стандарти, безпеку, TDD та процес — у кожну сесію Copilot Chat.

Паритет функцій між інструментами

ECC — перший плагін, що максимізує можливості кожного основного інструменту ШІ-кодування. Порівняння оболонок:

Функція	Claude Code	Cursor IDE	Codex CLI	OpenCode	GitHub Copilot
Агенти	67	Спільні (AGENTS.md)	Спільні (AGENTS.md)	12	Немає
Команди	92	Спільні	На основі інструкцій	35	5 промптів
Навички	271	Спільні	10 (нативний формат)	37	Через інструкції
Події хуків	8 типів	15 типів	Немає	11 типів	Немає
Правила	34 (common + lang)	34 (YAML frontmatter)	На основі інструкцій	13 інструкцій	1 завжди-увімкнений файл
Власні інструменти	Через хуки	Через хуки	Немає	6 нативних інструментів	Немає
MCP-сервери	14	Спільні (mcp.json)	7	Повний	Немає
Конфіг	settings.json	hooks.json + rules/	config.toml	opencode.json	copilot-instructions.md + settings.json
Файл контексту	CLAUDE.md + AGENTS.md	AGENTS.md	AGENTS.md	AGENTS.md	copilot-instructions.md

Ключові архітектурні рішення:

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 та дозволами пісочниці

Передісторія

Я використовую Claude Code з моменту експериментального впровадження. Виграв хакатон Anthropic x Forum Ventures у вер. 2025 разом з @DRodriguezFX — побудував zenith.chat повністю за допомогою Claude Code.

Ці конфіги перевірені в кількох продакшн-додатках.

Оптимізація токенів

Використання Claude Code може бути дорогим, якщо не керувати споживанням токенів. Ці налаштування значно знижують витрати без шкоди для якості.

Налаштування	Стандарт	Рекомендовано	Ефект
`model`	opus	sonnet	~60% скорочення витрат; справляється з 80%+ завдань кодування
`MAX_THINKING_TOKENS`	31 999	10 000	~70% скорочення прихованих витрат на міркування за запит
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	95	50	Компакшн раніше — краща якість у довгих сесіях
`ECC_CONTEXT_MONITOR_COST_WARNINGS`	увімк	вимк для підписників	Пригнічує попередження оцінок API-рейту, зберігаючи попередження контексту/обсягу/циклів

Команди щоденного процесу

Команда	Коли використовувати
`/model sonnet`	Стандарт для більшості завдань
`/model opus`	Складна архітектура, налагодження, глибоке міркування
`/clear`	Між непов'язаними завданнями (безкоштовно, миттєве скидання)
`/compact`	У логічних точках зупинки завдань
`/cost`	Моніторинг витрат токенів під час сесії

Стратегічний компакшн

Навичка strategic-compact пропонує /compact у логічних точках зупинки замість покладання на автокомпакшн при 95% контексту.

Коли компактувати:

Після дослідження/вивчення, перед реалізацією
Після завершення milestone, перед початком наступного
Після налагодження, перед продовженням роботи з функцією
Після невдалого підходу, перед спробою нового

Коли НЕ компактувати:

В середині реалізації (ви втратите назви змінних, шляхи до файлів, частковий стан)

ПОПЕРЕДЖЕННЯ: Важливі примітки

Оптимізація токенів

Досягаєте щоденних лімітів? Дивіться Посібник з оптимізації токенів.

Швидкі виграші:

// ~/.claude/settings.json
{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

Налаштування

Ці конфіги підходять для мого процесу. Вам слід:

Почати з того, що резонує
Змінити для вашого стеку
Видалити те, що ви не використовуєте
Додати власні патерни

Безпека

ECC серйозно ставиться до безпеки ланцюжка поставок та агентної безпеки.

Лише офіційні джерела. Встановлюйте ECC лише з перевірених каналів, перелічених у банері вгорі цього README.
Повідомте про вразливість. Використовуйте приватний процес у SECURITY.md (приватне звітування про вразливість GitHub). Будь ласка, не відкривайте публічні issues для звітів про безпеку.
Вбудовані захисні механізми. GateGuard захищає деструктивні команди оболонки перед їх виконанням; сканер IOC ланцюжка поставок запускається в CI; AgentShield перевіряє ваш агент, хуки, MCP, дозволи та секретні поверхні (/security-scan).
Детальна інформація. Дивіться Посібник з безпеки.

Спонсори

Основні спонсори вказані вгорі цього README — повний список та рівні в SPONSORS.md. Стати спонсором.

Посилання

Короткий посібник (Почніть тут): Короткий посібник з ECC
Розширений посібник (Для досвідчених): Розширений посібник з ECC
Посібник з безпеки: Посібник з безпеки | Нитка
Підписатись: @affaan

Ліцензія

MIT — Використовуйте вільно, змінюйте за потреби, робіть внески якщо можете.

Поставте зірку цьому репозиторію, якщо він допоміг вам. Читайте обидва посібники. Будуйте щось чудове.

README.md Unescape Escape

Посібники

Що нового

v2.0.0 — Операційна система агентних оболонок (черв. 2026)

v2.0.0-rc.1 — Оновлення поверхні, оператори та ECC 2.0 Alpha (квіт. 2026)

v1.9.0 — Вибіркове встановлення та розширення мовної підтримки (бер. 2026)

v1.8.0 — Система продуктивності агентних оболонок (бер. 2026)

v1.7.0 — Кросплатформне розширення та конструктор презентацій (лют. 2026)

v1.6.0 — Codex CLI, AgentShield та Marketplace (лют. 2026)

v1.4.1 — Виправлення помилок (лют. 2026)

v1.4.0 — Мультимовні правила, майстер встановлення та PM2 (лют. 2026)

v1.3.0 — Підтримка плагінів OpenCode (лют. 2026)

v1.2.0 — Уніфіковані команди та навички (лют. 2026)

Швидкий старт

Виберіть один шлях

Шлях з низьким контекстом / без хуків

Спочатку знайдіть потрібні компоненти

Крок 1: Встановлення плагіна (рекомендовано)

Примітка щодо іменування та міграції

Крок 2: Встановлення правил лише за потреби

Повне ручне встановлення (запасний варіант)

Скидання / Видалення ECC

Крок 3: Почніть використовувати

Панель керування GUI

Мультимодельні команди вимагають додаткового налаштування

Кросплатформна підтримка

Виявлення менеджера пакетів

Елементи управління виконанням хуків

Домашня директорія даних агента (мультиоболонкова ізоляція)

Що всередині

Інструменти екосистеми

Конструктор навичок

Варіант A: Локальний аналіз (вбудований)

Варіант B: GitHub App (розширений)

AgentShield — Аудитор безпеки

Безперервне навчання v2

Вимоги

Версія Claude Code CLI

Важливо: Поведінка автозавантаження хуків

Встановлення

Варіант 1: Встановлення як плагін (рекомендовано)

Варіант 2: Ручне встановлення

Встановлення хуків

Налаштування MCP

Ключові концепції

Агенти

Навички

Хуки

Правила

Який агент використовувати?

Типові процеси

Поширені запитання

Запуск тестів

Участь у розробці

Ідеї для внесків

Підтримка Cursor IDE

Швидкий старт (Cursor)

Що включено

Архітектура хуків (DRY-патерн адаптера)

Підтримка Codex macOS App + CLI

Швидкий старт (Codex App + CLI)

Ключове обмеження

Підтримка Zed

Підтримка OpenCode

Паритет функцій

Підтримка GitHub Copilot

Що включено

Обмеження

Паритет функцій між інструментами

Передісторія

Оптимізація токенів

Рекомендовані налаштування

Команди щоденного процесу

Стратегічний компакшн

ПОПЕРЕДЖЕННЯ: Важливі примітки

Оптимізація токенів

Налаштування

Безпека

Спонсори

Посилання

README.md