{"canonical_url":"https://engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/","content_markdown":"# Побудувала механізм із 268 перевірок репозиторію\n\nПобудувала механізм перевірок репозиторію — 268 зареєстрованих перевірок коміту, 277 правил лінтингу та 15 власних правил ESLint — а також 146 тестів самих перевірок, щоб стандарт тримала збірка, а не код‑рев'ю.\n\n2025\n\n**Ситуація.** Стандарти, записані в настановах для учасників проєкту, — лише побажання. З ними всі згодні, а потім настає п'ятниця, зміна маленька, і настанови програють. Планка нульових попереджень могла втриматися лише за умови, що її триматиме щось, окрім доброї волі, — а лінтери, що йдуть у комплекті з кожною мовою, далеко не охоплюють специфічних для проєкту правил, які насправді мають значення: тих, що описують, як має працювати саме ця кодова база.\n\n**Завдання.** Важливі для проєкту правила мали стати виконуваними, щоб порушення будь‑якого з них зупиняло коміт, а не чекало на рецензента, якому вистачить часу й пам'яті це помітити.\n\n**Дія.** З цього виріс цілий рушій захисних перевірок. Це 274 скрипти перевірок, із них 268 зареєстровано в хуках комітів, а поруч — 277 лінтерів на JavaScript, 96 валідаторів на shell і 17 на Python, які стежать за тим, до чого готовим інструментам байдуже: що міграцію можна відкотити, що ключ перекладу існує в обох локалях, що зареєстрований маршрут є в описі OpenAPI, що ніхто тихцем не придушив попередження прямо в коді. П'ятнадцять власних правил ESLint тримають у TypeScript патерни, прийняті в проєкті. Одне правило варто назвати окремо: будь‑який коміт із префіксом fix: мусить містити тест, який без цього виправлення падає, — це дає виконувану перевірку для цієї регресії. А оскільки зламана перевірка гірша, ніж її відсутність, — вона пропускає все, і ніхто про це не дізнається, — самі перевірки мають 146 власних тестів.\n\n**Результат.** Рецензенти могли приділяти більше часу проєктуванню, бо ще до відправлення гілки автоматичні перевірки опрацьовували закладені в них формальні правила. Компроміс реальний, і про нього варто сказати прямо: комітити повільно, а погано написана перевірка, яку доводиться обходити, справді доводить до сказу. Ті 146 тестів існують саме тому, що так уже траплялося.\n\n---\n\n- Роль: Керівник розробки\n- Категорії: [DevOps](https://advisory.engineer.company/uk/categories/devops/), [Автоматизація та CI/CD](https://advisory.engineer.company/uk/categories/automation/), [Тестування та QA](https://advisory.engineer.company/uk/categories/testing/), [Технічне лідерство](https://advisory.engineer.company/uk/categories/technical-leadership/), [Документація](https://advisory.engineer.company/uk/categories/documentation/)\n- Послуги: [DevOps та автоматизація CI/CD](https://advisory.engineer.company/uk/services/devops-cicd/), [Розробка ШІ‑агентів на замовлення](https://advisory.engineer.company/uk/services/ai-agents/), [Технічне лідерство та консалтинг](https://advisory.engineer.company/uk/services/technical-leadership/), [Технічна документація](https://advisory.engineer.company/uk/services/technical-documentation/)\n\n\u003chttps://engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Рецензенти могли приділяти більше часу проєктуванню, бо ще до відправлення гілки автоматичні перевірки опрацьовували закладені в них формальні правила.","formats":{"gemtext":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/index.gmi","gopher":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/gophermap","html":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/","json":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/index.json","markdown":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/index.md","pdf":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/index.pdf"},"kind":"page","language":"uk","title":"Побудувала механізм із 268 перевірок репозиторію","url":"https://advisory.engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/","version":1}