CDD（Conversation-Driven Development）

AIとの会話で生まれた文脈を失わずに実装フェーズへ引き渡すための開発スタイル

CDDとは

CDD（Conversation-Driven Development）は、AIとの対話を通じて生まれたアイデアや決定事項を、実装フェーズへ確実に引き渡すための開発手法です。

従来のAI支援開発では、会話の中で決めたことが実装時に失われたり、「なぜその実装なのか」が分からなくなる問題がありました。CDDはこの問題を解決するため、会話 → 構造化 → 実装 を明示的に分離します。

インストール

npx @basio0916/cdd

対話形式でAIエージェントとインストール先を選択できます。

対応AIエージェント

| エージェント | ローカル | グローバル | コマンド | |------------|:--------:|:----------:|-----------| | Claude Code | ✅ | ✅ | cdd:verify など | | OpenAI Codex | - | ✅ | cdd-verify など | | GitHub Copilot | ✅ | - | cdd-verify.prompt など | | Cursor | ✅ | ✅ | cdd-verify など | | Windsurf | ✅ | ✅ | cdd-verify など |

インストール先ディレクトリ

• Claude Code: .claude/commands/cdd/ (ローカル) or ~/.claude/commands/cdd/ (グローバル)
• OpenAI Codex: ~/.codex/prompts/ (グローバルのみ)
• GitHub Copilot: .github/prompts/ (ローカルのみ)
• Cursor: .cursor/commands/ (ローカル) or ~/.cursor/commands/ (グローバル)
• Windsurf: .windsurf/rules/ (ローカル) or ~/.codeium/windsurf/global_workflows/ (グローバル)

CDDの全体像（3つのLane）

CDDは3つのLaneで構成されています。

1. Idea Lane（思考・壁打ち）

アイデア出しや要件検討を行うフェーズです。

• 目的: アイデア出し・要件検討・制約や代替案の議論
• 使用AI: ChatGPT / Claude / Gemini など自由
• 特徴:
  • 迷ってOK
  • 未確定事項が残ってOK
  • 人間が納得するまで考えるフェーズ

2. Context Lane（文脈整理）

会話ログを実装向けに翻訳・確定するフェーズです。

• 目的: 会話ログから前提・判断・決定事項を抽出し、実装可能な形に整理
• 使用AI: Idea Laneで使用したAI
• 成果物: handoff.yml（Handoff Pack v1）

Idea Laneで会話したチャット内で、prompts/context-lane.mdのプロンプトを実行することでHandoff Pack v1を作成できます。 未確定事項が残っている場合は、質問が返されるので、それに答えることでHandoff Pack v1を作成できます。

3. Code Lane（実装）

handoff.yml を前提にコードを書くフェーズです。

• 目的: 構造化された要件に基づいて実装を行う
• 使用AI: Claude Code / Cursor など
• 前提: handoff.yml に記載された内容のみを実装の根拠とする

Code Laneの実装手法

事前準備：handoff.ymlの検証

handoff.ymlはコードベースの情報を知らないため、verifyコマンドで実装上の問題がないか検証を行います。

# Claude Codeの場合
/cdd:verify
<Handoff Pack v1を貼り付ける>

検証が完了すると、.cdd/<slug>/handoff.ymlが作成されます。

Code Laneでは、プロジェクトの規模や要件に応じて3つの実装手法から選択できます。

1. Direct Implementation

handoff.yml を前提に直接実装を行う手法です。

/cdd:impl-direct <slug>

• 適用場面: 小〜中規模の実装、修正範囲が明確なケース
• 特徴:
  • Intent Snapshot → Mini Plan → Implement → Verify の流れ
  • シンプルで素早く実装を開始できる

2. Task-Oriented Implementation（タスク分解実装）

handoff.yml からタスクを分解し、1つずつ実装を進める手法です。

# タスク分解
/cdd:tasks <slug>

# 実装（タスク単位 or フェーズ単位）
/cdd:impl <slug> <task_id>    # 例: /cdd:impl user-auth 1-1
/cdd:impl <slug> <phase_id>   # 例: /cdd:impl user-auth 1

• 適用場面: 大規模実装、影響範囲が広い機能、段階的に進めたい場合
• 特徴:
  • Phase（2〜5個）とTask（1〜4時間粒度）に分解
  • 進捗を tasks.yaml で追跡可能
  • 依存関係を考慮した実装順序

3. CDD-SDD Hybrid（仕様駆動開発連携）

cc-sdd（Spec-Driven Development）と連携し、より厳密な仕様駆動開発のプロセスで開発を進める手法です。 cc-sddでkiro:spec-initを実行した後に下記コマンドを実行します。

/cdd:cc-sdd <cdd:slug> <cc-sdd:slug>

その後、cc-sddでkiro:spec-requirementsを実行し、requirements.mdのフォーマットに揃えます。

• 適用場面: 厳密な仕様駆動開発のプロセスやドキュメント生成を重視する場合
• 特徴:
  • handoff.yml から cc-sdd の requirements.md を生成
  • 要件定義 → 設計 → 実装まで一貫したプロセス

ライセンス

MIT License

貢献

Issue や Pull Request を歓迎します。

• Issues
• Repository