8-9 October

Chancery Pavilion Hotel, Bengaluru

Apidays India 2025

8-9 October

Chancery Pavilion Hotel, Bengaluru

Spec Driven Development: Beyond the first feature with API Design First

September 17, 2025

Read time: 4 minutes

specmatic sub agents
Published By
LinkedIn
Author
Hari Krishnan
Share this page

Article Overview

In my previous article, I shared my learnings experimenting with “API Design First with GitHub Spec Kit and Specmatic MCP” with OpenAPI specifications serving as API contracts.

In this follow-up, I take things a step further to test how the setup holds up beyond the first feature. The focus here is on two key aspects.

Going beyond the First Feature

Ensuring the system can evolve without introducing regression or drift, which is especially important when relying on coding agents that tend to optimise for speed but can easily introduce breaking changes.

Parallel Execution with Subagents

As I started building multiple features, I wanted to parallelise development to move faster. This mirrors real-world Contract-Driven Development. Once API contract is agreed upon, backend and frontend can proceed independently.

Related Articles

specify cover

September 9, 2025

Read time: 4 mins

Spec Driven Development: API Design First with GitHub Spec Kit and Specmatic MCP

I first came across Specification Driven Development (SDD) when I was exploring AWS Kiro. Coming from an Extreme Programming (XP) background (TDD, small batches, and
Read Article
claude mcp

September 2, 2025

Read time: 3 mins

Guardrails for API Development: Guiding Coding Agents with Specmatic MCP

Using API specs like OpenAPI to guide coding agents sounds great. But in agentic mode, these agents build and test on their own — so
Read Article
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
A hand points at an API icon during a real-world adoption journey of contract-driven development.

March 13, 2023

Read time: 6 mins

Contract-Driven Development – a Real-World Adoption Journey

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
Read Article
An image of a woman experiencing microservices integration hell

January 17, 2023

Read time: 4 mins

Integration Hell [Contract Driven Development – Post 2]

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
2 parts of a bridge being constructed that are coming together but don't align - representing API mocks that don't align with reality

December 30, 2022

Read time: 3 mins

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

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
specify cover

September 9, 2025

Read time: 4 mins

Spec Driven Development: API Design First with GitHub Spec Kit and Specmatic MCP

I first came across Specification Driven Development (SDD) when I was exploring AWS Kiro. Coming from an Extreme Programming (XP) background (TDD, small batches, and
Read Article
claude mcp

September 2, 2025

Read time: 3 mins

Guardrails for API Development: Guiding Coding Agents with Specmatic MCP

Using API specs like OpenAPI to guide coding agents sounds great. But in agentic mode, these agents build and test on their own — so
Read Article
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
A hand points at an API icon during a real-world adoption journey of contract-driven development.

March 13, 2023

Read time: 6 mins

Contract-Driven Development – a Real-World Adoption Journey

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
Read Article
An image of a woman experiencing microservices integration hell

January 17, 2023

Read time: 4 mins

Integration Hell [Contract Driven Development – Post 2]

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
2 parts of a bridge being constructed that are coming together but don't align - representing API mocks that don't align with reality

December 30, 2022

Read time: 3 mins

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

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