Contract-Driven Development – a Real-World Adoption Journey

March 13, 2023

Read time: 6 minutes

A hand points at an API icon during a real-world adoption journey of contract-driven development.
Published By
InfoQ
Author
Hari Krishnan
Share this page

Article Overview

The story of how a large financial services company adopted contract-driven development. Covering the situation on the ground before adoption and initial skepticism, and how we were able to influence change by demonstrating value and eventually getting people to collaborate over API specifications. Key points covered:

  • Contract-driven development (CDD) can help with microservices integration but needs a new collaboration model among stakeholders.
  • CDD involves writing and storing API specifications before building applications, which is different from usual practices and may take time to adopt.
  • CDD builds on and contributes to a strong test pyramid which requires changes to test composition, strategy and application architecture to improve component testability.
  • Start the CDD adoption journey with a few teams first to show its value and identify the necessary changes to your way of working before expanding it to others.
  • Use the learnings and data from initial proof of concept to persuade leadership and others to help drive large scale adoption through smooth onboarding experience with contextualized playbooks and utilities for CDD

Related Articles

life of api specmatic

May 20, 2025

Read time: 16 mins

Demystifying API Lifecycle: Unpacking Essential Roles, Responsibilities and Their Challenges 

APIs are the invisible glue of modern digital ecosystems - powering microservices, enabling integrations, and accelerating innovation. But building and scaling successful APIs takes more
Read Article
An image of a woman experiencing microservices integration hell

January 17, 2023

Read time: 2 mins

[Contract Driven Development – Post 2] Integration Hell

Integration Tests require the actual components/microservices to be deployed to a common environment. Because of this integration tests are able to verify the connections between
Read Article
API mocks

December 30, 2022

Read time: 3 mins

[Contract Driven Development – Post 1] – The trouble with API mocks and stubs

Over the last 6-7 years, I've studied several microservices architecture transformations. What I've realised is a lot of them are not bearing the returns the
Read Article
A group of people integrating microservices using contract-driven development.

December 29, 2022

Read time: 10 mins

Microservices Integration Done Right Using Contract-Driven Development

Contract Driven Development helps us leverage API specifications as executable contracts using Specmatic to shift left the identification of compatibility issues thereby eliminating / reducing
Read Article