Files
santifer--career-ops/modes/ua/README.md
T
wehub-resource-sync d083df1fdb
CodeQL Analysis / Analyze (javascript-typescript) (push) Failing after 2s
Web CI / web typecheck + build (push) Failing after 1s
Release Please / release-please (push) Failing after 1s
CodeQL Analysis / Analyze (go) (push) Failing after 16s
chore: import upstream snapshot with attribution
2026-07-13 12:02:43 +08:00

119 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)