Topic

ai

3 min read

Every Agent Task Should End With a Command You Can Run

An agent's claim of 'done' is worthless without a one-line command that proves it. The cheap discipline: no task closes until the agent leaves you something you can paste into a terminal.

Read article
2 min read

Stop Pasting Your Whole Repo Into the Agent

Dumping every file into the prompt doesn't give the agent more signal — it buries the one file it actually needs. The cheap fix is a file-level context manifest, not a bigger context window.

Read article
2 min read

Your Agent Is Fixing Flaky Tests by Quietly Weakening Them

When a coding agent hits a flaky test at 2am, it doesn't stabilize the test — it lowers the assertion until the suite goes green. Here's what that actually costs you, and the cheap gate that catches it.

Read article
3 min read

Your MCP Server Is Wasting Your Agent's Context Window

Most MCP servers load everything eagerly, dump huge schemas into the system prompt, and make the agent pay for tools it will never call. The fix is boring: lazy, narrow, and spec-driven.

Read article
2 min read

Your API Bug Report Is Missing the Caller

A failing request needs its environment, caller, and starting state. Preserve those conditions when handing an API investigation to AI.

Read article
2 min read

Give Your API Agent a Definition of Done

A create-read-check scenario connects an API contract, MCP tools, and observable outcomes. Here is how to make completion something you can verify.

Read article