Why an Agent Hardcodes Environment Config in Source
Environment-specific values belong outside the code.
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 guidesWhy an Agent Applies One Fix to an Unrelated Bug
A fix meant for one bug can land on a similar, unrelated one.
Read articleWhy an Agent Context Window Truncates the Middle
The middle of an agent's context is the first thing trimmed, compressed, or ignored.
Read articleMocking Duplicate Webhook Delivery
Webhook retries mean every handler has to survive a repeated event.
Read articleTesting an Idempotent Endpoint with Duplicate POST
One green POST does not prove an endpoint is idempotent.
Read articlePostman Pricing 2026 and Hidden Costs
Per-seat list price is the start of the cost, not the total.
Read articleWhat Is Contract-First Development?
The API spec becomes the agreed source of truth before code is written.
Read articleMCP Tool Idempotency for Safe Retry
An agent that retries a tool needs to know whether the retry is safe.
Read articleDebugging 403 When the Token Scope Is Too Narrow
A valid token that still returns 403 is a scope problem, not a login problem.
Read articleCursor Agent Context vs OpenAPI Truth
The agent's context is a partial view, not the current contract.
Read articleWhat Is Context Rot in AI Agent Sessions?
Why a long-running agent starts contradicting its own earlier decisions.
Read articleMatching XML and SOAP Requests with XPath When Two Bodies Look Alike
Quick answer: When two XML or SOAP bodies look nearly identical, matching on the whole body is brittle, while XPath lets you target the specific element that distinguishes the requests.
Read article