Проектирование API и публичных интерфейсов

★ 8.7 · engineering

api-and-interface-design is a Claude Code skill that guides the design of stable, well-documented interfaces — REST and GraphQL endpoints, module boundaries, component props, and any public contract between parts of a system. It builds on three foundational ideas: contract-first design (define the interface before implementing it), Hyrum's Law (every observable behavior becomes a dependency regardless of what you document), and the One-Version Rule (extend rather than fork to avoid diamond dependency problems). The skill covers consistent error semantics with HTTP status codes and structured error bodies, boundary validation rules including mandatory parsing of third-party API responses, prefer-addition-over-modification patterns for backward-compatible evolution, and naming conventions for REST resources and response fields. It suits teams designing new APIs, splitting frontend and backend responsibilities, or safely evolving existing public interfaces.