init
Release Please / release-please (push) Failing after 4m2s
Web CI / web typecheck + build (push) Successful in 3m39s
CodeQL Analysis / Analyze (javascript-typescript) (push) Failing after 1h1m49s
CodeQL Analysis / Analyze (go) (push) Failing after 1h1m49s

This commit is contained in:
redlineo committed 2026-07-13 10:14:00 +03:00
commit d295c7f139
1527 files changed
+270726

No files matched your search

+118
View File
@@ -0,0 +1,118 @@
# career-ops — Українські режими (`modes/ua/`)
Цей каталог містить україномовні версії режимів career-ops для шукачів роботи, які працюють на українському ринку праці або з вакансіями на ринку України.
## Коли використовувати?
Використовуй `modes/ua/`, якщо виконується хоча б одна з умов:
- Ти відгукуєшся на **вакансії українського ринку** — навіть якщо JD англійською (DOU.ua, Djinni.co, robota.ua, work.ua, LinkedIn Ukraine)
- Твоє **резюме українською** або ти перемикаєшся між UA та EN залежно від вакансії
- Тобі потрібні оцінки, звіти, CV та супровідні листи **з урахуванням специфіки українського ринку**
- Ти працюєш з **особливостями українського ринку**: ФОП 3-тя група, Дія City, КЗпП, ПДФО 18% + військовий збір, зарплати в USD, медстрахування
> **Важливо:** Більшість вакансій в українському ІТ написані англійською, але це все одно український ринок — з ФОП-оформленням, USD-зарплатами, DOU.ua salary bands, специфічними бенефітами та трудовим правом. Стандартні англійські режими з `modes/` не знають цього контексту. Використовуй `modes/ua/` для будь-яких вакансій на українському ринку, незалежно від мови JD.
## Як активувати?
### Спосіб 1 — Per session, за командою
Скажи Claude на початку сесії:
> "Використовуй українські режими з `modes/ua/`."
або
> "Оцінки та відгуки українською — використовуй `modes/ua/_shared.md` та `modes/ua/oferta.md`."
Claude буде читати файли з цього каталогу. Якщо режиму немає в `modes/ua/` (наприклад, `scan`, `batch`, `pdf`), використовується оригінал з `modes/`.
### Спосіб 2 — Постійно, через профіль
Додай у `config/profile.yml`:
```yaml
language:
primary: ua
modes_dir: modes/ua
```
Нагадай Claude в першій сесії: "Дивись в `profile.yml`, я вказав `language.modes_dir`".
> Примітка: `language.modes_dir` — конвенція проєкту (аналогічно `modes/de/` та `modes/fr/`, а не автоматичний механізм у коді. Claude слідує їй як вказівці за наявності нагадування. Якщо агент не підхопив налаштування — нагадайте ще раз.
## Що перекладено?
Перша ітерація охоплює режими з найбільшим впливом:
| Файл | Оригінал | Призначення |
| ------------------- | ------------------------------ | ----------------------------------------------------------------------- |
| `_shared.md` | `modes/_shared.md` (EN) | Спільний контекст, архетипи, глобальні правила, специфіка ринку України |
| `oferta.md` | `modes/oferta.md` (ES) | Повна оцінка вакансії (блоки A-F) |
| `apply.md` | `modes/apply.md` (ES) | Асистент заповнення форм відгуків |
| `pipeline.md` | `modes/pipeline.md` (ES) | Черга URL-ів / Second Brain для зібраних вакансій |
| `interview-prep.md` | `modes/interview-prep.md` (EN) | Підготовка до співбесіди |
Решта режимів (`scan`, `batch`, `pdf`, `tracker`, `auto-pipeline`, `deep`, `contacto`, `ofertas`, `project`, `training`) залишаються на EN/ES. Їхній вміст — переважно tooling, шляхи та команди — не залежить від мови.
## Що залишається англійською?
Свідомо не перекладено, бо це стандартний tech-словник:
- `cv.md`, `pipeline`, `tracker`, `report`, `score`, `archetype`, `proof point`
- Імена інструментів (`Playwright`, `WebSearch`, `WebFetch`, `Read`, `Write`, `Edit`, `Bash`)
- Статуси в трекері (`Evaluated`, `Applied`, `Interview`, `Offer`, `Rejected`)
- Код, шляхи, команди
Режими використовують технічну українську, як нею говорять у реальних командах: український текст, англійські терміни там, де вони загальноприйняті. Жодної примусової українізації "pipeline" → "конвеєр", "cv.md" → "файл-резюме".
## Словник
| English | Українська (у цій кодовій базі) |
| ---------------------------------- | -------------------------------------- |
| Job posting | Вакансія |
| Application | Відгук / заявка |
| Cover letter | Супровідний лист |
| Resume / CV | Резюме |
| Salary | Зарплата |
| Compensation | Компенсація / винагорода / зарплатня |
| Skills | Навички |
| Interview | Співбесіда |
| Hiring manager | Наймаючий менеджер |
| Recruiter | Рекрутер |
| AI | ШІ (Штучний інтелект) |
| Requirements | Вимоги |
| Career history | Досвід роботи |
| Notice period | Термін відпрацювання |
| Probation | Випробувальний термін |
| Vacation | Відпустка |
| Remote | Віддалено / ремоут |
| Hybrid | Гібрид |
| On-site | Офіс |
| Benefits | Бенефіти / пільги |
| Gross salary | Зарплата до вирахувань (gross) |
| Net salary | Зарплата на руки (net) |
| Individual entrepreneur (FOP) | ФОП (фізична особа-підприємець) |
| Employment contract (KZpP) | Оформлення за КЗпП |
| Civil contract (GPD) | Договір ГПД |
| Diia City gig contract | Гіг-контракт Дія City |
| Health insurance | Медичне страхування |
| Dental insurance | Стоматологія |
| Education budget | Бюджет на навчання |
| English courses | Корпоративна англійська |
| Equipment | Обладнання (ноутбук, монітор) |
| Coworking | Коворкінг |
| Mental health support | Психологічна підтримка |
| Military levy | Військовий збір |
| Personal income tax (PDFO) | ПДФО (податок на доходи фізичних осіб) |
| Unified social contribution (YeSV) | ЄСВ (єдиний соціальний внесок) |
## Внесок
Якщо хочеш покращити переклад або додати новий режим:
1. Відкрий issue з пропозицією (див. `CONTRIBUTING.md`)
2. Дотримуйся словника вище для одноманітності
3. Перекладай за змістом та ідіоматично — без дослівних перекладів
4. Зберігай структурні елементи (блоки A-F, таблиці, код, інструкції для інструментів)
5. Протестуй з реальною україномовною вакансією (наприклад, з DOU.ua або Djinni.co)