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

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) × 13 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.

🎯 Use Cases

🎨 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, el

Advanced Options

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

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

📚 Documentation & Support

📖 Complete Guides (English | 日本語)

Package Documentation

• English: tools/cc-sdd/README.md
• 日本語: tools/cc-sdd/README_ja.md
• 繁體中文: tools/cc-sdd/README_zh-TW.md

📚 Related Resources

📝 Articles & Presentations

• Kiroの仕様書駆動開発プロセスをClaude Codeで徹底的に再現した - Zenn Article (Japanese)
• Claude Codeは仕様駆動の夢を見ない - Speaker Deck Presentation (Japanese)

🔗 External Resources

• Kiro IDE - Enhanced spec management and team collaboration
• Kiro's Spec Methodology - Proven spec-driven development methodology
• AI-Assisted SDD: Spec-Driven Development with Gemini, Claude, and cc-sdd - Comprehensive book available on Amazon

📦 Package Information

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

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

• Tool Documentation - Complete cc-sdd tool guide
• Japanese Documentation - 日本語版ツール説明

License

MIT License