diff --git a/README.md b/README.md index d270f63d..b6d7848e 100644 --- a/README.md +++ b/README.md @@ -20,16 +20,16 @@ ## Table of Contents - [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development) -- [⚡ Get started](#-get-started) +- [⚡ Get Started](#-get-started) - [📽️ Video Overview](#️-video-overview) - [🤖 Supported AI Agents](#-supported-ai-agents) - [🔧 Specify CLI Reference](#-specify-cli-reference) -- [📚 Core philosophy](#-core-philosophy) -- [🌟 Development phases](#-development-phases) -- [🎯 Experimental goals](#-experimental-goals) +- [📚 Core Philosophy](#-core-philosophy) +- [🌟 Development Phases](#-development-phases) +- [🎯 Experimental Goals](#-experimental-goals) - [🔧 Prerequisites](#-prerequisites) -- [📖 Learn more](#-learn-more) -- [📋 Detailed process](#-detailed-process) +- [📖 Learn More](#-learn-more) +- [📋 Detailed Process](#-detailed-process) - [🔍 Troubleshooting](#-troubleshooting) - [👥 Maintainers](#-maintainers) - [💬 Support](#-support) @@ -40,7 +40,7 @@ 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. -## ⚡ Get started +## ⚡ Get Started ### 1. Install Specify @@ -247,7 +247,7 @@ Additional commands for enhanced quality and validation: |------------------|------------------------------------------------------------------------------------------------| | `SPECIFY_FEATURE` | Override feature detection for non-Git repositories. Set to the feature directory name (e.g., `001-photo-albums`) to work on a specific feature when not using Git branches.
**Must be set in the context of the agent you're working with prior to using `/speckit.plan` or follow-up commands. | -## 📚 Core philosophy +## 📚 Core Philosophy Spec-Driven Development is a structured process that emphasizes: @@ -256,7 +256,7 @@ Spec-Driven Development is a structured process that emphasizes: - **Multi-step refinement** rather than one-shot code generation from prompts - **Heavy reliance** on advanced AI model capabilities for specification interpretation -## 🌟 Development phases +## 🌟 Development Phases | Phase | Focus | Key Activities | |-------|-------|----------------| @@ -264,7 +264,7 @@ Spec-Driven Development is a structured process that emphasizes: | **Creative Exploration** | Parallel implementations | | | **Iterative Enhancement** ("Brownfield") | Brownfield modernization | | -## 🎯 Experimental goals +## 🎯 Experimental Goals Our research and experimentation focus on: @@ -300,14 +300,14 @@ Our research and experimentation focus on: If you encounter issues with an agent, please open an issue so we can refine the integration. -## 📖 Learn more +## 📖 Learn More - **[Complete Spec-Driven Development Methodology](./spec-driven.md)** - Deep dive into the full process - **[Detailed Walkthrough](#-detailed-process)** - Step-by-step implementation guide --- -## 📋 Detailed process +## 📋 Detailed Process
Click to expand the detailed step-by-step walkthrough