trackbed:code:api-design
(experimental) Design stable APIs and module boundaries for endpoints, public modules, and SDKs; --design-twice compares alternative shapes first.
/trackbed:code:api-design [--design-twice]- Invocation: User, Auto
- Hosts: Claude Code, Codex (
$trackbed:code:api-designin Codex) - Category: Code Changes
- Source:
trackbed/skills/code:api-design/SKILL.md
Description
Section titled “Description”(experimental) Design stable APIs and module boundaries. Covers contract-first approach, Hyrum's Law, retry safety and idempotency keys, validation at boundaries, consistent error shapes with HTTP status mapping, naming conventions, and TypeScript patterns for interface stability. Use when adding HTTP endpoints, public modules, SDK surfaces, or any interface with external or cross-team callers. Includes a Design It Twice mode (opt-in via --design-twice or the phrase 'design it twice') that drafts radically different shapes, in fresh-context sub-agents where the host allows, and verifies the pick before recommending it.
Related
Section titled “Related”- Refers to:
trackbed:code:harden-security,trackbed:code:refactor-opportunities,trackbed:code:refactor-pass,trackbed:siw:generate-phases - Referred to by:
trackbed:code:deprecate,trackbed:code:harden-security,trackbed:code:refactor-opportunities,trackbed:docs:adr - Agents:
trackbed:security-reviewer