███████╗██████╗ ███████╗ ██████╗ ██╗ ██╗██╗████████╗
██╔════╝██╔══██╗██╔════╝██╔════╝ ██║ ██╔╝██║╚══██╔══╝
███████╗██████╔╝█████╗ ██║ █████╔╝ ██║ ██║
╚════██║██╔═══╝ ██╔══╝ ██║ ██╔═██╗ ██║ ██║
███████║██║ ███████╗╚██████╗ ██║ ██╗██║ ██║
╚══════╝╚═╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝
A free, open-knowledge ebook that teaches you how to stop vibe coding and start building software with structured AI specifications using GitHub Spec Kit.
Whether you're a beginner or experienced developer, this guide walks you through the entire Spec-Driven Development workflow, from setting up your environment to building a complete HabitTracker app, all with copy-paste-ready prompts.
"Doing exactly what I asked and NOTHING more is a glowing endorsement. That is how agentic coding becomes viable at the enterprise level."
- GitHub Spec Kit Community
| Chapter | Topic | What You'll Learn |
|---|---|---|
| 01 | The Problem with Vibe Coding | Why unstructured AI coding fails at scale |
| 02 | The Anatomy of AI Interaction | Prompts, agents, skills, MCP, and Copilot's pricing model, and why strategy beats billing anxiety |
| 03 | What is Spec-Driven Development? | The four pillars and philosophy of SDD |
| 04 | Introducing GitHub Spec Kit | The slash commands (core + optional) and project structure |
| 05 | Setting Up Your Environment | From zero to working project in 10 minutes |
| 06 | The SDD Workflow Deep Dive | Each phase with examples and best practices |
| 07 | Token Optimization & Best Practices | How SDD reduces AI token consumption by ~60% |
| 08 | Project: Build a HabitTracker | Complete hands-on build with every prompt |
Plus Release Notes tracking content updates and an About the Authors section.
The ebook is hosted as a single-page web application on GitHub Pages, with a
persistent chapter/topic sidebar, in-page search (press /), and a Release
Notes section documenting what's changed:
👉 https://tanure.github.io/spec-kit-workshop/
Albert Tanure, Cross Solutions Architect at Microsoft · Docker Captain · Former Microsoft MVP (7 years) LinkedIn · GitHub · Tanure.io
Rodrigo Moreirao, Cloud Solution Architect at Microsoft · DevSecOps & GitHub Specialist LinkedIn
This ebook is open knowledge, share freely, learn openly, build better software.
Stop vibe coding. Start building with intent.
