---
name: api-contracts
description: Trabalhar com OpenAPI, GraphQL, protobuf, payloads, versionamento e compatibilidade de contratos. Use quando houver openapi, schema.graphql, proto ou APIs públicas.
---

# API Contracts

## Procedimento

1. Leia contrato formal, handlers e testes de consumidor quando existirem.
2. Preserve status codes, campos, enum values, nullability e erros.
3. Avalie versionamento e compatibilidade antes de alterar payload.
4. Gere/valide clients ou schemas somente quando o projeto já usa esse fluxo.
5. Reporte breaking changes e evidência de contrato.

## Regra

Não trate payload observado em um teste como contrato completo sem fonte formal.

## Objetivo

Ativar esta skill quando os sinais do projeto baterem com o contexto descrito e complementar o fluxo SDD sem depender dele.

## Evidências

Reporte sinais detectados, arquivos consultados, comandos executados e lacunas.

## Fallback

Se os sinais forem inconclusivos, use `project-conventions`, registre a incerteza e siga validação manual.
