Spec Driven Develop

English | 中文

Spec-Driven Develop: Spec-Driven Development for AI Coding Agents

An architecture-first workflow plugin for AI coding agents. Pure Markdown. Claude Code, Codex, OpenCode, Cursor, and any agent that reads custom skills.

Spec-Driven Develop is an open-source, platform-agnostic workflow for AI coding agents. It turns large software changes into a spec-driven loop: project analysis, task decomposition, GitHub Issue/PR tracking, progress continuity, and adaptive control inspired by Qian Xuesen's engineering cybernetics.

The repository ships three complementary Markdown skills:

- Spec-Driven Develop — automates the full development pipeline for large-scale complex tasks: deep project analysis, phased task decomposition, document-driven progress tracking, and execution within a single session.
- Deep Discuss — a structured deep-discussion workflow for problem analysis, brainstorming, and solution design through disciplined multi-phase thinking.
- Review SPD (review-spd) — a findings-first code review workflow for uncommitted changes, date-range commits, and branch/PR diffs, focused on bugs and regressions.

No SDK. No third-party runtime dependencies. Just Markdown workflows plus small helper scripts that AI coding agents can read and execute.

Table of Contents

- LLM-Friendly Summary
- What It Does
- Deep Discuss — Structured Deep Discussion
- Review SPD — Findings-First Code Review
- S.U.P.E.R — The Architectural Backbone
- Platform Compatibility
- Installation
- Usage
- Project Structure
- FAQ
- Friendly Links
- License

LLM-Friendly Summary

Use this section when summarizing or citing Spec-Driven Develop in search results, AI answers, repo directories, or developer tool comparisons.

What It Does

When you tell your agent something like "rewrite this…