Побудувала механізм із 268 перевірок репозиторію
Побудувала механізм перевірок репозиторію — 268 зареєстрованих
перевірок коміту, 277 правил лінтингу та 15 власних правил ESLint —
а також 146 тестів самих перевірок, щоб стандарт тримала збірка, а
не код‑рев'ю.
2025

Ситуація. Стандарти, записані в настановах для учасників проєкту, —
лише побажання. З ними всі згодні, а потім настає п'ятниця, зміна
маленька, і настанови програють. Планка нульових попереджень могла
втриматися лише за умови, що її триматиме щось, окрім доброї волі, —
а лінтери, що йдуть у комплекті з кожною мовою, далеко не охоплюють
специфічних для проєкту правил, які насправді мають значення: тих,
що описують, як має працювати саме ця кодова база.

Завдання. Важливі для проєкту правила мали стати виконуваними, щоб
порушення будь‑якого з них зупиняло коміт, а не чекало на
рецензента, якому вистачить часу й пам'яті це помітити.

Дія. З цього виріс цілий рушій захисних перевірок. Це 274 скрипти
перевірок, із них 268 зареєстровано в хуках комітів, а поруч — 277
лінтерів на JavaScript, 96 валідаторів на shell і 17 на Python, які
стежать за тим, до чого готовим інструментам байдуже: що міграцію
можна відкотити, що ключ перекладу існує в обох локалях, що
зареєстрований маршрут є в описі OpenAPI, що ніхто тихцем не
придушив попередження прямо в коді. П'ятнадцять власних правил
ESLint тримають у TypeScript патерни, прийняті в проєкті. Одне
правило варто назвати окремо: будь‑який коміт із префіксом fix:
мусить містити тест, який без цього виправлення падає, — це дає
виконувану перевірку для цієї регресії. А оскільки зламана перевірка
гірша, ніж її відсутність, — вона пропускає все, і ніхто про це не
дізнається, — самі перевірки мають 146 власних тестів.

Результат. Рецензенти могли приділяти більше часу проєктуванню, бо
ще до відправлення гілки автоматичні перевірки опрацьовували
закладені в них формальні правила. Компроміс реальний, і про нього
варто сказати прямо: комітити повільно, а погано написана перевірка,
яку доводиться обходити, справді доводить до сказу. Ті 146 тестів
існують саме тому, що так уже траплялося.

Категорії:
1DevOps	/uk/categories/devops/	engineer.company	70
1Автоматизація та CI/CD	/uk/categories/automation/	engineer.company	70
1Тестування та QA	/uk/categories/testing/	engineer.company	70
1Технічне лідерство	/uk/categories/technical-leadership/	engineer.company	70
1Документація	/uk/categories/documentation/	engineer.company	70

Послуги:
1DevOps та автоматизація CI/CD	/uk/services/devops-cicd/	engineer.company	70
1Розробка ШІ‑агентів на замовлення	/uk/services/ai-agents/	engineer.company	70
1Технічне лідерство та консалтинг	/uk/services/technical-leadership/	engineer.company	70
1Технічна документація	/uk/services/technical-documentation/	engineer.company	70

hЦя сторінка у вебі	URL:https://engineer.company/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/	engineer.company	70
