CCSDD（cc-sdd）ガイド¶

概要¶

Spec-Driven Development for Claude Code — AIコーディングエージェントに「仕様ファースト」のワークフローを強制するNPMツール。 要件定義 → 設計 → タスク分解 → 実装という構造化された開発フローを、スラッシュコマンドで実現する。

• リポジトリ: ShortArrow/ccsdd / gotalab/cc-sdd
• ライセンス: MIT

インストール¶

# 日本語・Windows向け
npx cc-sdd@latest --lang ja

# オプション
npx cc-sdd@latest --dry-run          # プレビューのみ
npx cc-sdd@latest --backup           # バックアップ付き更新
npx cc-sdd@latest --kiro-dir docs    # 仕様書ディレクトリを変更

インストールされるファイル¶

コマンド一覧¶

メインワークフロー¶

検証・確認¶

開発フロー¶

1. /kiro:steering            → プロジェクトの現状を把握・記録
2. /kiro:spec-init "XXX機能"  → 仕様の初期化
3. /kiro:spec-requirements    → 要件定義（★人間の承認）
4. /kiro:spec-design          → 技術設計（★人間の承認）
5. /kiro:spec-tasks           → タスク分解（★人間の承認）
6. /kiro:spec-impl            → 実装開始
7. /kiro:validate-impl        → 実装の検証

各フェーズで 人間の承認ゲート があり、AIが暴走しない仕組み。

ユースケース¶

1. 新機能の開発¶

「ユーザー認証を追加したい」→ 仕様から設計、タスク分解まで体系的に進められる。

2. 既存プロジェクトへの機能追加¶

/kiro:steering で既存コードを学習してから設計に入ることで、既存パターンとの整合性を保てる。

3. チーム開発の標準化¶

テンプレートを統一し、誰が使っても同じ品質の仕様書が出力される。

4. 複雑な機能の分解¶

大きな機能をタスクに分解し、依存関係を可視化。並列作業が可能なタスクも識別できる。

5. 品質担保¶

validate-gap / validate-design / validate-impl で各段階の品質を検証できる。

ベストプラクティス¶

1. まず steering を実行 — 既存プロジェクトでは必須。コードベースのパターン・規約をAIに学習させる
2. 各フェーズの承認を省略しない — 要件→設計→タスクの各段階で人間がレビューすることで手戻りを防ぐ
3. テンプレートをカスタマイズ — .kiro/settings/templates/ を自分のプロジェクトに合わせて編集する
4. steering-custom を活用 — API規約、認証方式、テスト方針など、プロジェクト固有のルールを文書化する
5. 小さく始める — 最初は小さな機能で試して、ワークフローに慣れてから大きな機能に使う
6. 仕様書をGit管理する — .kiro/ ディレクトリをコミットし、仕様の変遷を追跡する

カスタマイズ¶

テンプレートの編集¶

.kiro/settings/templates/ 配下のファイルを編集して、プロジェクトに合った仕様書フォーマットにできる。

steering-customのテーマ例¶