code-check-contracts

Detect API contract drift by comparing changed server routes, procedures, and expected Zod/DTO/DB shapes against all known TypeScript call sites. This Skill scans git diffs to find mismatches like renamed fields or changed route params before they cause runtime errors.

TypeScript cannot fully guarantee type safety across runtime boundaries like Zod to DB to DTO divergence because generated clients and serialized shapes often bypass static checks. Contract scanning extracts before and after shapes from git diffs to find these mismatches.

Find stale generated client surfaces by scanning git diffs for changed server procedures and comparing their expected shapes against actual TS/TSX call sites. This process reports evidence with producer and consumer locations for quick verification.

You can automatically fix mechanical field renames across API consumers, but the Skill never auto-fixes removals or semantic changes. It ranks findings by severity and distinguishes safe renames from structural changes that require manual domain review.

This contract testing approach works with tRPC procedures, OpenAPI shapes, Zod definitions, and DB schemas. It audits client/server contract drift across these boundaries by extracting changed shapes from git diffs and scanning relevant TypeScript call sites.

Avoid automated contract drift fixing for field removals, structural changes, or semantic modifications. The tool only auto-fixes mechanical renames and explicitly leaves removals and semantic changes for manual domain review to prevent unintended behavior shifts.