Diseño de API contract-first con OpenAPI y TypeScript

La mayoría de los equipos escriben primero la API y la documentan después. La especificación OpenAPI se convierte en una instantánea de la realidad hecha con buena voluntad: precisa en el momento de escribirla, obsoleta con el siguiente PR. Los clientes salen perjudicados. La especificación se convierte en ruido en el que nadie confía.

El desarrollo contract-first invierte esto: define la forma de la API en YAML antes de escribir un solo handler, y luego genera los tipos a partir de ese contrato. Tanto el servidor como el cliente trabajan contra la misma fuente de verdad, y el compilador te avisa cuando se han desviado.