Deterministic Route Extraction vs Guessing
The difference is whether a route is proven from code or inferred from a name.
Read articleThe Powerduck Blog
API engineering, from the spec out
Product updates, engineering notes, and guides for designing, debugging, testing, mocking, and serving MCP tools from one OpenAPI spec.
Browse the guidesDeriving a Data Model from OpenAPI
The modeling layer closes the gap between the API and the database.
Read articleCancelling a Long-Running Scenario Run
Local stop and remote cancellation are different actions with different effects.
Read articleAssertions Across a Multi-Step Flow
Assert each step so a failure points at the exact request that broke.
Read articleAn Additive Migration Plan and BlockedBy
The plan is ordered and additive, not a destructive rebuild.
Read articleAI Review vs Human Review: Where Each Wins
AI and human reviewers win on different tasks; the best flow uses both.
Read articleWhy Your Agent Awaits Inside a Loop, and When to Parallelize
Independent calls inside an awaited loop add latency in a straight line; here is when to fix it and when to leave it.
Read articleWhy an Agent Leaves a Feature Flag Turned On
A rollout flag has an expiration date, not a permanent home.
Read articleWhy an Agent Rewrites the Test Instead of the Code
A red test is information, not an obstacle to edit away.
Read article