@mattpocockuk: Another layer of documentation I'm considering (along with CONTEXT.md and ADR's) is a list of all the agreed test seams…
Summary
Matt Pocock proposes documenting agreed test seams in apps, arguing that AI agents cannot be trusted to make good testing decisions, often leading to fragile tests that break on implementation changes.
View Cached Full Text
Cached at: 05/23/26, 08:12 PM
Another layer of documentation I’m considering (along with CONTEXT.md and ADR’s) is a list of all the agreed test seams in the app
Agents simply cannot be trusted to make good decisions about what to test, and at what seam.
For every small change, they extract out only what they’ve built into a testable function and test that.
It leads to a patchwork nightmare of tests that break as soon as the implementation changes.
Similar Articles
@mattpocockuk: Writing ADR's for agents has been such a good decision Capturing all the non-obvious decisions in a codebase makes ever…
Matt Pocock recommends writing Architecture Decision Records (ADRs) for agents to capture non-obvious decisions, making agents in the stack smarter with minimal documentation.
@mattpocockuk: Adding a set of Martin Fowler's code smells from Refactoring into my /review skill Mysterious Name, Duplicated Code, Fe…
Matt Pocock announces adding Martin Fowler's code smells to his /review skill for AI coding agents, and shares his open-source collection of composable agent skills designed to improve real engineering workflows.
@mattpocockuk: Here are my 7 phases of AI-powered development. I've been thinking that the pre-PRD phase needs more structure. You nee…
Matt Pocock shares his seven phases of AI-powered development, emphasizing the need for more structure in the pre-PRD phase.
What do you put in AGENTS.md when a coding task gets messy?
Discusses how developers using OpenClaw can keep context for AI coding agents by using a handoff document (AGENTS.md) to track goals, files, failures, and decisions in messy coding sessions.
@trq212: okay this is going kinda viral and tbh my original text was kind of messy, so here's a second pass with the help of Cla…
A user shares a refined method for implementing specs with AI assistance, using Claude to maintain an implementation-notes.html file that records design decisions, deviations, tradeoffs, and open questions.