Notes

What I want to find the next time.

These notes begin with work I expect to encounter again: a migration that failed in an unexpected place, a rule that keeps an agent inside its permissions, a design choice worth testing, or a question that is not settled yet.

Some are instructions I use now. Some connect several sources or projects. Some are explorations, and some preserve the exact sequence of an incident. The labels under each note tell you which kind you are reading, how firmly I hold it, and whether it is still current.

Chronological · Explore map ·Tags

The workshop disappeared. The hotspots survived.

Synthesis note · Exploratory claim · Current · Organizational systems

An EventStormingAlberto Brandolini's workshop method for modeling a domain on colored sticky notes -- commands, domain events, actors, views, and hotspots -- normally run with a room of stakeholders around a paper timeline. pass run solo, over agent session logs instead of a stakeholder workshop, still produced six ranked findings. The notation survived; the workshop did not; the value was in clustering the absences.

Governance for a team of one

Synthesis note · Exploratory claim · Current · Organizational systems

A solo operator's tooling keeps adopting controls that look stolen from an organization. The controls are not for headcount; they are for coordination between actors who share neither memory nor judgment, which describes one operator across time as much as it describes a team.

The human is in the slow loop

Exploration note · Current · Agent workflow

A prior "human perpendicular to the loop" claim only describes one interface. The fuller model is two coupled loops at different speeds, with a settlement boundary -- not an empirical/normative split -- deciding when the slow loop must be consulted.

The next prompt was only the visible error

Exploration note · Current · Agent workflow

The next-prompt heuristic measures what became visible at the human interface. A merged PR later filed as architecture, and a self-report that turned out to be reconstructable rather than introspective, both passed that test and still needed a different check further down.

The queue was never the hard part

Synthesis note · Exploratory claim · Current · Agent infrastructure

The queue chassis behind ActionQThe PostgreSQL-backed queue that owns actions, sessions, claims, and outcomes. is now commodity, split across a Postgres-native library, a durable-workflow runtime, an execution control plane, and an automation platform. How much of ActionQ survives once that chassis is removed is the open spike.

A platform capability does not exist all at once

Synthesis note · Exploratory claim · Current · Agent infrastructure

OutctlA tool that captures a command's full output outside the agent's context and returns a bounded projection the agent can query later for the omitted evidence. began as an answer to tool results flooding model context. Programmatic tool calling now moves that work into the harness, invalidating the original product boundary while leaving a narrower durable-evidence question open.

Measure the diagnosis, not only the transcript

Project history · Archival claim · Disproven · Model evaluation

OutctlA tool that captures a command's full output outside the agent's context and returns a bounded projection the agent can query later for the omitted evidence. cut model-visible Kubernetes output by about 84%, while pair-level cost and diagnostic quality remained unresolved. The useful result was a four-part evaluation model: mechanism, quality, economics, and authority.

Why I publish explore prompts

Operating note · Guiding claim · Current · Agent workflow

A note explains what survived editing. An explorePrompt is a separate, deliberately post-hoc artifact that explains where the investigation should continue -- for a reader, their agent, or a later version of me.

The second operator is the test

Project history · Exploratory claim · Superseded · Agent workflow

sprintctlThe CLI and schema that own sprint work, dependencies, claims, and handoffs. and actionqThe PostgreSQL-backed queue that owns actions, sessions, claims, and outcomes. enforce useful execution discipline, but five current invariants rely on one operator remaining the only source of identity, authority, and audit judgment.

Judge agents by the next prompt

Operating note · Guiding claim · Superseded · Agent workflow

New agents carry more work from intent to evidence, but that changes rather than removes the supervision problem. The next prompt reveals whether the result needs repair or is ready to extend.

The ref nobody adds

Operating note · Guiding claim · Current · Agent workflow

The sprint database held 831 work items and seven doc refs, six of them the same document. The reference command existed the whole time. The missing piece was never a tool — it was placement on the path the agent actually walks.

Delivered energy

Exploration note · Current · Energy systems

A business plan for battery-swap delivered energy that works in one narrow niche and matters most for what it implies about EVs, home batteries, and off-grid design.

Layering you can't violate by accident

Operating note · Guiding claim · Current · Software architecture

homelab-analyticsThe household data and decision platform that owns long-lived semantics, scenarios, policies, and approvals. enforces its layer boundaries with pytest. A documented architecture is a request; a tested one is a constraint.

Moving a live cluster to a new subnet

Project history · Guiding claim · Current · Cluster operations

Migrating a Talos cluster from a legacy subnet to its own VLAN while it kept serving. The design was mostly an ordering problem, plus one bootstrap loop: the network controller lives inside the network it manages.

NFC tokens pointing at a manifest

Exploration note · Prospective claim · Current · Hardware contracts

Cassettes, diskettes, and cartridges as physical handles for digital media. The rule that makes the whole family of projects work: the tag points, it never hosts.

Subprocess, not service

Operating note · Guiding claim · Current · Agent workflow

actionq-dispatcherThe one-action coordinator that creates a bounded workspace, invokes a worker, and records the result. runs agent work as subprocesses inside a per-invocation coordinator. The rejected alternative was a long-running agent service, and the rejection is most of the design.

The aftertaste of resolution

Operating note · Guiding claim · Current · Agent workflow

Conversational refinement produces the feeling of having thought clearly, which is not the same thing as having thought clearly. The fix was not discipline. It was writing the stop rule into the counterpart.

The coordinator never touches the repo

Operating note · Guiding claim · Current · Agent workflow

Sprint work is split into plan, build, and review dispatches, and the orchestrating session is structurally barred from editing deliverables. The bar is the point.

Log as system

Exploration note · Prospective claim · Current · Data architecture

A reference design for audit-native systems where code, layout, control decisions, and data are all log artifacts.

Schema on split

Operating note · Guiding claim · Current · Data architecture

A pipeline rule: land raw, split deterministically, enrich point-in-time, then shape for consumers.

The missing layer is binding, not intelligence

Project history · Archival claim · Superseded · Agent workflow

The useful workflow layer for solo agent work is not a giant orchestration stack. It is a local-first system that remembers claims, checkpoints, routing choices, and promotion boundaries without pretending one operator needs a whole platform team.

A GitOps rollback needs time to reach Git

Project history · Archival claim · Archived · GitOps operations

A live rollback fixed a crashlooping workload, but the more interesting part was needing to suspend reconciliation long enough for the fix to become the desired state instead of a temporary lie.

The boring auth boundary was right

Project history · Archival claim · Archived · Authentication architecture

Homelab analytics had enough auth surface to accidentally grow a second identity product. The useful decision was to keep identity proof upstream, keep authorization local, and demote local login to a narrow break-glass path.