Skip to content

Installation

zhu1090093659 edited this page Jun 8, 2026 · 1 revision

Installation

Spec-Driven Develop is distributed as Markdown skills plus optional plugin metadata for Claude Code and Codex. The core workflow has no runtime dependency, SDK, API key, or build step.

Install on Claude Code

Use the Claude Code plugin marketplace:

/plugin marketplace add zhu1090093659/spec_driven_develop
/plugin install spec-driven-develop@spec-driven-develop

After installation, reload plugins:

/reload-plugins

Claude Code also gets optional slash commands and sub-agent prompts:

  • /spec-dev starts the Spec-Driven Develop workflow.
  • /dp starts the Deep Discuss workflow.
  • project-analyzer, task-architect, and task-executor support large workflow runs when sub-agents are available.

Install on Codex

Install the Codex plugin marketplace from GitHub:

codex plugin marketplace add zhu1090093659/spec_driven_develop --ref main

Then enable Spec-Driven Develop in the Codex plugin UI.

If your Codex client does not expose plugin UI yet, add this to ~/.codex/config.toml:

[plugins."spec-driven-develop@spec-driven-develop"]
enabled = true

You can also install only the core skill from inside a Codex session:

$skill-installer install https://github.com/zhu1090093659/spec_driven_develop/tree/main/plugins/spec-driven-develop/skills/spec-driven-develop

Or use the shell installer:

bash <(curl -sL https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-codex.sh)

Install on Cursor

Use the Cursor install script:

bash <(curl -sL https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-cursor.sh)

Or clone the repository and run the script locally:

git clone https://github.com/zhu1090093659/spec_driven_develop.git
bash spec_driven_develop/scripts/install-cursor.sh

Use with Other AI Coding Agents

Any agent that can read custom Markdown instructions can use the core workflow.

Download the main skill:

curl -sL https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/plugins/spec-driven-develop/skills/spec-driven-develop/SKILL.md -o SKILL.md

For the complete workflow, also copy the references/ directory from:

plugins/spec-driven-develop/skills/spec-driven-develop/references/

Common placement options:

Agent Where to Put It
Windsurf .windsurf/skills/ or project rules
Cline .cline/skills/ or custom instructions
Aider Reference in .aider.conf.yml or paste into chat
Continue .continue/ configuration or system prompt
Other agents Any custom instruction, skill, memory, or system prompt surface

Install Everything from the Repository

After cloning:

git clone https://github.com/zhu1090093659/spec_driven_develop.git
cd spec_driven_develop
bash scripts/install-all.sh

Verify the Install

After installation, ask your agent one of these:

Use spec-driven development to plan this migration.
Help me analyze this technical problem deeply.

If installed correctly, the agent should either trigger Spec-Driven Develop for large transformation work or Deep Discuss for structured problem analysis.

Related Pages

Clone this wiki locally