BigHugger
sk Skill · affaan-m

contract-first

Use when multiple consumers and providers must evolve an API or event schema without field drift, integration surprises, or one side silently redefining the interface.

installs 8w
1,558
30-day movement
starts with the next reading
Related entries
2
Connections
0
yamltypescriptbashJavaScript

A SKILL.md that instructs an AI coding agent in a contract-first workflow for evolving APIs and event schemas across multiple consumers and providers. It covers choosing a canonical boundary artifact, a consumer-first design process, provider verification, a contract change protocol, and named anti-patterns.

Reach for it when parallel frontend/backend or service-to-service work needs one authoritative, machine-checkable contract so neither side silently redefines the interface.

Use it to

  • Coordinate parallel frontend and backend work around one contract artifact
  • Define nullability, enums, and error semantics before implementation
  • Verify provider responses against the contract before integration
  • Review contract changes instead of implementation-first renames
  • Avoid duplicate sources of truth for shared payloads

For Developers coordinating API or event schema boundaries across teams

Host repository
affaan-m/ECC
Installs, lifetime
1,600
Installs, 8 weeks
1,558
Host stars
261k
Host language
JavaScript
topicsapi-designcontractsschema-evolutionintegrationagent-skillcollaboration