The 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 guides
ai 2 min read

A Fix Proved Once in a Terminal Is Still Just a Hope

You run the failing command by hand, watch it pass, declare done, and merge. Three months later the same path breaks because nobody turned that manual repro into a test that stays in the suite.

Read article
mocking 3 min read

Dead Stubs: Finding Mock Mappings No Test Actually Uses

Quick answer: Mock mappings accumulate like any other code, and over time a test suite builds up dead stubs, mappings no test actually exercises. They look harmless but increase maintenance,

Read article
openapi 3 min read

Docs Search: Hosted Indexing vs Static Build-Time Search

Quick answer: Docs search is a core navigation feature, not an add-on, and the choice between a hosted search index and build-time static search is really a decision about infrastructure,

Read article