Skip to content
/ cc-sdd Public

Spec-driven development (SDD) for your team's workflow. Kiro style commands that enforce structured requirements→design→tasks workflow and steering, transforming how you build with AI. Support Claude Code, Codex, Cursor, Github Copilot, Gemini CLI and Windsurf.

License

Notifications You must be signed in to change notification settings

gotalab/cc-sdd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cc-sdd: Spec-driven development for your team's workflow

npm version install size license: MIT

Transform AI coding agents into production-ready spec-driven development

One command. Hours instead of weeks. Requirements → Design → Tasks → Implementation.

👻 Kiro-inspired — Similar Spec-Driven, AI-DLC style as Kiro IDE, so existing Kiro specs remain compatible and portable.

Stop losing 70% of development time to meetings, documentation ceremonies, and scattered context. cc-sdd brings structured AI-DLC (AI-Driven Development Lifecycle) and Spec-Driven Development to Claude Code, Cursor, Gemini CLI, Codex CLI, GitHub Copilot, Qwen Code, and Windsurf.

What you get:

  • Spec-first guarantees — Approve requirements/design upfront, then AI implements exactly as specified
  • Parallel execution ready — Tasks decomposed for concurrent implementation with dependency tracking
  • Team-aligned templates — Customize once, all agents output docs that fit your approval process
  • Project Memory — AI remembers your architecture, patterns, and standards across sessions
  • 7 agents, unified workflow — Same spec-driven process across Claude, Cursor, Gemini, Codex, Copilot, Qwen, Windsurf
  • Hours instead of weeks — Feature planning goes from days to hours with AI-assisted specs

🚀 Quick Start

# Run in your project root directory
cd your-project
npx cc-sdd@latest --claude --lang en ## Claude Code

# ✅ That's it! Now run: /kiro:spec-init <what-to-build>

Installation takes 30 seconds. Supports 7 agents (Claude (Commands / Subagents), Cursor, Gemini, Codex, Copilot, Qwen, Windsurf) × 12 languages.

📖 Next steps: All installation options | Command Reference | Spec-Driven Guide

📋 See It In Action

Example: Building a new Photo Albums Feature

/kiro:spec-init Photo albums with upload, tagging, and sharing
/kiro:spec-requirements photo-albums-en
/kiro:spec-design photo-albums-en -y
/kiro:spec-tasks photo-albums-en -y

Generated in 10 minutes:

  • requirements.md — 15 EARS-format requirements
  • design.md — Architecture with Mermaid diagrams
  • tasks.md — 12 implementation tasks with dependencies

Want to inspect a complex, large-scale requirements set? Jump to the advanced customer-support-rag-backend-en spec for the end-to-end requirements → design → tasks flow.

Example: design.md System Flow

🎯 Use Cases

Scenario Workflow
New feature (greenfield) spec-initspec-requirementsspec-designspec-tasksspec-impl
Enhance existing code (brownfield) steeringspec-init → (validate-gap →) spec-design → (validate-design →) spec-tasksspec-impl
Team process alignment Customize templates once in .kiro/settings/templates/ → all agents follow same format

🎨 Customization

Customize templates and rules in {{KIRO_DIR}}/settings/ to match your team's workflow:

  • templates/ - Define document structure (requirements, design, tasks)
  • rules/ - Define AI generation principles and judgment criteria

Common use cases: PRD-style requirements, API/database schemas, approval gates, JIRA integration, domain-specific standards.

📖 Customization Guide — Complete guide with practical examples

⚙️ Advanced Installation

Choose Your Agent

npx cc-sdd@latest --claude         # Claude Code (11 commands) [default]
npx cc-sdd@latest --claude-agent   # Claude Code Subagents (12 commands + 9 subagents)
npx cc-sdd@latest --cursor         # Cursor IDE
npx cc-sdd@latest --gemini         # Gemini CLI
npx cc-sdd@latest --codex          # Codex CLI
npx cc-sdd@latest --copilot        # GitHub Copilot
npx cc-sdd@latest --qwen           # Qwen Code
npx cc-sdd@latest --windsurf       # Windsurf IDE

Choose Your Language

npx cc-sdd@latest --lang ja        # Japanese
npx cc-sdd@latest --lang zh-TW     # Traditional Chinese
npx cc-sdd@latest --lang es        # Spanish
# Supports: en, ja, zh-TW, zh, es, pt, de, fr, ru, it, ko, ar

Advanced Options

# Preview changes before applying
npx cc-sdd@latest --dry-run

# Custom specs directory
npx cc-sdd@latest --kiro-dir docs/specs

📚 Documentation & Support

📖 Complete Guides (English | 日本語)

Guide What You'll Learn Links
Command Reference All 11 /kiro:* commands with detailed usage, parameters, and examples English | 日本語
Customization Guide 7 practical examples: PRD requirements, frontend/backend designs, JIRA integration English | 日本語
Spec-Driven Guide Complete workflow methodology from requirements to implementation English | 日本語
Claude Subagents Advanced: Using 9 specialized subagents for complex projects English | 日本語
Migration Guide Upgrading from v1.x to v2.0.0 English | 日本語

Package Documentation


📚 Related Resources

📝 Articles & Presentations

🔗 External Resources

📦 Package Information

This repository contains the cc-sdd NPM package located in tools/cc-sdd/.

For detailed documentation, installation instructions, and usage examples, see:

License

MIT License

About

Spec-driven development (SDD) for your team's workflow. Kiro style commands that enforce structured requirements→design→tasks workflow and steering, transforming how you build with AI. Support Claude Code, Codex, Cursor, Github Copilot, Gemini CLI and Windsurf.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published