api-contract-review

스타7

포크0

업데이트2026년 6월 24일 21:07

Detecta breaking changes e valida versionamento/compatibilidade de contrato.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

wesleyosantos91

wesleyosantos91/wesleyosantos91-engineering-kit

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Skill: api-contract-review

Objetivo

Detecta breaking changes e valida versionamento/compatibilidade de contrato.

Quando usar

Qualquer mudança de API (REST/Async/Avro/JSON Schema/GraphQL/gRPC).

Quando NÃO usar

Mudança sem impacto em contrato.

Inputs esperados

Contrato/spec e código web/api.

Workflow

Comparar contrato anterior x novo.
openspec-validate.sh.
Classificar compatível x breaking; checar idempotência e RFC 9457.

Comandos permitidos

git diff
bash scripts/ai/openspec-validate.sh

Saída esperada

Matriz de compatibilidade + decisão.

Critérios de qualidade

Breaking change sem versionamento/migração = NO-GO.

Segurança

Nunca rodar comandos destrutivos (rm -rf, git reset --hard, terraform apply, kubectl delete, aws delete).
Nunca expor secrets/.env/credenciais. Ver .ai/rules/security.md.

이 저장소의 다른 Skills

같은 저장소

adr-generation

wesleyosantos91/wesleyosantos91-engineering-kit

Gera um ADR (Architecture Decision Record) a partir do template.

2026-06-247

context-pack

wesleyosantos91/wesleyosantos91-engineering-kit

Empacota contexto econômico do repo para alimentar os agentes.

2026-06-247

java-quality-gate

wesleyosantos91/wesleyosantos91-engineering-kit

Executa e interpreta os quality gates Java 25 (Spotless, Checkstyle, JaCoCo 90%, PIT 90%, ArchUnit).

2026-06-247

mutation-testing-review

wesleyosantos91/wesleyosantos91-engineering-kit

Roda PIT e analisa mutantes sobreviventes (meta 90%).

2026-06-247

openspec-validation

wesleyosantos91/wesleyosantos91-engineering-kit

Valida implementação contra OpenSpec/SDD/PRD e exige contexto mínimo.

2026-06-247

package-architecture-review

wesleyosantos91/wesleyosantos91-engineering-kit

Revisa arquitetura/organização de pacotes, SOLID e isolamento do domínio.

2026-06-247

name	api-contract-review
description	Detecta breaking changes e valida versionamento/compatibilidade de contrato.

Skill: api-contract-review

Objetivo

Detecta breaking changes e valida versionamento/compatibilidade de contrato.

Quando usar

Qualquer mudança de API (REST/Async/Avro/JSON Schema/GraphQL/gRPC).

Quando NÃO usar

Mudança sem impacto em contrato.

Inputs esperados

Contrato/spec e código web/api.

Workflow

Comparar contrato anterior x novo.
openspec-validate.sh.
Classificar compatível x breaking; checar idempotência e RFC 9457.

Comandos permitidos

git diff
bash scripts/ai/openspec-validate.sh

Saída esperada

Matriz de compatibilidade + decisão.

Critérios de qualidade

Breaking change sem versionamento/migração = NO-GO.

Segurança

Nunca rodar comandos destrutivos (rm -rf, git reset --hard, terraform apply, kubectl delete, aws delete).
Nunca expor secrets/.env/credenciais. Ver .ai/rules/security.md.