api-design
Design or review public APIs, SDKs, CLIs, and MCP tools for clear caller intent, usable responses, safe state changes, and agent ergonomics. Use for new contracts, naming decisions, and confusing existing flows; skip for mechanical implementation of an already settled contract.
Pinned to revision 618cfd2bc10c, so it is the text this page describes rather than whatever the author pushed since.
Files
Every link opens the file at its source, pinned to the revision this page describes.