✨ Transform Claude Code / Codex / Gemini CLI / Cursor / GitHub Copilot / Qwen Code from prototype to production-ready development

Customize all spec and steering templates with a few edits—tailor the generated requirements, design docs, tasks (plan docs), and project memory to your team before the agent ever runs.

One command installs AI-DLC (AI-Driven Development Life Cycle) with SDD (Spec-Driven Development) workflows for Claude Code, Cursor IDE, Gemini CLI, Codex CLI, GitHub Copilot, and Qwen Code.

# Basic installation (default: Claude Code)
npx cc-sdd@latest

# Alpha version with major updates (v2.0.0-alpha.1)
npx cc-sdd@next

# With language: --lang en|ja|zh-TW|zh|es|pt|de|fr|ru|it|ko|ar
npx cc-sdd@latest --lang ja

# With different agents: gemini, cursor, codex, copilot, qwen
npx cc-sdd@latest --claude    # or @next for latest alpha
npx cc-sdd@latest --gemini    # or @next for latest alpha
npx cc-sdd@latest --cursor    # or @next for latest alpha
npx cc-sdd@next --codex       # Requires alpha version
npx cc-sdd@next --copilot     # Requires alpha version
npx cc-sdd@latest --qwen      # or @next for latest alpha

# Ready to go! Your chosen agent can now run `/kiro:spec-init <what-to-build>` and unlock the full SDD workflow

After running cc-sdd, you'll have:

• 11 powerful slash commands (/kiro:steering, /kiro:spec-requirements, /kiro:validate-gap, etc.)
• Project Memory (steering) - AI learns your codebase, patterns, and preferences
• Structured AI-DLC workflow with quality gates and approvals
• Spec-Driven Development methodology built-in
• Template flexibility — tweak settings/templates/requirements.md, design.md, tasks.md, or the steering templates to match your team's and project's preferred docs
• Kiro IDE compatibility for seamless spec management

Perfect for: Feature development, code reviews, technical planning, and maintaining development standards across your team.

Claude Code remains the default agent when no flag is supplied.

Usage: npx cc-sdd@latest --lang <code> (e.g., --lang ja for Japanese)

Brings to Claude Code, Cursor IDE, Gemini CLI, Codex CLI, GitHub Copilot, and Qwen Code your project context, Project Memory (steering) and development patterns: requirements → design → tasks → implementation. Kiro IDE compatible — Reuse Kiro-style SDD specs and workflows seamlessly.

ワンライナーで AI-DLC（AI-Driven Development Life Cycle） と Spec-Driven Development（仕様駆動開発） のワークフローを導入。プロジェクト直下に 11個のSlash / Prompt Commands 一式と設定ファイル（Claude Code用 CLAUDE.md / Cursor IDE・Codex CLI・GitHub Copilot用 AGENTS.md / Gemini CLI用 GEMINI.md）を配置、プロジェクトの文脈と開発パターン（要件 → 設計 → タスク → 実装）、プロジェクトメモリ（ステアリング） を含む。

📝 関連記事
Kiroの仕様書駆動開発プロセスをClaude Codeで徹底的に再現した - Zenn記事

📖 Project Overview (Spec-Driven Development workflow)

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

Transform your agentic development workflow with Spec-Driven Development

# Start spec-driven development immediately
/kiro:spec-init User authentication with OAuth and 2FA
/kiro:spec-requirements user-auth
/kiro:spec-design user-auth -y
/kiro:spec-tasks user-auth -y
/kiro:spec-impl user-auth 1.1,1.2,1.3

📁 Example Spec: See photo-albums-en for a complete spec-driven development example with requirements, design, and tasks.

# First establish project context
/kiro:steering                                    # AI learns existing project context

# Then proceed with development
/kiro:spec-init Add OAuth to existing auth system
/kiro:spec-requirements oauth-enhancement
/kiro:validate-gap oauth-enhancement              # Optional: analyze existing vs requirements
/kiro:spec-design oauth-enhancement -y
/kiro:validate-design oauth-enhancement           # Optional: validate design integration
/kiro:spec-tasks oauth-enhancement -y
/kiro:spec-impl oauth-enhancement 1.1,1.2,1.3

Quality Gates: Each phase requires human approval before proceeding (use -y to auto-approve).

Specs as Foundation: Based on Kiro's proven methodology - specs transform ad-hoc development into systematic workflows. Created specs are portable to Kiro IDE for enhanced implementation guardrails and team collaboration.

# Choose language and OS
npx cc-sdd@latest --lang ja --os mac

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

# Safe update with backup
npx cc-sdd@latest --backup --overwrite force

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

✅ AI-DLC Integration - Complete AI-Driven Development Life Cycle
✅ Project Memory - Steering documents that maintain comprehensive context (architecture, patterns, rules, domain knowledge) across all sessions
✅ Spec-Driven Development - Structured requirements → design → tasks → implementation
✅ Cross-Platform - macOS, Linux, and Windows support with auto-detection (Linux reuses mac templates)
✅ Multi-Language - Japanese, English, Traditional Chinese
✅ Safe Updates - Interactive prompts with backup options

📝 Related Articles
Kiroの仕様書駆動開発プロセスをClaude Codeで徹底的に再現した - Zenn Article (Japanese)

🎯 Presentations
Claude Codeは仕様駆動の夢を見ない - Speaker Deck Presentation (Japanese)

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 - 日本語版ツール説明

cc-sdd/
├── tools/cc-sdd/              # Main cc-sdd NPM package
│   ├── src/                   # TypeScript source code
│   ├── templates/             # Agent templates (Claude Code, Cursor IDE, Gemini CLI, Codex CLI, GitHub Copilot, Qwen Code)
│   ├── package.json           # Package configuration
│   └── README.md              # Tool documentation
├── docs/                      # Documentation
├── .claude/                   # Example Claude Code commands
└── README.md                  # This file

MIT License