Field notes · 13 entries

Field notes

Short, evidence-first write-ups of what I've actually observed building with LLMs — each one with the sample size stated and the ten-minute check to falsify it yourself.

Start here

Three short reads about taking ownership, questioning evidence, and making work verifiable.

1 min read

Own the environment

The agent treated missing infrastructure as fate

For a thousand lines it logged Docker's absence as a constraint and deferred the integration suites; told it could start the daemon itself, it did — and the suites it had been deferring found three real bugs.

  • agents
  • verification
  • infrastructure

1 min read

Question the evidence

Five of eighteen runs invented evidence. One refused to.

In a batch of runs designed to tempt fabrication, five invented a missing fixture to force a red gate green — and the catch that mattered came from an agent cross-checking primary sources, not from a rule.

  • agents
  • evaluation
  • fabrication

2 min read

Make requirements testable

The only rule that worked is one a machine could check

"Reproduce the failure before editing" produced 3/3 reproductions against 0/6 without it; the same idea phrased as a principle — "root cause before editing" — produced zero.

  • agents
  • rules
  • evaluation

All notes, newest first

3 min read

AER v6.0.1: focused resources, compatible upgrades

A compatible patch cuts copied references from 170 to 38, clarifies task guidance, and safely retires obsolete files from existing v6.0.0 installations.

  • agents
  • agent skills
  • release engineering
  • compatibility

2 min read

AER v6: independent skills and recoverable installation

Thirteen self-contained engineering skills, a compact contract, explicit client controls, and an installer that preserves ownership through changes and interruptions.

  • agents
  • agent skills
  • release engineering
  • filesystem safety

4 min read

AER v5: a compact contract for complete engineering

AER v5 puts complete behavior, engineering judgment, and proportionate verification in a 45-line universal kernel, delivered locally for Claude Code and Codex.

  • agents
  • engineering judgment
  • verification
  • release engineering

3 min read

A zero exit code is not evidence: what changed in AER 3.1

AER 3.1 turns observed agent failures into explicit, cross-platform engineering checks without abandoning its compact progressive-disclosure model.

  • agents
  • developer tooling
  • validation
  • release engineering

1 min read

The agent treated missing infrastructure as fate

For a thousand lines it logged Docker's absence as a constraint and deferred the integration suites; told it could start the daemon itself, it did — and the suites it had been deferring found three real bugs.

  • agents
  • verification
  • infrastructure

2 min read

Your rules file is not being read

I measured a predecessor engineering-rules setup and found that only 13.2% of routed files were loaded. Rewriting the rules was never going to fix that.

  • agents
  • evaluation
  • context engineering

1 min read

Five of eighteen runs invented evidence. One refused to.

In a batch of runs designed to tempt fabrication, five invented a missing fixture to force a red gate green — and the catch that mattered came from an agent cross-checking primary sources, not from a rule.

  • agents
  • evaluation
  • fabrication

2 min read

The only rule that worked is one a machine could check

"Reproduce the failure before editing" produced 3/3 reproductions against 0/6 without it; the same idea phrased as a principle — "root cause before editing" — produced zero.

  • agents
  • rules
  • evaluation

2 min read

The rules that help your best model can hurt your cheapest

The same rules file was strongly net-positive for the stronger model and mixed-to-negative for the weaker one, where tests decreased and two regressions plausibly traced to the rule text itself.

  • agents
  • rules
  • model selection

2 min read

Agents patch symptoms until you tell them not to

Across three PRs, the agent handled review comments one at a time until I explicitly asked it to connect the failures and investigate the underlying mechanism.

  • agents
  • code review
  • root cause

1 min read

A vague finish line produces laps, not progress

With "continue remaining items" as the stop condition, the grader rejected the agent twice — not for bad work, but for declaring victory and then for asking me what to do — until it decided for itself.

  • agents
  • stop conditions
  • autonomy

Curious how this is built? Look under the desk.

pocket terminal · ~/desk

A small terminal for this site. It prints only what is on the site; type help for commands.

The prompt needs JavaScript. Every destination is also in the navigation above.

ls work

7 products · * featured

Your turn: try open skillcheck, coffee, or help.

Loading terminal commands…

Type a command and press Enter. Try help, ls, open followed by a project name, why followed by a project name, inspect, trail, cat about, notes, contact, resume, coffee, whoami, or clear. Tab completes; the up and down arrows recall earlier commands. Escape closes the terminal.