Built a 268‑check guard engine for the repo
Built the repository's guard engine — 268 registered commit checks,
277 lint rules and 15 custom ESLint rules — plus 146 tests of the
guards themselves, so the build holds the standard, not review.
2025

Situation. Standards written down in a contributing guide are
suggestions. Everyone agrees with them, and then it is Friday, the
change is small, and the guide loses. The zero‑warnings bar was only
ever going to hold if something other than goodwill was holding it —
and the linters that ship with each language stop well short of the
project‑specific rules that actually matter, the ones about how this
codebase in particular is meant to work.

Task. The rules the project cared about had to be executable, so
that breaking one failed a commit rather than waiting for a reviewer
with the time and the memory to catch it.

Action. What grew out of that is a guard engine. There are 274 check
scripts, 268 of them registered into the commit hooks, alongside 277
JavaScript linters and 96 shell and 17 Python validators covering
the things off‑the‑shelf tooling has no opinion about — that a
migration can be rolled back, that a translation key exists in both
locales, that a registered route appears in the OpenAPI description,
that nobody quietly added an inline suppression. Fifteen custom
ESLint rules hold the house patterns in TypeScript. One rule is
worth naming on its own: any commit prefixed fix: has to carry a
test that fails without it, providing an executable check for that
regression. And because a broken guard is worse than no guard at all
— it passes everything and nobody finds out — the guards have 146
tests of their own.

Result. Reviewers could spend more time on design because automated
checks handled the mechanical rules they encoded before a branch was
pushed. The trade‑off is real and worth stating: committing is slow,
and a badly written guard is genuinely infuriating to work around.
Those 146 tests exist because that happened.

Categories:
1DevOps	/categories/devops/	advisory.engineer.company	70
1Automation & CI/CD	/categories/automation/	advisory.engineer.company	70
1Testing & QA	/categories/testing/	advisory.engineer.company	70
1Technical Leadership	/categories/technical-leadership/	advisory.engineer.company	70
1Documentation	/categories/documentation/	advisory.engineer.company	70

Services:
1DevOps & CI/CD Automation	/services/devops-cicd/	advisory.engineer.company	70
1Custom AI Agent Development	/services/ai-agents/	advisory.engineer.company	70
1Technical Leadership & Consulting	/services/technical-leadership/	advisory.engineer.company	70
1Technical Documentation	/services/technical-documentation/	advisory.engineer.company	70

hThis page on the web	URL:https://advisory.engineer.company/portfolio/built-a-268-check-guard-engine-for-the-repo/	advisory.engineer.company	70
