Contract-first memaksa tim menyepakati bentuk data sebelum implementasi liar. Di NestJS, Swagger/OpenAPI yang rapi menjadi sumber kebenaran untuk konsumen API.
Dokumentasikan status code, error shape, dan pagination sejak awal. Detail kecil ini yang paling sering memicu bug integrasi.
Generate tipe frontend dari spec bila memungkinkan. Perubahan breaking harus terlihat di review, bukan di production malam hari.
Jangan biarkan dokumentasi membusuk. Jadikan update OpenAPI bagian dari definition of done setiap endpoint baru.
