2025-09-08 23:21:12 -07:00
# Spec Kit
2025-09-08 23:14:53 -07:00
*Build high-quality software faster.*
**An effort to allow organizations to focus on product scenarios rather than writing undifferentiated code with the help of Spec-Driven Development.**
2025-09-08 23:21:12 -07:00
## What is Spec-Driven Development?
2025-09-08 23:14:53 -07:00
Spec-Driven Development **flips the script** on traditional software development. For decades, code has been king — specifications were just scaffolding we built and discarded once the "real work" of coding began. Spec-Driven Development changes this: **specifications become executable** , directly generating working implementations rather than just guiding them.
## Getting Started
- [Installation Guide ](installation.md )
- [Quick Start Guide ](quickstart.md )
2025-09-13 09:28:46 +07:00
- [Local Development ](local-development.md )
2025-09-08 23:14:53 -07:00
2025-09-08 23:21:12 -07:00
## Core Philosophy
2025-09-08 23:14:53 -07:00
Spec-Driven Development is a structured process that emphasizes:
- **Intent-driven development** where specifications define the "_what_" before the "_how_"
- **Rich specification creation** using guardrails and organizational principles
- **Multi-step refinement** rather than one-shot code generation from prompts
- **Heavy reliance** on advanced AI model capabilities for specification interpretation
2025-09-08 23:21:12 -07:00
## Development Phases
2025-09-08 23:14:53 -07:00
| Phase | Focus | Key Activities |
|-------|-------|----------------|
| **0-to-1 Development** ("Greenfield") | Generate from scratch | <ul><li>Start with high-level requirements</li><li>Generate specifications</li><li>Plan implementation steps</li><li>Build production-ready applications</li></ul> |
| **Creative Exploration** | Parallel implementations | <ul><li>Explore diverse solutions</li><li>Support multiple technology stacks & architectures</li><li>Experiment with UX patterns</li></ul> |
| **Iterative Enhancement** ("Brownfield") | Brownfield modernization | <ul><li>Add features iteratively</li><li>Modernize legacy systems</li><li>Adapt processes</li></ul> |
2025-09-08 23:21:12 -07:00
## Experimental Goals
2025-09-08 23:14:53 -07:00
Our research and experimentation focus on:
### Technology Independence
- Create applications using diverse technology stacks
- Validate the hypothesis that Spec-Driven Development is a process not tied to specific technologies, programming languages, or frameworks
### Enterprise Constraints
- Demonstrate mission-critical application development
- Incorporate organizational constraints (cloud providers, tech stacks, engineering practices)
- Support enterprise design systems and compliance requirements
### User-Centric Development
- Build applications for different user cohorts and preferences
- Support various development approaches (from vibe-coding to AI-native development)
### Creative & Iterative Processes
- Validate the concept of parallel implementation exploration
- Provide robust iterative feature development workflows
- Extend processes to handle upgrades and modernization tasks
## Contributing
Please see our [Contributing Guide ](CONTRIBUTING.md ) for information on how to contribute to this project.
## Support
For support, please check our [Support Guide ](SUPPORT.md ) or open an issue on GitHub.