The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs(ua): - add ukrainian translation of README.md - share ua doc link through all concerned readmes
Vladyslav Tezyk638456c7ca54
diff --git a/README.md b/README.mdindex ed4c4300a..251622402 100644--- a/README.md+++ b/README.md@@ -1,4 +1,4 @@-**Language:** English | [Português (Brasil)](docs/pt-BR/README.md) | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja-JP/README.md) | [한국어](docs/ko-KR/README.md) | [Türkçe](docs/tr/README.md) | [Русский](docs/ru/README.md) | [Tiếng Việt](docs/vi-VN/README.md) | [ไทย](docs/th/README.md) | [Deutsch](docs/de-DE/README.md) | [Español](docs/es/README.md)+**Language:** English | [Português (Brasil)](docs/pt-BR/README.md) | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja-JP/README.md) | [한국어](docs/ko-KR/README.md) | [Türkçe](docs/tr/README.md) | [Русский](docs/ru/README.md) | [Tiếng Việt](docs/vi-VN/README.md) | [ไทย](docs/th/README.md) | [Deutsch](docs/de-DE/README.md) | [Español](docs/es/README.md) | [Українська](docs/ua-UA/README.md)@@ -34,7 +34,7 @@**Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ / Idioma**[**English**](README.md) | [Português (Brasil)](docs/pt-BR/README.md) | [简体中文](README.zh-CN.md) | [繁體中文](docs/zh-TW/README.md) | [日本語](docs/ja-JP/README.md) | [한국어](docs/ko-KR/README.md)- | [Türkçe](docs/tr/README.md) | [Русский](docs/ru/README.md) | [Tiếng Việt](docs/vi-VN/README.md) | [ไทย](docs/th/README.md) | [Deutsch](docs/de-DE/README.md) | [Español](docs/es/README.md)+ | [Türkçe](docs/tr/README.md) | [Русский](docs/ru/README.md) | [Tiếng Việt](docs/vi-VN/README.md) | [ไทย](docs/th/README.md) | [Deutsch](docs/de-DE/README.md) | [Español](docs/es/README.md) | [Українська](docs/ua-UA/README.md)</div>diff --git a/docs/de-DE/README.md b/docs/de-DE/README.mdindex c7463d5ff..303ede0ad 100644--- a/docs/de-DE/README.md+++ b/docs/de-DE/README.md@@ -1,4 +1,4 @@-**Sprache:** [English](../../README.md) | [Deutsch](README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)+**Sprache:** [English](../../README.md) | [Deutsch](README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Українська](../ua-UA/README.md)# ECCdiff --git a/docs/es/README.md b/docs/es/README.mdindex d0e105a26..5ba6b1ad4 100644--- a/docs/es/README.md+++ b/docs/es/README.md@@ -1,4 +1,4 @@-**Idioma:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | **Español**+**Idioma:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | **Español** | [Українська](../ua-UA/README.md)# ECCdiff --git a/docs/ja-JP/README.md b/docs/ja-JP/README.mdindex 0a4329e73..017bc8615 100644--- a/docs/ja-JP/README.md+++ b/docs/ja-JP/README.md@@ -1,4 +1,4 @@-**言語:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+**言語:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -21,8 +21,7 @@**言語 / Language / 語言 / Dil / Язык / Ngôn ngữ**-[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)-+[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>---diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.mdindex 66726f98f..5eaa5ed6e 100644--- a/docs/ko-KR/README.md+++ b/docs/ko-KR/README.md@@ -1,4 +1,4 @@-**언어:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | 한국어 | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+**언어:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | 한국어 | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -24,7 +24,7 @@**Language / 语言 / 語言 / 언어 / Dil / Язык / Ngôn ngữ**-[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.mdindex c78fe77f2..7ded72ccf 100644--- a/docs/pt-BR/README.md+++ b/docs/pt-BR/README.md@@ -1,4 +1,4 @@-**Idioma:** [English](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | Português (Brasil) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+**Idioma:** [English](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | Português (Brasil) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -24,8 +24,7 @@**Idioma / Language / 语言 / Dil / Язык / Ngôn ngữ**-[**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Português (Brasil)](README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)-+[**English**](../../README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Português (Brasil)](README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>---diff --git a/docs/ru/README.md b/docs/ru/README.mdindex f42a19c97..2b72886cc 100644--- a/docs/ru/README.md+++ b/docs/ru/README.md@@ -1,4 +1,4 @@-**Язык:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | **Русский** | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+**Язык:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | **Русский** | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -27,7 +27,7 @@**Язык / 语言 / 語言 / Dil / Ngôn ngữ**-[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | **Русский** | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | **Русский** | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/th/README.md b/docs/th/README.mdindex c41fcdff3..314f57e99 100644--- a/docs/th/README.md+++ b/docs/th/README.md@@ -1,4 +1,4 @@-**ภาษา:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | **ไทย** | [Deutsch](../de-DE/README.md)+**ภาษา:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | **ไทย** | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -18,7 +18,7 @@**ภาษา / Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ**-[English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | **ไทย** | [Deutsch](../de-DE/README.md)+[English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | **ไทย** | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/tr/README.md b/docs/tr/README.mdindex e5543071e..f8060ff18 100644--- a/docs/tr/README.md+++ b/docs/tr/README.md@@ -23,7 +23,7 @@**Dil / Language / 语言 / 語言 / Язык / Ngôn ngữ**-[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [**Türkçe**](README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [**Türkçe**](README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/ua-UA/README.md b/docs/ua-UA/README.mdnew file mode 100644index 000000000..51dac6e13--- /dev/null+++ b/docs/ua-UA/README.md@@ -0,0 +1,1324 @@+**Мова:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Español](../es/README.md) | [**Українська**](../ua-UA/README.md)++++[](https://discord.gg/36yGMHGFbR)+[](https://ecc.tools)+[](https://github.com/apps/ecc-tools)+[](#посібники)++[](https://github.com/affaan-m/ECC/stargazers)+[](https://github.com/affaan-m/ECC/network/members)+[](https://github.com/affaan-m/ECC/graphs/contributors)+[](https://www.npmjs.com/package/ecc-universal)+[](https://www.npmjs.com/package/ecc-agentshield)+[](https://github.com/marketplace/ecc-tools)+[](../../LICENSE)+++++++++> [!WARNING]+> **Лише офіційні джерела.** Встановлюйте 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). Сторонні перезавантаження та неофіційні дзеркала не підтримуються і не перевіряються проєктом та можуть містити шкідливе програмне забезпечення.++**211,9K+ зірок** | **32,5K+ форків** | **230+ учасників** | **12+ мовних екосистем** | **Крос-агентні робочі процеси**++---++<div align="center">++**Мова / Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ / Idioma**++[English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md)+ | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Español](../es/README.md) | [**Українська**](../ua-UA/README.md)++</div>++---++**Нативна оболонка операційної системи для агентної роботи. Побудована на основі реальних мультиоболонкових інженерних процесів.**++Не просто конфігурації. Повна система: навички, інстинкти, оптимізація пам'яті, безперервне навчання, сканування безпеки та розробка з пріоритетом досліджень. Готові до продакшну агенти, навички, хуки, правила, конфігурації MCP та застарілі командні шими, що розвивалися протягом 10+ місяців інтенсивного щоденного використання при створенні реальних продуктів.++Працює на **Codex**, **Claude Code**, **Cursor**, **OpenCode**, **Gemini**, **Zed**, **GitHub Copilot** та інших оболонках агентів ШІ.++ECC v2.0.0 додає публічну історію оператора Hermes поверх повторно використовуваного шару: почніть з [посібника з налаштування Hermes](../../docs/HERMES-SETUP.md), потім перегляньте [примітки до версії 2.0.0](../../docs/releases/2.0.0/release-notes.md) та [крос-агентну архітектуру](../../docs/architecture/cross-harness.md).++---++<table>+<tr>+<td width="25%" align="center">+ <a href="https://ecc.tools/pricing">+ <strong>⚡ ECC Pro</strong><br />+ <sub>Приватні репо · GitHub App · $19/місць/міс</sub>+ </a>+</td>+<td width="25%" align="center">+ <a href="https://github.com/sponsors/affaan-m">+ <strong>❤️ Спонсор</strong><br />+ <sub>Підтримати OSS · Від $5/міс</sub>+ </a>+</td>+<td width="25%" align="center">+ <a href="https://github.com/affaan-m/ECC/discussions">+ <strong>💬 Спільнота</strong>+ <br />+ <sub>Обговорення · Питання та відповіді · Демонстрація</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>+</tr>+</table>++<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>++<div align="center">++<sub><strong>Бізнес-спонсори</strong></sub>++<table>+<tr>+<td align="center" width="220">+ <a href="https://www.coderabbit.ai">+ <img src="../../assets/images/sponsors/coderabbit.png" width="96" alt="CodeRabbit logo" /><br />+ <strong>CodeRabbit</strong>+ </a>+</td>+<td align="center" width="220">+ <a href="https://www.greptile.com/go/ecc">+ <img src="../../assets/images/sponsors/greptile.png" width="96" alt="Greptile logo" /><br />+ <strong>Greptile</strong>+ </a>+</td>+<td align="center" width="220">+ <a href="https://www.atlascloud.ai/?utm_source=github&utm_medium=link&utm_campaign=ECC">+ <img src="../../assets/images/sponsors/atlascloud.png" width="96" alt="Atlas Cloud logo" /><br />+ <strong>Atlas Cloud</strong>+ </a>+</td>+</tr>+</table>++<sub><strong>Спонсори спільноти:</strong> <a href="https://github.com/mikejmorgan-ai">Mike Morgan</a> · <a href="https://github.com/jasonwu513">@jasonwu513</a> · <a href="https://github.com/1anter">@1anter</a> · <a href="https://github.com/massimotodaro">@massimotodaro</a> · <a href="https://github.com/meadmccabe">@meadmccabe</a></sub>++<sub><a href="https://github.com/sponsors/affaan-m"><strong>Стати спонсором</strong></a> · <a href="../../SPONSORS.md">Рівні спонсорства</a> · <a href="../../SPONSORING.md">Програма спонсорства</a></sub>++</div>++---++## Посібники++Цей репозиторій містить лише вихідний код. Посібники пояснюють усе.++<table>+<tr>+<td width="50%" align="center">+<a href="../../the-shortform-guide.md">+<img src="../../assets/images/shortform/00-header.png" width="420" alt="Короткий посібник з ECC" /><br />+<b>Короткий посібник</b>+</a>+<br /><sub>Налаштування, основи, філософія. <b>Читайте спочатку.</b> (<a href="https://x.com/affaan/status/2012378465664745795">нитка</a>)</sub>+</td>+<td width="50%" align="center">+<a href="../../the-longform-guide.md">+<img src="../../assets/images/longform/01-header.png" width="420" alt="Розширений посібник з ECC" /><br />+<b>Розширений посібник</b>+</a>+<br /><sub>Оптимізація токенів, збереження пам'яті, оцінки, паралелізація. (<a href="https://x.com/affaan/status/2014040193557471352">нитка</a>)</sub>+</td>+</tr>+</table>++<div align="center">+<a href="../../the-security-guide.md">+<img src="../../assets/images/security/security-guide-header.png" width="420" alt="Короткий посібник з усього, що стосується безпеки агентів" /><br />+<b>Посібник з безпеки</b>+</a>+<br /><sub>Вектори атак, пісочниця, санітизація, CVE, AgentShield. (<a href="https://x.com/affaan/status/2033263813387223421">нитка</a>)</sub>+</div>++| Тема | Що ви дізнаєтесь |+|-------|-------------------|+| Оптимізація токенів | Вибір моделі, скорочення системного промпту, фонові процеси |+| Збереження пам'яті | Хуки, що автоматично зберігають/завантажують контекст між сесіями |+| Безперервне навчання | Автовитягування патернів із сесій у навички для повторного використання |+| Петлі верифікації | Контрольні точки проти безперервних оцінок, типи оцінювачів, метрики pass@k |+| Паралелізація | Git worktrees, каскадний метод, коли масштабувати інстанції |+| Оркестрація підагентів | Проблема контексту, патерн ітеративного отримання |++---++## Що нового++### v2.0.0 — Операційна система агентних оболонок (черв. 2026)++Стабільний випуск лінійки 2.0: 261 навичка, субстрат площини управління (адаптери сесій + інвентаризація 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 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](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).++---++## Швидкий старт++Почніть за менш ніж 2 хвилини:++### Виберіть один шлях++Більшість користувачів Claude Code повинні використовувати рівно один шлях встановлення:++- **Рекомендований стандарт:** встановіть плагін Claude Code, потім скопіюйте лише ті папки з правилами, які вам справді потрібні.+- **Використовуйте ручний інсталятор лише якщо** ви хочете більш тонкого контролю, хочете уникнути шляху плагіна, або ваша збірка Claude Code має труднощі з вирішенням запису самостійного marketplace.+- **Не комбінуйте методи встановлення.** Найпоширеніша зламана конфігурація: спочатку `/plugin install`, потім `install.sh --profile full` або `npx ecc-install --profile full`.++Якщо ви вже застосували кілька методів і виникло дублювання, перейдіть одразу до [Скидання/Видалення ECC](#скидання--видалення-ecc).++### Шлях з низьким контекстом / без хуків++Якщо хуки здаються надто глобальними або вам потрібні лише правила, агенти, команди та основні навички ECC, пропустіть плагін та використовуйте мінімальний ручний профіль:++```bash+./install.sh --profile minimal --target claude+```++```powershell+.\install.ps1 --profile minimal --target claude+# або+npx ecc-install --profile minimal --target claude+```++Цей профіль навмисно виключає `hooks-runtime`.++Якщо вам потрібен звичайний основний профіль, але з вимкненими хуками:++```bash+./install.sh --profile core --without baseline:hooks --target claude+```++Додайте хуки пізніше лише за потреби примусового виконання під час роботи:++```bash+./install.sh --target claude --modules hooks-runtime+```++### Спочатку знайдіть потрібні компоненти++Якщо ви не впевнені, який профіль або компонент ECC встановити, запитайте вбудованого консультанта з будь-якого проєкту:++```bash+npx ecc consult "security reviews" --target claude+```++Він повертає відповідні компоненти, пов'язані профілі та команди попереднього перегляду/встановлення. Використовуйте команду попереднього перегляду перед встановленням, якщо хочете перевірити точний план файлів.++### Крок 1: Встановлення плагіна (рекомендовано)++> ПРИМІТКА: Плагін зручний, але OSS-інсталятор нижче все ще є найнадійнішим шляхом, якщо ваша збірка Claude Code має труднощі з вирішенням записів самостійного marketplace.++```bash+# Додати 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 замість шляху плагіна.++```bash+# Спочатку клонуйте репозиторій+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+```++```powershell+# 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`), а не файли всередині неї, щоб відносні посилання продовжували працювати.++### Повне ручне встановлення (запасний варіант)++Використовуйте це лише якщо ви навмисно пропускаєте шлях плагіна:++```bash+./install.sh --profile full+```++```powershell+.\install.ps1 --profile full+# або+npx ecc-install --profile full+```++Якщо ви вибрали цей шлях, зупиніться. Не запускайте також `/plugin install`.++### Скидання / Видалення ECC++Якщо ECC здається продубльованим, надто нав'язливим або зламаним, не продовжуйте перевстановлювати поверх себе.++- **Шлях плагіна:** видаліть плагін з Claude Code, потім видаліть конкретні папки правил, які ви вручну скопіювали до `~/.claude/rules/ecc/`.+- **Шлях ручного інсталятора / CLI:** з кореня репозиторію спочатку перегляньте видалення:++```bash+node scripts/uninstall.js --dry-run+```++Потім видаліть файли, керовані ECC:++```bash+node scripts/uninstall.js+```++Також можна використати обгортку lifecycle:++```bash+node scripts/ecc.js list-installed+node scripts/ecc.js doctor+node scripts/ecc.js repair+node scripts/ecc.js uninstall --dry-run+```++ECC видаляє лише файли, записані в його стані встановлення. Він не видалятиме неспоріднені файли, які він не встановлював.++Якщо ви комбінували методи, очищуйте в такому порядку:++1. Видаліть встановлення плагіна Claude Code.+2. Запустіть команду видалення ECC з кореня репозиторію для видалення файлів, керованих станом встановлення.+3. Видаліть будь-які додаткові папки правил, скопійовані вручну, які вам більше не потрібні.+4. Перевстановіть один раз, використовуючи єдиний шлях.++### Крок 3: Почніть використовувати++```bash+# Навички є основною поверхнею процесів.+# Існуючі назви команд зі слешем продовжують працювати під час міграції з commands/.++# Встановлення через плагін використовує канонічну форму з простором імен+/ecc:plan "Додати автентифікацію користувача"++# Ручне встановлення зберігає коротку форму зі слешем:+# /plan "Додати автентифікацію користувача"++# Перевірте доступні команди+/plugin list ecc@ecc+```++**Ось і все!** Тепер у вас є доступ до 67 агентів, 271 навички та 92 застарілих командних шими.++### Панель керування GUI++Запустіть настільну панель керування для візуального дослідження компонентів ECC:++```bash+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) з таким пріоритетом:++1. **Змінна середовища**: `CLAUDE_PACKAGE_MANAGER`+2. **Конфіг проєкту**: `.claude/package-manager.json`+3. **package.json**: поле `packageManager`+4. **Lock-файл**: Виявлення з package-lock.json, yarn.lock, pnpm-lock.yaml або bun.lockb+5. **Глобальний конфіг**: `~/.claude/package-manager.json`+6. **Запасний варіант**: Перший доступний менеджер пакетів++Щоб встановити бажаний менеджер пакетів:++```bash+# Через змінну середовища+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.++### Елементи управління виконанням хуків++Використовуйте прапорці виконання для налаштування суворості або тимчасового вимкнення конкретних хуків:++```bash+# Профіль суворості хуків (стандарт за замовчуванням)+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:++```powershell+[Environment]::SetEnvironmentVariable('ECC_CONTEXT_MONITOR_COST_WARNINGS', 'off', 'User')+[Environment]::SetEnvironmentVariable('ECC_SESSION_RETENTION_DAYS', '14', 'User')+```++### Домашня директорія даних агента (мультиоболонкова ізоляція)++Хуки збереження пам'яті (підсумки сесій, вивчені навички, псевдоніми сесій, метрики) зберігають дані під єдиним кореневим каталогом даних агента. За замовчуванням це `~/.claude`. При використанні ECC у Claude Code та Cursor на одному комп'ютері, встановіть окремий корінь для Cursor, щоб два середовища не перезаписували файли сесій одне одного:++```bash+# Кордон лише для 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](https://github.com/affaan-m/ECC/issues/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` для локального аналізу без зовнішніх сервісів:++```bash+/skill-create # Аналізувати поточний репозиторій+/skill-create --instincts # Також генерувати інстинкти для continuous-learning-v2+```++Це аналізує вашу git-історію локально та генерує файли SKILL.md.++#### Варіант B: GitHub App (розширений)++Для розширених функцій (10k+ комітів, автоматичні PR, спільний доступ у команді):++[Встановити ECC Tools GitHub App](https://github.com/apps/ecc-tools) | [ecc.tools](https://ecc.tools)++```bash+# Коментуйте у будь-якому issue:+/ecc-tools analyze++# Або запускайте проти репозиторію з розміщеного додатка+```++Обидва варіанти створюють:+- **Файли SKILL.md** — Готові до використання навички для активної оболонки+- **Колекції інстинктів** — Для continuous-learning-v2+- **Витягування патернів** — Навчається з вашої git-історії++### AgentShield — Аудитор безпеки++> Створений на Claude Code Hackathon (Cerebral Valley x Anthropic, лют. 2026). 1282 тести, 98% покриття, 102 правила статичного аналізу.++Скануйте вашу конфігурацію Claude Code на вразливості, помилкові конфігурації та ризики ін'єкцій.++```bash+# Швидке сканування (без встановлення)+npx ecc-agentshield scan++# Автовиправлення безпечних проблем+npx ecc-agentshield scan --fix++# Глибокий аналіз з трьома агентами Opus 4.6+npx ecc-agentshield scan --opus --stream++# Генерація безпечної конфігурації з нуля+npx ecc-agentshield init+```++**Що сканується:** CLAUDE.md, settings.json, конфіги MCP, хуки, визначення агентів та навички по 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).++[GitHub](https://github.com/affaan-m/agentshield) | [npm](https://www.npmjs.com/package/ecc-agentshield)++### Безперервне навчання v2++Система навчання на основі інстинктів автоматично вивчає ваші патерни:++```bash+/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+ через зміни в тому, як система плагінів обробляє хуки.++Перевірте свою версію:+```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, що призводило до плутанини. Тепер у нас є регресійний тест для запобігання повторного введення цього.++---++## Встановлення++### Варіант 1: Встановлення як плагін (рекомендовано)++Найпростіший спосіб використання цього репозиторію — встановлення як плагін Claude Code:++```bash+# Додати цей репозиторій як marketplace+/plugin marketplace add https://github.com/affaan-m/ECC++# Встановити плагін+/plugin install ecc@ecc+```++Або додайте безпосередньо до вашого `~/.claude/settings.json`:++```json+{+ "extraKnownMarketplaces": {+ "ecc": {+ "source": {+ "source": "github",+ "repo": "affaan-m/ECC"+ }+ }+ },+ "enabledPlugins": {+ "ecc@ecc": true+ }+}+```++Це надає миттєвий доступ до всіх команд, агентів, навичок та хуків.++> **Примітка:** Система плагінів Claude Code не підтримує розповсюдження `rules` через плагіни. Вам потрібно встановити правила вручну:+>+> ```bash+> # Спочатку клонуйте репозиторій+> 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: Ручне встановлення++Якщо ви надаєте перевагу ручному контролю над тим, що встановлено:++```bash+# Клонуйте репозиторій+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` безпосередньо. Використовуйте інсталятор:++```bash+# macOS / Linux+bash ./install.sh --target claude --modules hooks-runtime+```++```powershell+# Windows PowerShell+pwsh -File .\install.ps1 --target claude --modules hooks-runtime+```++#### Налаштування MCP++Встановлення плагінів Claude навмисно не вмикають автоматично визначення вбудованих MCP-серверів ECC. Використовуйте команду `/mcp` Claude Code або налаштування MCP через CLI.++---++## Ключові концепції++### Агенти++Підагенти виконують делеговані завдання з обмеженим обсягом. Приклад:++```markdown+---+name: code-reviewer+description: Переглядає код на якість, безпеку та підтримуваність+tools: ["Read", "Grep", "Glob", "Bash"]+model: opus+---++Ви — старший рецензент коду...+```++### Навички++Навички є основною поверхнею процесів. Вони можуть викликатися безпосередньо, пропонуватися автоматично та повторно використовуватися агентами.++```markdown+# Процес TDD++1. Спочатку визначте інтерфейси+2. Напишіть непрохідні тести (ЧЕРВОНИЙ)+3. Реалізуйте мінімальний код (ЗЕЛЕНИЙ)+4. Рефакторинг (ПОКРАЩЕННЯ)+5. Перевірте покриття 80%++```++### Хуки++Хуки спрацьовують на події інструментів. Приклад — попередження про console.log:++```json+{+ "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%++```++---++## Поширені запитання++<details>+<summary><b>Як перевірити, які агенти/команди встановлено?</b></summary>++```bash+/plugin list ecc@ecc+```++Це показує всі доступні агенти, команди та навички з плагіна.+</details>++<details>+<summary><b>Мої хуки не працюють / я бачу помилки "Duplicate hooks file"</b></summary>++Це найпоширеніша проблема. **НЕ додавайте поле `"hooks"` до `.claude-plugin/plugin.json`.** Claude Code v2.1+ автоматично завантажує `hooks/hooks.json` з встановлених плагінів. Явне оголошення спричиняє помилки виявлення дублікатів. Дивіться [#29](https://github.com/affaan-m/ECC/issues/29), [#52](https://github.com/affaan-m/ECC/issues/52), [#103](https://github.com/affaan-m/ECC/issues/103).+</details>++<details>+<summary><b>Чи можна використовувати ECC з Claude Code на власному API-ендпоінті або шлюзі моделей?</b></summary>++Так. ECC не прив'язує налаштування транспорту Anthropic жорстко. Він працює локально через звичайну CLI/плагін-поверхню Claude Code, тому працює з:++- Розміщеним Anthropic Claude Code+- Офіційними налаштуваннями шлюзу Claude Code через `ANTHROPIC_BASE_URL` та `ANTHROPIC_AUTH_TOKEN`+- Сумісними власними ендпоінтами, що розуміють Anthropic API++Мінімальний приклад:++```bash+export ANTHROPIC_BASE_URL=https://your-gateway.example.com+export ANTHROPIC_AUTH_TOKEN=your-token+claude+```++</details>++<details>+<summary><b>Моє контекстне вікно скорочується / Claude вичерпує контекст</b></summary>++Забагато MCP-серверів поглинає ваш контекст. Кожен опис інструменту MCP витрачає токени з вашого вікна 200k, потенційно скорочуючи його до ~70k. Контекст SessionStart обмежений 8000 символами за замовчуванням; знизьте це за допомогою `ECC_SESSION_START_MAX_CHARS=4000` або вимкніть за допомогою `ECC_SESSION_START_CONTEXT=off` для конфігурацій з локальними моделями або низьким контекстом.++**Виправлення:** Вимкніть невикористовувані MCP у Claude Code за допомогою `/mcp`. Тримайте менше 10 активних MCP та менше 80 активних інструментів.+</details>++<details>+<summary><b>Чи можу я використовувати лише деякі компоненти (наприклад, лише агентів)?</b></summary>++Так. Використовуйте Варіант 2 (ручне встановлення) та скопіюйте лише те, що вам потрібно. Кожен компонент повністю незалежний.+</details>++<details>+<summary><b>Чи це працює з Cursor / OpenCode / Codex / Antigravity / GitHub Copilot?</b></summary>++Так. ECC є кросплатформним. Дивіться відповідні розділи нижче для деталей кожної оболонки.+</details>++<details>+<summary><b>Як зробити внесок новою навичкою або агентом?</b></summary>++Дивіться [CONTRIBUTING.md](../../CONTRIBUTING.md). Коротко:+1. Зробіть форк репозиторію+2. Створіть навичку в `skills/your-skill-name/SKILL.md` (з YAML frontmatter)+3. Або створіть агента в `agents/your-agent.md`+4. Надішліть PR з чітким описом того, що він робить і коли використовувати+</details>++---++## Запуск тестів++Плагін містить комплексний набір тестів:++```bash+# Запустити всі тести+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](../../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)++```bash+# macOS/Linux+./install.sh --target cursor typescript+./install.sh --target cursor python golang swift php+```++```powershell+# 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)++```bash+# Запустіть 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` для локальних налаштувань проєкту, вирівняних правил, агентів, команд та навичок.++```bash+./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](https://x.com/DRodriguezFX) — побудував [zenith.chat](https://zenith.chat) повністю за допомогою Claude Code.++Ці конфіги перевірені в кількох продакшн-додатках.++---++## Оптимізація токенів++Використання Claude Code може бути дорогим, якщо не керувати споживанням токенів. Ці налаштування значно знижують витрати без шкоди для якості.++### Рекомендовані налаштування++Додайте до `~/.claude/settings.json`:++```json+{+ "model": "sonnet",+ "env": {+ "MAX_THINKING_TOKENS": "10000",+ "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"+ }+}+```++| Налаштування | Стандарт | Рекомендовано | Ефект |+|---------|---------|-------------|--------|+| `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-рейту, зберігаючи попередження контексту/обсягу/циклів |++Переходьте на Opus лише для глибокого архітектурного міркування:+```+/model opus+```++### Команди щоденного процесу++| Команда | Коли використовувати |+|---------|-------------|+| `/model sonnet` | Стандарт для більшості завдань |+| `/model opus` | Складна архітектура, налагодження, глибоке міркування |+| `/clear` | Між непов'язаними завданнями (безкоштовно, миттєве скидання) |+| `/compact` | У логічних точках зупинки завдань |+| `/cost` | Моніторинг витрат токенів під час сесії |++### Стратегічний компакшн++Навичка `strategic-compact` пропонує `/compact` у логічних точках зупинки замість покладання на автокомпакшн при 95% контексту.++**Коли компактувати:**+- Після дослідження/вивчення, перед реалізацією+- Після завершення milestone, перед початком наступного+- Після налагодження, перед продовженням роботи з функцією+- Після невдалого підходу, перед спробою нового++**Коли НЕ компактувати:**+- В середині реалізації (ви втратите назви змінних, шляхи до файлів, частковий стан)++---++## ПОПЕРЕДЖЕННЯ: Важливі примітки++### Оптимізація токенів++Досягаєте щоденних лімітів? Дивіться **[Посібник з оптимізації токенів](../../docs/token-optimization.md)**.++Швидкі виграші:++```json+// ~/.claude/settings.json+{+ "model": "sonnet",+ "env": {+ "MAX_THINKING_TOKENS": "10000",+ "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",+ "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"+ }+}+```++### Налаштування++Ці конфіги підходять для мого процесу. Вам слід:+1. Почати з того, що резонує+2. Змінити для вашого стеку+3. Видалити те, що ви не використовуєте+4. Додати власні патерни++---++## Безпека++ECC серйозно ставиться до безпеки ланцюжка поставок та агентної безпеки.++- **Лише офіційні джерела.** Встановлюйте ECC лише з перевірених каналів, перелічених у банері вгорі цього README.+- **Повідомте про вразливість.** Використовуйте приватний процес у [SECURITY.md](../../SECURITY.md) (приватне звітування про вразливість GitHub). Будь ласка, не відкривайте публічні issues для звітів про безпеку.+- **Вбудовані захисні механізми.** GateGuard захищає деструктивні команди оболонки перед їх виконанням; сканер IOC ланцюжка поставок запускається в CI; [AgentShield](#agentshield--аудитор-безпеки) перевіряє ваш агент, хуки, MCP, дозволи та секретні поверхні (`/security-scan`).+- **Детальна інформація.** Дивіться [Посібник з безпеки](../../the-security-guide.md).++---++## Спонсори++Основні спонсори вказані вгорі цього README — повний список та рівні в [SPONSORS.md](../../SPONSORS.md). [Стати спонсором](https://github.com/sponsors/affaan-m).++---++## Посилання++- **Короткий посібник (Почніть тут):** [Короткий посібник з ECC](https://x.com/affaan/status/2012378465664745795)+- **Розширений посібник (Для досвідчених):** [Розширений посібник з ECC](https://x.com/affaan/status/2014040193557471352)+- **Посібник з безпеки:** [Посібник з безпеки](../../the-security-guide.md) | [Нитка](https://x.com/affaan/status/2033263813387223421)+- **Підписатись:** [@affaan](https://x.com/affaan)++---++## Ліцензія++MIT — Використовуйте вільно, змінюйте за потреби, робіть внески якщо можете.++---++**Поставте зірку цьому репозиторію, якщо він допоміг вам. Читайте обидва посібники. Будуйте щось чудове.**diff --git a/docs/ur/README.md b/docs/ur/README.mdindex 7981c2a50..81cf64d2d 100644--- a/docs/ur/README.md+++ b/docs/ur/README.md@@ -1,4 +1,4 @@-**زبان:** [English](../../README.md) | [اردو](README.md) | [Deutsch](../de-DE/README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)+**زبان:** [English](../../README.md) | [اردو](README.md) | [Deutsch](../de-DE/README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Українська](../ua-UA/README.md)# ECC@@ -27,7 +27,7 @@**زبان / Language / 语言**-[English](../../README.md) | [**اردو**](README.md) | [Deutsch](../de-DE/README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)+[English](../../README.md) | [**اردو**](README.md) | [Deutsch](../de-DE/README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/vi-VN/README.md b/docs/vi-VN/README.mdindex 8ab38f6b1..9d5214cce 100644--- a/docs/vi-VN/README.md+++ b/docs/vi-VN/README.md@@ -1,4 +1,4 @@-**Ngôn ngữ:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | **Tiếng Việt** | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+**Ngôn ngữ:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | **Tiếng Việt** | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -18,7 +18,7 @@**Ngôn ngữ / Language / 语言 / 語言 / Dil / Язык**-[English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | **Tiếng Việt** | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+[English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | **Tiếng Việt** | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.mdindex 00379bf2e..4935b7f90 100644--- a/docs/zh-CN/README.md+++ b/docs/zh-CN/README.md@@ -1,4 +1,4 @@-**语言:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)+**语言:** [English](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Українська](../ua-UA/README.md)# Everything Claude Code@@ -25,7 +25,7 @@**语言 / Language / 語言 / Dil / Язык / Ngôn ngữ**-[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md)+[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | [繁體中文](../zh-TW/README.md) | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/docs/zh-TW/README.md b/docs/zh-TW/README.mdindex 7d9b6adbb..c3179c2ba 100644--- a/docs/zh-TW/README.md+++ b/docs/zh-TW/README.md@@ -13,7 +13,7 @@**Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ**-[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | **繁體中文** | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md)+[**English**](../../README.md) | [Português (Brasil)](../pt-BR/README.md) | [简体中文](../../README.zh-CN.md) | **繁體中文** | [日本語](../ja-JP/README.md) | [한국어](../ko-KR/README.md) | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Deutsch](../de-DE/README.md) | [Українська](../ua-UA/README.md)</div>diff --git a/scripts/lib/install-manifests.js b/scripts/lib/install-manifests.jsindex 4fb04b7a9..34c11fd50 100644--- a/scripts/lib/install-manifests.js+++ b/scripts/lib/install-manifests.js@@ -14,7 +14,7 @@ const COMPONENT_FAMILY_PREFIXES = {skill: 'skill:',locale: 'locale:',};-const SUPPORTED_LOCALES = Object.freeze(['ja', 'zh-CN', 'ko-KR', 'pt-BR', 'ru', 'tr', 'vi-VN', 'zh-TW', 'de-DE']);+const SUPPORTED_LOCALES = Object.freeze(['ja', 'zh-CN', 'ko-KR', 'pt-BR', 'ru', 'tr', 'vi-VN', 'zh-TW', 'de-DE', 'ua-UA']);const LOCALE_ALIAS_TO_COMPONENT_ID = Object.freeze({'ja': 'locale:ja','ja-JP': 'locale:ja',@@ -31,6 +31,7 @@ const LOCALE_ALIAS_TO_COMPONENT_ID = Object.freeze({'zh-TW': 'locale:zh-tw','de-DE': 'locale:de-de','de': 'locale:de-de',+ 'ua-UA': 'locale:ua'});function listSupportedLocales() {