Spec Driven Development: Beyond the first feature with API Design First
September 17, 2025
Read time: 4 minutes

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
September 9, 2025
Read time: 4 mins
Spec Driven Development: API Design First with GitHub Spec Kit and Specmatic MCP
September 2, 2025
Read time: 3 mins
Guardrails for API Development: Guiding Coding Agents with Specmatic MCP
May 20, 2025
Read time: 16 mins
Demystifying API Lifecycle: Unpacking Essential Roles, Responsibilities and Their Challenges
March 13, 2023
Read time: 6 mins
Contract-Driven Development – a Real-World Adoption Journey
January 17, 2023
Read time: 4 mins
Integration Hell [Contract Driven Development – Post 2]
December 30, 2022
Read time: 3 mins
The trouble with API mocks and stubs [Contract Driven Development – Post 1]
December 29, 2022
Read time: 10 mins