workflow is everything.

Most of what I build starts from how the work is already done. These are the four principles I keep coming back to, and the tools on this site where each one shows up.

  1. 01

    build only what feeds itself

    A tool stays in use only if keeping it up to date is an automation's job, or part of work I am already doing. If it needs someone to sit down and feed it every day, it stops being used, however good it is.

    My notes are written by agents while I do other work, and get 20 to 60 updates a day.

  2. 02

    put rules in code

    A rule that someone has to remember will be missed eventually. A rule that code checks runs every time. When something goes wrong once, I write the check that stops it happening again.

    My agent setup runs hooks that check every tool call against my rules before it runs. The system architecture model is kept as text in git, so changes to it are reviewed the same way as code.

  3. 03

    work inside the systems people already use

    Teams already have a document control system, email, registers and a browser they are signed in to. I build tools that work in those systems, so nobody has to move their work somewhere new.

    The agent connectors read and update records in the systems where they are kept. Shroom works in websites through the Chrome profiles I am already signed in to. Redline opens the PDF and DWG files that arrive for review.

  4. 04

    keep one copy of each fact

    Every fact has one place where it is kept, and everything else points to it. If a person's role changes, one line in one file changes.

    Dashboards, reports and the forecasting app read from the same data model. When a number looks wrong, I check it against the source system, not a copy of it.

my setup

Everything on my computer is set up in code, so the terminal is how I use it. I tell an AI coding agent what I want, and it works through the apps and systems below.

ready
input
hyper keyCaps Lock is a Hyper key for app and window shortcuts, set up in Hammerspoon.
raycastLauncher, with extensions I wrote for my own systems.
wispr flowDictation on the mouse gesture button, remapped in Karabiner.
hands
shroomWorks in websites through my signed-in Chrome.agent connectorsEmail, documents and registers.redlineDrawings for review.
nibNotes and tasks, kept as files on disk.
pigeonA file manager the agents can drive.
back end
the piA Raspberry Pi at home runs my data hub and sends notifications to my Mac and phone.