Striff Engineering

On documented architecture, and making it hold.

Engineering patterns, real findings from open-source PRs, and updates on making structural review part of every pull request.

Topics

Latest

Data & research 10 min read

AI didn't make engineering discipline obsolete. It made it the whole job.

Design doc, then plan, then the agent builds it piece by piece: the companies that make coding agents now tell you to work this way. We surveyed 335 open-source repositories: 63% already hand their agents docs to work from, and only 8% of those check that the code still matches.

More articles

Product 7 min read

Your architecture docs matter more than ever. Now every pull request is checked against them.

Coding agents read your docs as context, and nothing checks that the code still agrees with them. How Striff turns the sentences already in your repository into rules computed at both revisions of every pull request, and the one real violation it found in 1,394 checks.

Product 7 min read

Every Striff finding comes with a receipt

AI review comments are easy to write and hard to trust. What a Striff check on your pull request actually says, where each line of it comes from, and how to verify any of it yourself in under a minute.

Architecture 6 min read

Coupling metrics, explained — and why a coupling delta is not a finding

What afferent and efferent coupling actually measure, how to read them together with complexity, inheritance depth and encapsulation, and the case for why none of these numbers should ever be reported to a reviewer as a finding on its own.

Architecture 7 min read

The architecture review checklist: catching structural risk in a pull request, by hand

A checklist for reviewing pull requests for architectural risk: what your own docs already decided, new dependency directions, reaches into module internals, blast radius and cycles. With an honest accounting of which steps a machine can take off you and which it cannot.