Your team decides something. Months later a pull request quietly undoes it, review misses it, and the question gets relitigated from zero. Verdica keeps decisions as files in the repo and holds every diff to them.
One Markdown file per decision, living next to the code it governs. This one is real: it ships in Verdica’s own repository and gates Verdica’s own pull requests.
The gate reports; it does not fail builds until a team opts a decision into blocking, one decision at a time. Trust is earned in shadow mode first.
A gate that cries wolf on day one gets uninstalled on day two. Precision before authority.
PRs cite DEC-0005 the way courts cite precedent. The ID survives refactors, people leaving, and the next reorg.
Deterministic glob matching decides which decisions a diff even wakes up. No scope hit, no noise.
Proposed, reviewed, accepted, superseded: all through ordinary pull requests. CODEOWNERS says who ratifies. Your repo stays the only source of truth.
Deterministic first: path scopes select the decisions a diff touches. Only on a hit does a model judge contradiction, and it must cite the exact hunks. No API key? The scope report alone still tells you which law governs the change.
The change touches a decision’s scope and honors it. One quiet line, nothing to do.
Flagged with the decision cited and the guilty hunks quoted. Warns by default; blocks only where the team opted in.
Decisions whose paths the diff never touches say nothing. The gate lectures nobody.
On a ninety-thousand-star repository, a change passed review, merged, and had to be reverted days later for violating two architecture decisions that had been on the books for years.
Before writing the gate we mined public GitHub: 326 repositories with decision registries, 1,926 recorded decisions, and every pull request that cited one.
Across projects that record decisions, roughly one violation in ten slips through human review and merges. The rest are caught by reviewers doing, by hand and from memory, what a gate does from files.
And the registries themselves rot: 93 percent had never marked a single decision superseded, while their code kept moving. A registry nobody checks becomes fiction. Enforcement is what keeps it true.
uses: verdicahq/verdica@v0 and every PR meets the registry.bootstrap --html renders proposals for the leads who ratify them.The entire gate is Apache-2.0, free forever. Verdica Cloud is the managed service: install the GitHub App, pick your repos, and we run everything else. Always up to date, judgment included, and your code is analyzed in memory, never stored.
You run the workflow, your keys, your CI minutes.
Early access opens soon; pricing at launch. Watch releases to get in first.