Shaping the Loops, Closing the Loops
I began to notice a pattern of patterns in today's age, which has had me thinking ever since.
The Tabulating Machine Company's organization chart, December 1917. Photo by Marcin Wichary, CC BY 2.0.
As the volume of agent work explodes, engineering leverage will concentrate in two areas. One is already getting attention, the other is less clearly named.
โฃ Verification engineering โข (closing the loop): building the tools, systems, and processes that can reliably establish whether a change meets its intended requirements, and produce actionable evidence and signals when it doesn't.
โฃ Pattern engineering โข (shaping the loops): designing, curating, and reinforcing the conventions, abstractions, tools, and context that improve subsequent work across a codebase and company.
These practices have always mattered, but agents change how frequently those decisions get applied. They repeatedly learn from and extend the patterns already present in a codebase. A good pattern can improve thousands of subsequent changes, while a bad one can repeatedly steer work in the wrong direction.
Henry Binney Hawke finishing a wooden pattern for a gear wheel, to be cast in his foundry in Kapunda, South Australia, circa 1870s. State Library of South Australia.
What it looks like in practice
Pattern engineering means removing sources of recurring misdirection:
- unit tests that lock in implementation details
- stale architecture specs
- unclear service ownership
It also means making good work easier: enforcing clear architectural boundaries, making good observability and tracing automatic through shared abstractions, and establishing which context is worth preserving, where it belongs, and when it needs updating.
My favorite example
One pattern that has served our engineering team very well: a single reliable way for a human or cloud agent to configure secrets, run your stack, and test a change in any supported development environment.
A work trial candidate on a fresh Mac and a cloud agent should follow the same setup workflow, with no undocumented steps. Once dependencies and access are provisioned, you should have a running stack in under a minute.
And that workflow should stay current as engineers and their agents add services. It should derive from the same service definitions they already maintain, so supporting a new service doesn't require someone to remember to update a separate setup system. Every new engineer and agent benefits from that work, and every new service extends it.
revup, the CLI we use to set up every engineer's and agent's machine at Revyl.
.revyl/dev.json services, their secret boundaries, and the core profile
New hire ยท fresh Mac
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 01 ยท Linux
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 02
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 04
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 05
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 06
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 07
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 08
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 10
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 11
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 12
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 13
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 14
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 16
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 17
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 18
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 19
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 20
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 22
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 23
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 24
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 25
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 26
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 28
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 29
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 30
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 31
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 32
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 34
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 35
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 36
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 37
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready $_
Cloud agent 38
$ ./scripts/cloud-bootstrap
revup linked onto PATH
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new-service
stack ready
Engineer laptop
$ ./tools/revup/setup.py
revup installed
$ revup start core
profile core ยท from .revyl/dev.json
secrets โ secret store, per boundary
โ frontend
โ backend
โ action-server
โ outbox
โ workflow-worker
โ web-live-step-worker
โ revyl-cli
โ new
Comments
No comments yet. Start the discussion.