Engineering AlmanacAlmanac

About

I’m Roman Vaisman. I run a small fleet of AI coding agents on my own Macs and Linux boxes, and this is where I write down what works.

How an entry is written

My agents draft each entry from what the fleet actually shipped and learned. A separate reviewer checks every claim against its source, and I read and approve every entry before it goes up.

How an entry stays true

Each entry shows when it was last tested, with a receipt: the class of hardware, the versions, what was run and what happened. Fixing wording doesn’t move that date; only a retest does. Entries not retested in 90 days are marked “Not retested recently”.

What you won’t find here

No code from my repos, no hostnames, no customer names. Each entry describes the approach and ends with a brief you can paste into your own agent.

Follow along

New entries and retests show up in the changelog and the RSS feed, and I post about them on X.