diff --git a/README.md b/README.md
index 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)
diff --git a/docs/de-DE/README.md b/docs/de-DE/README.md
index 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)
# ECC
diff --git a/docs/es/README.md b/docs/es/README.md
index 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)
# ECC
diff --git a/docs/ja-JP/README.md b/docs/ja-JP/README.md
index 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)
---
diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md
index 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)
diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.md
index 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)
---
diff --git a/docs/ru/README.md b/docs/ru/README.md
index 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)
diff --git a/docs/th/README.md b/docs/th/README.md
index 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)
diff --git a/docs/tr/README.md b/docs/tr/README.md
index 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)
diff --git a/docs/ua-UA/README.md b/docs/ua-UA/README.md
new file mode 100644
index 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+ мовних екосистем** | **Крос-агентні робочі процеси**
+
+---
+
+
+
+**Мова / 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)
+
+
+
+---
+
+**Нативна оболонка операційної системи для агентної роботи. Побудована на основі реальних мультиоболонкових інженерних процесів.**
+
+Не просто конфігурації. Повна система: навички, інстинкти, оптимізація пам'яті, безперервне навчання, сканування безпеки та розробка з пріоритетом досліджень. Готові до продакшну агенти, навички, хуки, правила, конфігурації 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).
+
+---
+
+
+
+**OSS залишається безкоштовним.** Цей репозиторій ліцензований за MIT назавжди. ECC Pro — розміщений GitHub App для приватних репозиторіїв. Спонсори та Pro-підписники фінансують роботу — саме тому один розробник щотижня випускає оновлення для 7 оболонок.
+
+
+
+---
+
+## Посібники
+
+Цей репозиторій містить лише вихідний код. Посібники пояснюють усе.
+
+
+
+
+
+| Тема | Що ви дізнаєтесь |
+|-------|-------------------|
+| Оптимізація токенів | Вибір моделі, скорочення системного промпту, фонові процеси |
+| Збереження пам'яті | Хуки, що автоматично зберігають/завантажують контекст між сесіями |
+| Безперервне навчання | Автовитягування патернів із сесій у навички для повторного використання |
+| Петлі верифікації | Контрольні точки проти безперервних оцінок, типи оцінювачів, метрики 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 # Імпортувати інстинкти від інших
+/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%+
+```
+
+---
+
+## Поширені запитання
+
+
+Як перевірити, які агенти/команди встановлено?
+
+```bash
+/plugin list ecc@ecc
+```
+
+Це показує всі доступні агенти, команди та навички з плагіна.
+
+
+
+Мої хуки не працюють / я бачу помилки "Duplicate hooks file"
+
+Це найпоширеніша проблема. **НЕ додавайте поле `"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).
+
+
+
+Чи можна використовувати ECC з Claude Code на власному API-ендпоінті або шлюзі моделей?
+
+Так. 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
+```
+
+
+
+
+Моє контекстне вікно скорочується / 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](../../CONTRIBUTING.md). Коротко:
+1. Зробіть форк репозиторію
+2. Створіть навичку в `skills/your-skill-name/SKILL.md` (з YAML frontmatter)
+3. Або створіть агента в `agents/your-agent.md`
+4. Надішліть PR з чітким описом того, що він робить і коли використовувати
+
+
+---
+
+## Запуск тестів
+
+Плагін містить комплексний набір тестів:
+
+```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.md
index 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)
diff --git a/docs/vi-VN/README.md b/docs/vi-VN/README.md
index 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)
diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md
index 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)
diff --git a/docs/zh-TW/README.md b/docs/zh-TW/README.md
index 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)
diff --git a/scripts/lib/install-manifests.js b/scripts/lib/install-manifests.js
index 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() {
