Topic
An hour earlier we had chosen the retry queue over a direct write. Switching editors to run the migration, the fresh session saw no recorded decision and calmly proposed the direct write again. Forty minutes later, the closed decision had been reopened and compromised.
Read articleAdding another paragraph to AGENTS.md rarely fixes the output. What actually fixes it is a one-sentence exit criterion and a command the agent must re-run before declaring done.
Read articleAn agent that says 'done' after starting a dev server, a watcher, or a docker compose stack often leaves those processes running in the background. By the next task, your machine is a graveyard of half-finished services.
Read articleEvery alt-tab out of your editor to hit a web-based API client costs more than the two seconds it takes. The real cost is context, not latency.
Read articleThe real cost of moving between Cursor, Cline, and Claude Code isn't the editor. It's re-explaining the same repo to each one from scratch. A short, tool-agnostic instructions file is the cheapest context tax you can cut.
Read articleAgents guess field names when they never see the contract. Serve the spec over MCP, generate one verified vertical slice at a time, run scenarios against localhost, and rescan to catch drift.
Read articleBehavior first, routes second. AI drafts the OpenAPI contract as reviewable diffs, the team settles money, idempotency, and error envelopes up front, and mocks plus scenarios define done before implementation starts.
Read articleIntegration is done and the partner asks for a link. Finish descriptions locally, verify real calls, and publish versioned hosted docs and MCP from the same workspace, with no doc-tool rollout attached.
Read articleTwo hundred routes, an Express and two FastAPI services, and a Postman collection from 2023. An AST scan reconstructs the real contract, marks honest gaps instead of guessing, and stays repeatable through rescans.
Read articlePostman made collections the source of truth and put them in the cloud. A newer workflow makes the OpenAPI spec the source, keeps files on disk where git can see them, and treats debugging, mocks, tests, and MCP as views over one document. Here is an honest comparison.
Read articleInventory APIs get consumed by developers reading docs and by agents discovering tools. Separate web docs, prompt pastes, and hand-written schemas guarantee drift; one OpenAPI file produces both.
Read articleConsumer-driven contracts with Pact are powerful but bring a broker, pactfiles, and a workflow small teams never maintain. Here is what contract testing is really protecting, and a lighter OpenAPI-based setup that catches the same integration bugs with tools you already run.
Read article