Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

docs(i18n): add Polish localization scout

Dante3e72db8aa524
diff --git a/README.md b/README.md
index 86dba5120..8e5fc0aac 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,8 @@
<a href="docs/th/README.md">ไทย</a> |
<a href="docs/de-DE/README.md">Deutsch</a> |
<a href="docs/es/README.md">Español</a> |
- <a href="docs/uk-UA/README.md">Українська</a>
+ <a href="docs/uk-UA/README.md">Українська</a> |
+ <a href="docs/pl/README.md">Polski</a>
</p>
<p align="center">
diff --git a/README.zh-CN.md b/README.zh-CN.md
index e01fd54e2..4c589f54b 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -23,7 +23,7 @@
**Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ**
-[**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)
+[**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) | [Polski](docs/pl/README.md)
</div>
diff --git a/docs/de-DE/README.md b/docs/de-DE/README.md
index 4ae0f5a53..d2d7aa437 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
# ECC
@@ -28,7 +28,7 @@
**Language / 语言 / 語言 / Dil / Язык / Ngôn ngữ**
[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) | [Українська](../uk-UA/README.md)
+ | [Türkçe](../tr/README.md) | [Русский](../ru/README.md) | [Tiếng Việt](../vi-VN/README.md) | [ไทย](../th/README.md) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/es/README.md b/docs/es/README.md
index 040b28811..9fb6a42c0 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** | [Українська](../uk-UA/README.md)
+**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** | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
# ECC
@@ -28,7 +28,7 @@
**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** | [Українська](../uk-UA/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** | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/ja-JP/README.md b/docs/ja-JP/README.md
index e01e9c11b..03b91088d 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
# Everything Claude Code
@@ -21,7 +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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
---
diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md
index 9adc19ea1..3d20673fc 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/pl/GLOSSARY.md b/docs/pl/GLOSSARY.md
new file mode 100644
index 000000000..8fe10c585
--- /dev/null
+++ b/docs/pl/GLOSSARY.md
@@ -0,0 +1,65 @@
+# Glosariusz / Glossary
+
+Ujednolicona terminologia polskiego tłumaczenia ECC.
+
+Nazwy powierzchni ECC oraz powszechne terminy techniczne pozostają po angielsku, gdy ich
+spolszczenie utrudniałoby powiązanie tekstu z nazwą katalogu, poleceniem lub interfejsem.
+W zwykłym opisie można użyć polskiego odpowiednika wskazanego poniżej.
+
+| English | Polski | Uwagi |
+|---|---|---|
+| Agent | Agent | nazwa powierzchni `agents/`; liczba mnoga: Agenty |
+| Skill | Skill | nazwa powierzchni `skills/`; liczba mnoga: Skille |
+| Hook | Hook | nazwa powierzchni `hooks/`; liczba mnoga: Hooki |
+| Command | Command | nazwa powierzchni `commands/`; ogólnie: „polecenie” |
+| Rule | Rule | nazwa powierzchni `rules/`; ogólnie: „reguła” |
+| Harness | środowisko agenta | „Harness” dopuszczalne w kontekście nazwy technicznej |
+| Instinct | Instinct | termin funkcji Continuous Learning |
+| Plugin | plugin | |
+| Marketplace | marketplace | nazwa powierzchni produktu |
+| Worktree | worktree | termin Git |
+| Subagent | subagent | |
+| Frontmatter | frontmatter | nazwy pól YAML pozostają po angielsku |
+| Continuous Learning | Continuous Learning | nazwa funkcji; opisowo: „ciągłe uczenie” |
+| Memory | pamięć | jako nazwa funkcji może pozostać po angielsku |
+| Context window | okno kontekstu | |
+| Token | token | |
+| Coverage | pokrycie testami | |
+| Test-Driven Development | programowanie sterowane testami | zachowaj skrót TDD |
+| Code review | przegląd kodu | |
+| Refactoring | refaktoryzacja | |
+| Pull request | pull request | zachowaj skrót PR |
+| Commit | commit | |
+| Branch | gałąź | |
+| Merge | scalenie | jako czasownik: „scalić” |
+| Build | build | opisowo: „kompilacja” lub „artefakt” zależnie od kontekstu |
+| Deploy | wdrożenie | |
+| Pipeline | pipeline | |
+| Orchestration | orkiestracja | |
+| Repository | repozytorium | skrót: repo |
+| Dependency | zależność | |
+| Edge case | przypadek brzegowy | |
+| Best practice | dobra praktyka | |
+| Anti-pattern | antywzorzec | |
+| Middleware | middleware | |
+| Endpoint | endpoint | |
+| Schema | schemat | |
+| Payload | payload | opisowo: „dane żądania” |
+| Callback | callback | |
+| Checkpoint | punkt kontrolny | |
+| Linter | linter | |
+| Formatter | formatter | |
+| Staging | środowisko testowe | zależnie od kontekstu także „staging” |
+| Production | produkcja | „środowisko produkcyjne” |
+| Debugging | debugowanie | |
+| Logging | logowanie | nie mylić z logowaniem użytkownika; w razie potrzeby „rejestrowanie zdarzeń” |
+| Monitoring | monitoring | |
+| Rate limit | limit żądań | |
+| Retry | ponowienie | |
+| Fallback | rozwiązanie zapasowe | |
+| Sandboxing | izolacja w sandboxie | |
+| Sanitization | sanityzacja | |
+| Selective install | instalacja selektywna | |
+| Profile | profil | profil instalacji |
+| Component | komponent | komponent instalatora |
+| Module | moduł | moduł instalatora |
diff --git a/docs/pl/README.md b/docs/pl/README.md
new file mode 100644
index 000000000..f16760ce1
--- /dev/null
+++ b/docs/pl/README.md
@@ -0,0 +1,184 @@
+**Język:** [English](../../README.md) | **Polski** | [Deutsch](../de-DE/README.md) | [Español](../es/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) | [Українська](../uk-UA/README.md)
+
+# ECC
+
+![ECC — system operacyjny dla pracy agentowej, natywny dla środowisk agentów](../../assets/hero.png)
+
+> Tłumaczenie obejmuje przewodnik startowy i najważniejsze powierzchnie ECC. Źródło angielskie:
+> commit `8321021c54d670126ce3b2969d5deb880b4b0c2a` z gałęzi `main`.
+> Pełny, aktualny katalog pozostaje w [angielskim README](../../README.md); kolejne obszary będą
+> tłumaczone etapami, aby ograniczyć rozmiar i ryzyko nieaktualnych zmian.
+
+---
+
+**Natywny dla środowisk agentów system operacyjny do pracy agentowej.**
+
+ECC to nie tylko zestaw konfiguracji. Łączy gotowe do użycia Agenty, Skille, Hooki, Rules,
+konfiguracje MCP i warstwę zgodności ze starszymi Commands. System powstał na podstawie
+rzeczywistych przepływów pracy i działa w wielu środowiskach: **Claude Code**, **Codex**,
+**Cursor**, **OpenCode**, **Gemini**, **Zed**, **GitHub Copilot** i innych.
+
+## Oficjalne źródła
+
+Instaluj ECC wyłącznie ze zweryfikowanych kanałów:
+
+- repozytorium [github.com/affaan-m/ECC](https://github.com/affaan-m/ECC),
+- pakiety npm [`ecc-universal`](https://www.npmjs.com/package/ecc-universal) i
+ [`ecc-agentshield`](https://www.npmjs.com/package/ecc-agentshield),
+- aplikacja [ECC Tools dla GitHub](https://github.com/apps/ecc-tools),
+- identyfikator pluginu `ecc@ecc`,
+- witryna [ecc.tools](https://ecc.tools).
+
+Nieoficjalne kopie i mirrory nie są utrzymywane ani sprawdzane przez projekt.
+
+## Szybki start
+
+Wybierz **jedną** ścieżkę instalacji. Łączenie instalacji pluginu z pełną instalacją ręczną
+jest najczęstszą przyczyną zduplikowanych Agentów, Skilli i Hooków.
+
+### Uniwersalna konfiguracja prowadzona
+
+```bash
+```
+
+Możesz także użyć właściwego menedżera pakietów:
+
+```bash
+pnpm dlx [email protected] setup
+yarn dlx [email protected] setup
+bunx [email protected] setup
+```
+
+Przed uruchomieniem kodu pakietu sprawdź źródło wydania i integralność rejestru.
+
+### Claude Code
+
+W Claude Code dodaj marketplace i zainstaluj plugin:
+
+```text
+/plugin marketplace add https://github.com/affaan-m/ECC
+/plugin install ecc@ecc
+```
+
+Następnie zacznij od `rules/common` oraz tylko tych pakietów językowych lub frameworków,
+których rzeczywiście używasz. Po instalacji pluginu nie uruchamiaj dodatkowo pełnego
+`./install.sh --profile full`.
+
+### Codex
+
+```bash
+codex plugin marketplace add affaan-m/ECC
+codex plugin add ecc@ecc
+```
+
+W Codex użyj `$configure-ecc`, aby przejść przez konfigurację dostosowaną do dostawcy.
+
+### Inne środowiska
+
+| Środowisko | Minimalna instalacja |
+|---|---|
+| Cursor | `./install.sh --profile minimal --target cursor` |
+| Gemini CLI | `./install.sh --profile minimal --target gemini` |
+| Zed | `./install.sh --profile minimal --target zed` |
+| OpenCode | `npm install && npm run build:opencode && ./install.sh --profile full --target opencode --enable-hooks` |
+| Hermes | `./install.sh --profile minimal --target hermes` |
+| OpenClaw | `./install.sh --profile minimal --target openclaw` |
+| Kimi Code CLI | `./install.sh --profile minimal --target kimi` |
+
+Pełna macierz środowisk i wymagania znajdują się w
+[angielskiej sekcji Platform Support](../../README.md#platform-support).
+
+## Instalacja polskiej dokumentacji
+
+Polski używa krótkiego kodu języka `pl`; nie jest potrzebny wariant regionalny. Obie formy
+polecenia poniżej wybierają komponent `locale:pl` i instalują dokumentację w
+`~/.claude/docs/pl/`:
+
+```bash
+./install.sh --target claude --locale pl
+npx [email protected] install --target claude --locale pl
+```
+
+Najpierw możesz obejrzeć plan bez zapisywania zmian:
+
+```bash
+./install.sh --target claude --locale pl --dry-run
+```
+
+## Co zawiera ECC
+
+| Powierzchnia | Rola |
+|---|---|
+| `agents/` | wyspecjalizowane Agenty do planowania, implementacji, przeglądu i diagnostyki |
+| `skills/` | modułowe procedury i wiedza aktywowane zależnie od zadania |
+| `hooks/` | automatyzacje uruchamiane przy zdarzeniach środowiska |
+| `rules/` | stałe zasady wspólne oraz reguły języków i frameworków |
+| `commands/` | starsza warstwa zgodności dla poleceń slash |
+| `mcp-configs/` | konfiguracje serwerów Model Context Protocol |
+| `manifests/` | deklaratywne moduły, komponenty i profile instalatora |
+
+Kierunek projektu jest **skills-first**: nowe przepływy pracy powinny trafiać najpierw do
+`skills/`; `commands/` pozostaje powierzchnią zgodności tam, gdzie nadal jest potrzebna.
+
+## Najważniejsze pojęcia
+
+### Agenty
+
+Agent ma określoną rolę, zestaw narzędzi i sposób pracy. Przykłady obejmują planistę,
+recenzentów kodu dla konkretnych języków oraz specjalistów od rozwiązywania błędów kompilacji.
+
+### Skille
+
+Skill przechowuje skoncentrowaną procedurę lub wiedzę dziedzinową. Dzięki temu kontekst jest
+ładowany tylko wtedy, gdy pasuje do zadania, zamiast powiększać każdy prompt systemowy.
+
+### Hooki
+
+Hook reaguje na zdarzenia takie jak rozpoczęcie sesji lub użycie narzędzia. Hooki muszą być
+przenośne i bezpieczne; nie kopiuj ich drugi raz do ustawień po instalacji pluginu, ponieważ
+nowe wersje Claude Code ładują `hooks/hooks.json` automatycznie.
+
+### Rules
+
+Rules opisują zawsze obowiązujące konwencje. Instaluj wspólny rdzeń i tylko pasujące pakiety,
+aby nie obciążać okna kontekstu nieistotnymi regułami.
+
+Sposób tłumaczenia terminów ECC opisuje [polski glosariusz](GLOSSARY.md).
+
+## Bezpieczeństwo
+
+- Nie zapisuj kluczy API, haseł ani tokenów w repozytorium.
+- Przeglądaj skrypty i źródła pakietów przed uruchomieniem.
+- Nie łącz wielu metod instalacji.
+- Nie kopiuj surowego `hooks/hooks.json` do `~/.claude/settings.json` po instalacji pluginu.
+- Używaj minimalnych uprawnień i weryfikuj wejścia na granicach systemu.
+
+Szczegółowe informacje znajdują się w [sekcji Security](../../README.md#security).
+
+## Aktualizowanie tłumaczenia
+
+Tłumaczenia są utrzymywane według zasady „best effort”. Każdy PR powinien podawać:
+
+1. commit angielskiego źródła,
+2. dokładny zakres przetłumaczonej treści,
+3. zmiany w terminologii względem [GLOSSARY.md](GLOSSARY.md),
+4. wykonane sprawdzenia linków, Markdownu i manifestów instalatora.
+
+Kolejne PR-y powinny być małe i podzielone według domen, na przykład `commands/`, `agents/`,
+`rules/` i `skills/`. Pozwala to uniknąć nakładających się tłumaczeń i ułatwia synchronizację
+z szybko zmieniającym się źródłem angielskim.
+
+## Współtworzenie
+
+Przed rozpoczęciem większego tłumaczenia sprawdź istniejące issues i PR-y, aby uniknąć
+równoległej pracy nad tym samym zakresem. Zasady tworzenia zmian i opisów PR znajdują się w
+[CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+## Licencja
+
+MIT — możesz swobodnie używać i dostosowywać projekt oraz dzielić się ulepszeniami.
+
+---
+
+**Jeśli ECC Ci pomaga, zostaw gwiazdkę. Przeczytaj przewodniki. Zbuduj coś świetnego.**
diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.md
index c0d9203b6..a2c57bf89 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
# Everything Claude Code
@@ -24,7 +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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
---
diff --git a/docs/ru/README.md b/docs/ru/README.md
index 537770e85..64f6f0f6d 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/th/README.md b/docs/th/README.md
index 01e48b871..2110b5e77 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/tr/README.md b/docs/tr/README.md
index f7546bed7..8545b0890 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/uk-UA/README.md b/docs/uk-UA/README.md
index d3057cbf8..434f50e33 100644
--- a/docs/uk-UA/README.md
+++ b/docs/uk-UA/README.md
@@ -16,7 +16,8 @@
<a href="../th/README.md">ไทย</a> |
<a href="../de-DE/README.md">Deutsch</a> |
<a href="../es/README.md">Español</a> |
- <a href="../uk-UA/README.md">Українська</a>
+ <a href="../uk-UA/README.md">Українська</a> |
+ <a href="../pl/README.md">Polski</a>
</p>
<p align="center">
diff --git a/docs/ur/README.md b/docs/ur/README.md
index a91e4f698..a711c83a7 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/vi-VN/README.md b/docs/vi-VN/README.md
index 4c9b3d8f7..aff90f2cb 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md
index 422f22d5d..6db84aeab 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/docs/zh-TW/README.md b/docs/zh-TW/README.md
index 4d46dfce2..194e98af5 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) | [Українська](../uk-UA/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) | [Українська](../uk-UA/README.md) | [Polski](../pl/README.md)
</div>
diff --git a/manifests/install-components.json b/manifests/install-components.json
index 8a6205bbd..5f8970c75 100644
--- a/manifests/install-components.json
+++ b/manifests/install-components.json
@@ -677,6 +677,14 @@
"modules": [
"docs-uk-ua"
]
+ },
+ {
+ "id": "locale:pl",
+ "family": "locale",
+ "description": "Polish (pl) translated reference docs installed to ~/.claude/docs/pl/.",
+ "modules": [
+ "docs-pl"
+ ]
}
]
}
diff --git a/manifests/install-modules.json b/manifests/install-modules.json
index 884c7d39d..3d24b2edf 100644
--- a/manifests/install-modules.json
+++ b/manifests/install-modules.json
@@ -1177,6 +1177,22 @@
"defaultInstall": false,
"cost": "heavy",
"stability": "stable"
+ },
+ {
+ "id": "docs-pl",
+ "kind": "docs",
+ "description": "Polish (pl) translated reference docs for agents, commands, skills, and rules.",
+ "paths": [
+ "docs/pl"
+ ],
+ "targets": [
+ "claude",
+ "claude-project"
+ ],
+ "dependencies": [],
+ "defaultInstall": false,
+ "cost": "heavy",
+ "stability": "stable"
}
]
}
diff --git a/package.json b/package.json
index 87487a914..3813a9fe3 100644
--- a/package.json
+++ b/package.json
@@ -75,6 +75,7 @@
"docs/ja-JP/",
"docs/ko-KR/",
"docs/pt-BR/",
+ "docs/pl/",
"docs/ru/",
"docs/tr/",
"docs/uk-UA/",
diff --git a/scripts/lib/install-manifests.js b/scripts/lib/install-manifests.js
index bb16cc93c..6d0fac5cf 100644
--- a/scripts/lib/install-manifests.js
+++ b/scripts/lib/install-manifests.js
@@ -15,7 +15,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', 'uk-UA']);
+const SUPPORTED_LOCALES = Object.freeze(['ja', 'zh-CN', 'ko-KR', 'pt-BR', 'ru', 'tr', 'vi-VN', 'zh-TW', 'de-DE', 'uk-UA', 'pl']);
const LOCALE_ALIAS_TO_COMPONENT_ID = Object.freeze({
'ja': 'locale:ja',
'ja-JP': 'locale:ja',
@@ -33,7 +33,9 @@ const LOCALE_ALIAS_TO_COMPONENT_ID = Object.freeze({
'de-DE': 'locale:de-de',
'de': 'locale:de-de',
'uk-UA': 'locale:uk-ua',
- 'uk': 'locale:uk-ua'
+ 'uk': 'locale:uk-ua',
+ 'pl': 'locale:pl',
+ 'pl-PL': 'locale:pl'
});
function listSupportedLocales() {
diff --git a/tests/lib/locale-install.test.js b/tests/lib/locale-install.test.js
index ceb3b489b..373427224 100644
--- a/tests/lib/locale-install.test.js
+++ b/tests/lib/locale-install.test.js
@@ -52,9 +52,63 @@ function runTests() {
assert.ok(components.some(component => component.id === 'locale:zh-cn'));
assert.ok(components.some(component => component.id === 'locale:de-de'));
assert.ok(components.some(component => component.id === 'locale:uk-ua'));
+ assert.ok(components.some(component => component.id === 'locale:pl'));
assert.ok(components.every(component => component.family === 'locale'));
})) passed++; else failed++;
+ if (test('locale:pl resolves to the Polish translated docs module', () => {
+ const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'locale-plan-pl-'));
+ try {
+ const plan = resolveInstallPlan({
+ includeComponentIds: ['locale:pl'],
+ target: 'claude',
+ homeDir,
+ });
+
+ assert.deepStrictEqual(plan.selectedModuleIds, ['docs-pl']);
+ assert.ok(
+ plan.operations.some(operation => (
+ normalizePlanPath(operation.sourceRelativePath) === 'docs/pl'
+ && normalizePlanPath(operation.destinationPath).endsWith('/.claude/docs/pl')
+ )),
+ 'Should map docs/pl to ~/.claude/docs/pl'
+ );
+ } finally {
+ fs.rmSync(homeDir, { recursive: true, force: true });
+ }
+ })) passed++; else failed++;
+
+ if (test('end-to-end: --locale pl-PL dry-run includes docs-pl operations', () => {
+ const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'locale-dry-run-pl-'));
+ const projectDir = fs.mkdtempSync(path.join(os.tmpdir(), 'locale-dry-run-pl-project-'));
+
+ try {
+ const output = runInstallApply([
+ '--locale', 'pl-PL',
+ '--dry-run',
+ '--json',
+ ], {
+ cwd: projectDir,
+ env: { HOME: homeDir },
+ });
+ const json = JSON.parse(output);
+
+ assert.strictEqual(json.plan.mode, 'manifest');
+ assert.deepStrictEqual(json.plan.includedComponentIds, ['locale:pl']);
+ assert.deepStrictEqual(json.plan.selectedModuleIds, ['docs-pl']);
+ assert.ok(
+ json.plan.operations.some(operation => (
+ normalizePlanPath(operation.sourceRelativePath) === 'docs/pl/README.md'
+ && normalizePlanPath(operation.destinationPath).endsWith('/.claude/docs/pl/README.md')
+ )),
+ 'Should copy translated README into ~/.claude/docs/pl'
+ );
+ } finally {
+ fs.rmSync(homeDir, { recursive: true, force: true });
+ fs.rmSync(projectDir, { recursive: true, force: true });
+ }
+ })) passed++; else failed++;
+
if (test('locale:uk-ua resolves to the Ukrainian translated docs module', () => {
const homeDir = fs.mkdtempSync(path.join(os.tmpdir(), 'locale-plan-uk-'));
try {