GitHub's spec-kit shifts to intent-driven dev
- GitHub’s open-source spec-kit is now being framed less as prompt scaffolding and more as intent-driven development for AI coding workflows. - The repo has about 93,600 stars, and its docs now center a flow where specs define the “what” before agents handle the “how.” - That matters because AI coding is shifting from one-shot vibe coding toward repeatable, spec-first workflows teams can actually govern.
GitHub’s spec-kit matters because it tries to solve the part of AI coding that still breaks in practice — not code generation, but intent. Models can write plenty of code. The problem is getting the right code, in the right shape, with the right constraints, and keeping that thread intact as a project grows. That is the gap spec-kit is now leaning into much more explicitly. The shift is subtle but important. GitHub’s public docs now describe the core philosophy as “intent-driven development,” where specifications define the “what” before the “how,” and code becomes a downstream artifact rather than the center of the process. The repo itself has also become huge — roughly 93,600 stars as of May 9, 2026. ### What is spec-kit actually trying to do? Basically, it turns a natural-language product idea into a structured workflow for an AI coding agent. Instead of dumping a giant prompt into Copilot, Claude Code, or Gemini CLI and hoping the model improvises well, you create a spec, refine it, break it into tasks, and then let the agent implement against that structure. GitHub introduced the toolkit in September 2025 as a way to make specifications “living, executable artifacts” rather than documents that get ignored once coding starts. (github.github.com) ### Why call this “intent-driven” now? Because “spec-driven” can sound like a documentation habit, while “intent-driven” tells you where the real control sits. The human is supposed to express goals, constraints, user journeys, and success conditions. The agent handles more of the code-writing labor. That framing makes spec-kit feel less like a template pack and more like an interface layer between product intent and software output. (github.blog) GitHub’s docs are explicit that the spec defines the what before the how, and that the process relies on multi-step refinement instead of one-shot generation. ### What does the workflow look like? At a high level, it is a staged pipeline. You specify what you want to build. Then you plan how it should be implemented. Then you break the work into tasks. Then you implement with the agent. GitHub describes four phases with checkpoints, and the repo packages that into slash-command-style tooling and templates that work across multiple coding agents. The exact command surface can vary by integration, but the important part is the structure — the agent is not supposed to freestyle from a blank prompt. (github.github.com) ### Why is that better than vibe coding? Because vibe coding fails mostly through drift. The first output may look plausible, but requirements get lost, architecture choices get weird, and later edits start contradicting earlier ones. A spec-first loop acts like a contract the model keeps getting pulled back toward. Think of it like giving a junior engineer a product brief, an implementation plan, and a checklist instead of saying “build something like Uber for dogs” and walking away. (github.blog) ### Why does this matter beyond one repo? Because it shows where AI app development is heading. The winning tools may not be the ones that generate the flashiest code demo. They may be the ones that preserve intent across long builds, handoffs, revisions, and team constraints. GitHub’s own docs frame spec-kit as useful across greenfield apps, brownfield modernization, and enterprise settings with governance requirements. That is a much bigger claim than “here’s a prompt trick.” (github.blog) ### Is this just for big teams? No — and that is part of why the repo’s growth matters. A solo founder can use the same pattern to turn a product idea into a spec and then into an implementation loop. But larger teams get an extra benefit: the spec becomes a shared source of truth that survives model changes, tool changes, and handoffs between humans and agents. (github.github.com) ### What’s the catch? The catch is that this only works if the spec is good enough. Intent-driven development does not remove the need for judgment. It moves judgment upstream. You spend less time hand-writing boilerplate and more time defining constraints clearly. That is a real improvement — but only if teams are willing to do the thinking first. ### Bottom line (github.blog) Spec-kit is turning into a visible prototype for how AI software development may stabilize. Less “prompt and pray.” More “state the intent, lock the spec, let the agent execute.” (github.github.com)