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

★ 8.7 · engineering

api-and-interface-design — это скилл для Claude Code, который помогает проектировать стабильные, хорошо документированные интерфейсы: REST и GraphQL эндпоинты, границы между модулями, пропсы компонентов и любые публичные контракты между частями системы. Скилл опирается на принципы «контракт прежде реализации», закон Хайрума и правило одной версии — чтобы любое наблюдаемое поведение API было намеренным, а не случайным обязательством. Внутри описаны консистентные стратегии обработки ошибок с HTTP-кодами и структурированным телом ответа, правила валидации на границах системы (включая обязательную проверку ответов сторонних сервисов), подход «расширяй вместо изменения» и соглашения по именованию для REST. Подходит командам, которые проектируют новые API, разграничивают зоны ответственности между фронтендом и бэкендом или меняют существующие публичные интерфейсы без риска сломать потребителей.