{"id":107851,"url":"https://github.com/aabs/awesome-specification-driven-development","name":"awesome-specification-driven-development","description":"An Awesome List of Specification Driven Development resources","projects_count":57,"last_synced_at":"2026-07-02T08:00:20.238Z","repository":{"id":315365049,"uuid":"1059188390","full_name":"aabs/awesome-specification-driven-development","owner":"aabs","description":"An Awesome List of Specification Driven Development resources","archived":false,"fork":false,"pushed_at":"2026-03-02T00:20:58.000Z","size":62,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-29T08:30:58.996Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-18T05:47:43.000Z","updated_at":"2026-06-06T16:05:09.000Z","dependencies_parsed_at":"2025-09-18T07:35:04.341Z","dependency_job_id":"e3c50dff-a144-45dc-a6d5-de8dc6fdcd86","html_url":"https://github.com/aabs/awesome-specification-driven-development","commit_stats":null,"previous_names":["aabs/awesome-specification-driven-development"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aabs/awesome-specification-driven-development","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aabs%2Fawesome-specification-driven-development","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aabs%2Fawesome-specification-driven-development/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aabs%2Fawesome-specification-driven-development/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aabs%2Fawesome-specification-driven-development/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aabs","download_url":"https://codeload.github.com/aabs/awesome-specification-driven-development/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aabs%2Fawesome-specification-driven-development/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35038239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"created_at":"2026-01-17T04:50:45.298Z","updated_at":"2026-07-02T08:00:20.238Z","primary_language":null,"list_of_lists":false,"displayable":true,"categories":["Blog Posts \u0026 Videos","Popular Frameworks","Agentic Programming","Contract Testing","API-First Tools","Theory and Methodologies","MCP Servers","Community"],"sub_categories":["Advanced Topics","Getting Started","OpenAPI and Swagger Tools","Frameworks and Tools","Pact Ecosystem","Code Generation","Academic Resources","Behavior Driven Development (BDD)","Contract Testing Resources","Design and Specification","Specification-Driven Agent Development","Specification-First Development Frameworks","Forums and Discussion"],"readme":"# Awesome Specification Driven Development [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)\n\n\u003e A curated list of tools, frameworks, and resources for Specification Driven Development (SDD) - the practice of creating software by starting with specifications and using them to drive the entire development process.\n\nSpecification Driven Development emphasizes creating clear, executable specifications first, then using these specifications to generate code, tests, documentation, and other artifacts. This approach ensures consistency, reduces bugs, and improves collaboration between teams.\n\n## Contents\n\n- [Popular Frameworks](#popular-frameworks)\n- [Theory and Methodologies](#theory-and-methodologies)\n- [Agentic Programming](#agentic-programming)\n- [MCP Servers](#mcp-servers)\n- [IDE Support](#ide-support)\n- [Blog Posts](#blog-posts)\n- [Community](#community)\n- [Contract Testing](#contract-testing)\n- [API-First Tools](#api-first-tools)\n- [Contributing](#contributing)\n\n## Popular Frameworks\n\n### Specification-First Development Frameworks\n\n- **[GitHub Spec-Kit](https://github.com/github/spec-kit)** - A Toolkit to help you get started with Spec-Driven Development. ![GitHub stars](https://img.shields.io/github/stars/github/spec-kit)\n- **[OpenSpec](https://github.com/Fission-AI/OpenSpec)** - OpenSpec aligns humans and AI coding assistants with spec-driven development so you agree on what to build before any code is written. ![GitHub stars](https://img.shields.io/github/stars/Fission-AI/OpenSpec)\n- **[SpecPulse](https://github.com/specpulse/specpulse)** - Specification-Driven Development (SDD) Framework for Python. ![GitHub stars](https://img.shields.io/github/stars/specpulse/specpulse)\n- **[Falcon Heavy](https://github.com/NotJustAToy/falcon-heavy)** - Framework for building app backends and microservices by specification-first API design approach based on OpenAPI Specification 3. ![GitHub stars](https://img.shields.io/github/stars/NotJustAToy/falcon-heavy)\n- **[Kiro-base SDD](https://github.com/jasonkneen/kiro?tab=readme-ov-file)** - A comprehensive guide to systematic feature development using the three-phase spec process: `Requirements → Design → Tasks`.\n\n### OpenAPI and Swagger Tools\n\n- **[Swagger Core](https://github.com/swagger-api/swagger-core)** - Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API. ![GitHub stars](https://img.shields.io/github/stars/swagger-api/swagger-core)\n- **[Swagger TypeScript API](https://github.com/acacode/swagger-typescript-api)** - Generate the API Client for Fetch or Axios from an OpenAPI Specification. ![GitHub stars](https://img.shields.io/github/stars/acacode/swagger-typescript-api)\n- **[OpenAPI TypeScript Codegen](https://github.com/ferdikoomen/openapi-typescript-codegen)** - NodeJS library that generates TypeScript or JavaScript clients based on the OpenAPI specification. ![GitHub stars](https://img.shields.io/github/stars/ferdikoomen/openapi-typescript-codegen)\n- **[oapi-codegen](https://github.com/oapi-codegen/oapi-codegen)** - Generate Go client and server boilerplate from OpenAPI 3 specifications. ![GitHub stars](https://img.shields.io/github/stars/oapi-codegen/oapi-codegen)\n\n### Behavior Driven Development (BDD)\n\n- **[Concordion](https://github.com/concordion/concordion)** - Open source framework for Java that lets you turn a plain English description of a requirement into an automated test. ![GitHub stars](https://img.shields.io/github/stars/concordion/concordion)\n- **[JGiven](https://github.com/TNG/JGiven)** - Behavior-Driven Development in plain Java. ![GitHub stars](https://img.shields.io/github/stars/TNG/JGiven)\n- **[Lettuce](https://github.com/gabrielfalcao/lettuce)** - Behavior-driven-development tool for Python, inspired by Cucumber for Ruby. ![GitHub stars](https://img.shields.io/github/stars/gabrielfalcao/lettuce)\n- **[Mamba](https://github.com/nestorsalceda/mamba)** - The definitive testing tool for Python. Born under the banner of Behavior Driven Development (BDD). ![GitHub stars](https://img.shields.io/github/stars/nestorsalceda/mamba)\n\n## Theory and Methodologies\n- **[Augmented Coding Patterns](https://lexler.github.io/augmented-coding-patterns/)** - A collection of emerging patterns, anti-patterns and obstacles for effective AI-augmented software development.\n- **[A Plan-Do-Check-Act Framework for AI Code Generation](https://www.infoq.com/articles/PDCA-AI-code-generation/)**\n\n### Core Concepts\n- **Specification by Example** - A collaborative approach to defining requirements and business-oriented functional tests\n- **Contract-Driven Development** - Development approach where API contracts are defined first and used to drive implementation\n- **Design-First API Development** - Creating API specifications before implementation to ensure consistent design\n- **Domain-Driven Design (DDD)** - Software design approach focusing on modeling software to match a domain according to input from domain experts\n\n### Academic Resources\n- **[Shriek-fx](https://github.com/ElderJames/shriek-fx)** - .NET Core framework following domain-driven design (DDD) specifications with CQRS architecture. ![GitHub stars](https://img.shields.io/github/stars/ElderJames/shriek-fx)\n- **[Archived Specmatic Documentation](https://github.com/znsio/archived-specmatic-documentation)** - Turn your contracts into executable specifications. Contract Driven Development approach. ![GitHub stars](https://img.shields.io/github/stars/znsio/archived-specmatic-documentation)\n\n## Agentic Programming\n\n### Frameworks and Tools\n\n- **[AgentScope](https://github.com/agentscope-ai/agentscope)** - Agent-Oriented Programming for Building LLM Applications. ![GitHub stars](https://img.shields.io/github/stars/agentscope-ai/agentscope)\n- **[MetaGPT](https://github.com/FoundationAgents/MetaGPT)** - The Multi-Agent Framework: First AI Software Company, Towards Natural Language Programming. ![GitHub stars](https://img.shields.io/github/stars/FoundationAgents/MetaGPT)\n- **[Microsoft AutoGen](https://github.com/microsoft/autogen)** - A programming framework for agentic AI. ![GitHub stars](https://img.shields.io/github/stars/microsoft/autogen)\n- **[Langroid](https://github.com/langroid/langroid)** - Harness LLMs with Multi-Agent Programming. ![GitHub stars](https://img.shields.io/github/stars/langroid/langroid)\n- **[Serena](https://github.com/oraios/serena)** - A powerful coding agent toolkit providing semantic retrieval and editing capabilities (MCP server \u0026 other integrations). ![GitHub stars](https://img.shields.io/github/stars/oraios/serena)\n- **[LLM4S](https://github.com/llm4s/llm4s)** - Agentic and LLM Programming in Scala. ![GitHub stars](https://img.shields.io/github/stars/llm4s/llm4s)\n\n### Specification-Driven Agent Development\n\n- **[DafnckMachine - AGF 2.0](https://github.com/DafnckStudio/DafnckMachine---AGF-2.0)** - Agentic Coding Framework powered by Pheromind – a revolutionary system designed to orchestrate fully autonomous, specification-driven software development. ![GitHub stars](https://img.shields.io/github/stars/DafnckStudio/DafnckMachine---AGF-2.0)\n\n## MCP Servers\n\n- **[Awesome MCP Servers](https://github.com/wong2/awesome-mcp-servers)** - A curated list of Model Context Protocol (MCP) servers. ![GitHub stars](https://img.shields.io/github/stars/wong2/awesome-mcp-servers)\n- **[Awesome MCP Servers (Alternative)](https://github.com/appcypher/awesome-mcp-servers)** - Another curated list of Model Context Protocol servers with extensive collection. ![GitHub stars](https://img.shields.io/github/stars/appcypher/awesome-mcp-servers)\n- **[MCP Registry](https://github.com/modelcontextprotocol/registry)** - A community driven registry service for Model Context Protocol (MCP) servers. ![GitHub stars](https://img.shields.io/github/stars/modelcontextprotocol/registry)\n- **[Context7](https://github.com/upstash/context7)** - Up-to-date code documentation for LLMs and AI code editors  ![GitHub stars](https://img.shields.io/github/stars/upstash/context7)\n- **[Excel MCP Server](https://github.com/haris-musa/excel-mcp-server)** - A Model Context Protocol server for Excel file manipulation. ![GitHub stars](https://img.shields.io/github/stars/haris-musa/excel-mcp-server)\n- **[Qdrant MCP Server](https://github.com/qdrant/mcp-server-qdrant)** - An official Qdrant Model Context Protocol (MCP) server implementation. ![GitHub stars](https://img.shields.io/github/stars/qdrant/mcp-server-qdrant)\n- **[Exa MCP Server](https://github.com/exa-labs/exa-mcp-server)** - Exa Web Search API MCP (Model Context Protocol) server. ![GitHub stars](https://img.shields.io/github/stars/exa-labs/exa-mcp-server)\n- **[Markdownify MCP](https://github.com/zcaceres/markdownify-mcp)** - A Model Context Protocol server for converting almost anything to Markdown. ![GitHub stars](https://img.shields.io/github/stars/zcaceres/markdownify-mcp)\n- **[ArXiv MCP Server](https://github.com/blazickjp/arxiv-mcp-server)** - A Model Context Protocol server for searching and analyzing arXiv papers. ![GitHub stars](https://img.shields.io/github/stars/blazickjp/arxiv-mcp-server)\n- **[Microsoft MCP](https://github.com/microsoft/mcp)** - Catalog of official Microsoft MCP (Model Context Protocol) server implementations for AI-powered data access and tool integration. ![GitHub stars](https://img.shields.io/github/stars/microsoft/mcp)\n- **[Kubernetes MCP Server](https://github.com/containers/kubernetes-mcp-server)** - Model Context Protocol (MCP) server for Kubernetes and OpenShift. ![GitHub stars](https://img.shields.io/github/stars/containers/kubernetes-mcp-server)\n\n## IDE Support\n\n### VSCode Extensions\n- **Swagger Viewer** - Preview Swagger/OpenAPI specifications in VSCode\n- **OpenAPI (Swagger) Editor** - Edit OpenAPI specifications with validation and preview\n- **REST Client** - Send HTTP requests and view responses directly in VSCode\n\n### JetBrains IDEs\n- **OpenAPI Specifications** - Built-in support for OpenAPI specification editing and validation\n- **HTTP Client** - Built-in HTTP client for testing APIs defined in specifications\n\n### Specialized Tools\n- **Stoplight Studio** - Visual OpenAPI specification editor\n- **Insomnia Designer** - Collaborative API design platform\n- **Postman** - API development environment with specification support\n\n## Blog Posts \u0026 Videos\n\n### Getting Started\n- [API-First Development: Benefits and Best Practices](https://swagger.io/blog/api-development/api-first-development/)\n- [Contract-Driven Development: A Guide](https://docs.pact.io/getting_started/what_is_pact)\n- [Specification by Example: An Introduction](https://gojko.net/books/specification-by-example/)\n- [Spec-driven development: Using Markdown as a programming language when building with AI](https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/)\n\n### Advanced Topics\n- [Building Microservices with Contract Testing](https://martinfowler.com/articles/microservice-testing/)\n- [Domain-Driven Design and Specification Patterns](https://martinfowler.com/bliki/SpecificationPattern.html)\n- [Behavior-Driven Development in Practice](https://cucumber.io/blog/bdd/bdd-vs-tdd/)\n- [Chris Yaowen Zhang - The limits of specification driven development](https://dev.to/chrisywz/the-limits-of-spec-driven-development-3b16)\n\n## Community\n\n### Forums and Discussion\n- **[OpenAPI Community](https://community.openapis.org/)** - Official OpenAPI specification community\n- **[Pact Foundation](https://docs.pact.io/pact_broker/overview)** - Consumer-driven contract testing community\n- **[BDD Community](https://cucumber.io/blog/community/)** - Behavior-driven development discussions\n\n### Conferences and Events\n- **API World** - Annual API development conference\n- **OpenAPI Initiative Meetups** - Local meetups for OpenAPI enthusiasts\n- **BDD Exchange** - Conference focused on behavior-driven development\n\n## Contract Testing\n\n### Pact Ecosystem\n- **[Pact JVM](https://github.com/pact-foundation/pact-jvm)** - JVM version of Pact for consumer driven contract testing. ![GitHub stars](https://img.shields.io/github/stars/pact-foundation/pact-jvm)\n- **[Pact Ruby](https://github.com/pact-foundation/pact-ruby)** - Ruby implementation providing a mock service and DSL for consumer-driven contract testing. ![GitHub stars](https://img.shields.io/github/stars/pact-foundation/pact-ruby)\n- **[Pact .NET](https://github.com/pact-foundation/pact-net)** - .NET version of Pact for consumer driven contract testing. ![GitHub stars](https://img.shields.io/github/stars/pact-foundation/pact-net)\n- **[Pact Python](https://github.com/pact-foundation/pact-python)** - Python version of Pact enabling consumer driven contract testing. ![GitHub stars](https://img.shields.io/github/stars/pact-foundation/pact-python)\n- **[Pact PHP](https://github.com/pact-foundation/pact-php)** - PHP version of Pact for consumer driven contract testing. ![GitHub stars](https://img.shields.io/github/stars/pact-foundation/pact-php)\n\n### Contract Testing Resources\n- **[Awesome Contract Testing](https://github.com/lirantal/awesome-contract-testing)** - Awesome resources for Consumer-Driven Contract Testing. ![GitHub stars](https://img.shields.io/github/stars/lirantal/awesome-contract-testing)\n\n## API-First Tools\n\n### Design and Specification\n- **[Panacloud CLI](https://github.com/panacloud/cli)** - Uses the design-first approach for developing APIs, generating Modern Multi-Tenant Serverless Cloud API infrastructure. ![GitHub stars](https://img.shields.io/github/stars/panacloud/cli)\n- **[API Codeflow Node.js](https://github.com/RepreZen/API-Codeflow-Node.js)** - Build and evolve a REST API design-first with OpenAPI-Generator and Node.js. ![GitHub stars](https://img.shields.io/github/stars/RepreZen/API-Codeflow-Node.js)\n\n### Code Generation\n- **[Swagger JSDoc](https://github.com/Surnet/swagger-jsdoc)** - Generates swagger/openapi specification based on jsDoc comments and YAML files. ![GitHub stars](https://img.shields.io/github/stars/Surnet/swagger-jsdoc)\n- **[ApiSpec](https://github.com/marshmallow-code/apispec)** - A pluggable API specification generator supporting OpenAPI Specification. ![GitHub stars](https://img.shields.io/github/stars/marshmallow-code/apispec)\n- **[OpenAPI Diff](https://github.com/OpenAPITools/openapi-diff)** - Utility for comparing two OpenAPI specifications. ![GitHub stars](https://img.shields.io/github/stars/OpenAPITools/openapi-diff)\n\n## Contributing\n\nContributions are welcome! Please read the [contribution guidelines](CONTRIBUTING.md) first.\n\n### How to Contribute\n1. Fork this repository\n2. Add your awesome resource to the appropriate section\n3. Ensure the resource follows the format: `**[Name](link)** - Description. ![GitHub stars](shield-url)`\n4. Submit a pull request\n\n### Criteria for Inclusion\n- Resource must be related to specification-driven development\n- Active maintenance and community support\n- Clear documentation and examples\n- Open source preferred (but not required for learning resources)\n","projects_url":"https://awesome.ecosyste.ms/api/v1/lists/aabs%2Fawesome-specification-driven-development/projects"}