# Spec Driven Develop

Automates pre-development workflow for large-scale complex tasks.

- Repository: https://github.com/zhu1090093659/spec_driven_develop (993 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-07-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add zhu1090093659/spec_driven_develop --skill spec-driven-develop -g -a claude-code -y`
Codex: `npx skills add zhu1090093659/spec_driven_develop --skill spec-driven-develop -g -a codex -y`
Cursor: `npx skills add zhu1090093659/spec_driven_develop --skill spec-driven-develop -g -a cursor -y`
Gemini CLI: `npx skills add zhu1090093659/spec_driven_develop --skill spec-driven-develop -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add zhu1090093659/spec_driven_develop`

## Description

Automates pre-development workflow for large-scale complex tasks. Use when the user mentions "rewrite", "migrate", "overhaul", "refactor entire project", "transform", "rebuild in [language]", "spec-driven", or describes any large-scale project transformation that requires planning before coding. Also triggers on Chinese keywords: "改造", "重写", "迁移", "重构", "大规模", "规范驱动". Performs full project analysis, task decomposition, documentation generation, project-level instruction and native memory surface resolution, progress tracking setup, and then executes the plan within the same session. Keeps Issues as task-tracking units while batching related implementation into coherent reviewable PRs.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Spec-Driven Develop

You are executing the **Spec-Driven Development** workflow, a seven-phase pipeline (Phases 0-6) for large-scale complex tasks. Complete preparation phases (analysis, planning, progress setup), then execute the plan, all within a single session.

**Behavioral rules**: `references/behavioral-rules.md`, read and follow them in every phase; they are non-negotiable.

## Configuration

| Path | Default Value | Purpose |
|:-----|:--------------|:--------|
| Analysis output | `docs/analysis/` | Phase 1 analysis documents |
| Plan output | `docs/plan/` | Phase 3 planning documents |
| Progress output | `docs/progress/` | Phase 4 tracking documents (incl. MASTER.md) |
| Instruction surfaces | Resolved per project | Project-level constraints for agents (see Phase 4) |
| Memory surface | Native first | Durable facts via the agent's native memory when available; repo fallback only when explicitly selected |
| Archive output | `docs/archives/<project>/` | Phase 6 archived artifacts |
| Task tracking mode | Auto-detect | `GITHUB_FULL`, `GITHUB_STANDARD`, or `LOCAL_ONLY` |
| Delivery batching | Phase-first | Issues track tasks; PRs integrate coherent task batches |
| Adaptive control | Enabled | Drift thresholds: annotate=20%, replan=40%, rescope=60% of phase tasks |

**Canonical references** (each topic has exactly one home, cite it, never re-explain it):

The rest: https://github.com/zhu1090093659/spec_driven_develop/blob/HEAD/plugins/spec-driven-develop/skills/spec-driven-develop/SKILL.md