Spec-Driven Develop provides a cross-platform AI agent skill designed to automate the pre-development workflow for large-scale, complex software transformations. It targets developers and teams seeking structured planning and task decomposition without adopting heavy frameworks, offering a lightweight, document-driven methodology to enhance AI agent productivity for tasks like project rewrites or architectural migrations.

How It Works

The core innovation is a single Markdown file (SKILL.md) that encapsulates a structured methodology for AI agents. This file guides agents through deep project analysis, task decomposition, progress tracking, and sub-skill generation. The approach is advantageous due to its extreme simplicity, zero dependencies, and minimal overhead, allowing users to retain full control over their development process, unlike more complex, opinionated frameworks.

Quick Start & Requirements

• Installation:
  • Claude Code: Add plugin from marketplace or via /plugin install spec-driven-develop@spec-driven-develop, followed by /reload-plugins.
  • Codex: Use $skill-installer install <URL> or run bash <(curl -sL https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-codex.sh).
  • Cursor: Run bash <(curl -sL https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-cursor.sh) or clone the repo and run locally.
• Prerequisites: Requires specific AI development environments: Claude Code, OpenAI Codex, or Cursor. The core skill itself has zero dependencies.
• Links:
  • Repo: https://github.com/zhu1090093659/spec_driven_develop
  • Codex Install Script: https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-codex.sh
  • Cursor Install Script: https://raw.githubusercontent.com/zhu1090093659/spec_driven_develop/main/scripts/install-cursor.sh

Highlighted Details

• Zero Dependencies: The core skill is a single Markdown file, requiring no external libraries or runtimes.
• Cross-Platform: Supports Claude Code, Codex, and Cursor AI development environments.
• Cross-Conversation Continuity: Utilizes a master progress file (docs/progress/MASTER.md) to maintain context across multiple AI sessions for long-running tasks.
• Native Task Tracking: Integrates with platform-native task tracking tools (e.g., TodoWrite in Claude Code) for in-IDE visibility.
• Progress Export: An optional script allows exporting progress data to structured JSON for integration with external project management tools like Linear, Jira, or Notion.

Maintenance & Community

The project is presented as a single, self-contained skill file, suggesting minimal maintenance overhead. Specific community links (e.g., Discord, Slack) or details on active contributors and sponsorships are not detailed in the README.

Licensing & Compatibility

The project is licensed under the MIT License. This license generally permits commercial use and integration with closed-source projects without significant restrictions.

Limitations & Caveats

This skill focuses exclusively on the structured planning and decomposition phase of development. It is not a code execution framework, runtime, or package manager, and its functionality is tied to the specific AI platforms it supports.