cdd-cli
Commitment-Driven Development (CDD) - 決断を記録しながら開発する
CDDは、決断を最小単位とし、プロジェクトにおける意思決定を残しながら開発を進めていく手法です。
ADR、SDDなどの文脈を引き継ぎつつ、CDDは人間の理解に重点を置き、人間とAIとの役割分担の可能性を探る目的で作られました。
基本的な使い方
CDDでは、cdd.mdというファイルを中心に開発を進めます。
cdd.mdには、決定事項だけでなく、そこに至るまでの文脈（なぜその決断をしたのか、何を却下したのか）を記述します。
ワークフロー:
1. AIといつものように会話をしながらcdd.mdを完成させる
2. 決断が固まったら実装を開始
3. 実装後、cdd.mdに基づいてレビュー
cdd-cliは、このワークフローを支援するCLIツールです。
Installation
``bash
npm install -g cdd-cli
`
Getting Started
$3
`bash
cdd init
`
これにより、.cdd-manifest.json が作成され、プロジェクトがCDDに対応します。
$3
`bash
cdd new AUTH-001 "ユーザー認証の実装方針"
`
CDD/tasks/01-user-auth.cdd.md が作成されます。
$3
Claude CodeまたはCodex CLIで /cdd-discuss Skillを使用します。
`
/cdd-discuss AUTH-001
AIが対話を通じてcdd.mdを完成させます。
$3
決断が [DECIDED] になったら実装を開始します。
`
/cdd-implement AUTH-001
$3
実装が完了したら、cdd.mdに基づいてレビューします。
`
/cdd-review AUTH-001
$3
`bash
ステータス一覧
cdd status
ツリー表示
cdd tree
レビュー待ちの実装を表示
cdd status --in-review
`
cdd.mdの例
`
yaml
---
id: FEATURE-001
title: ユーザー認証の実装方針
decisionStatus: DECIDED
implementationStatus: DONE
metadata:
assignee: yourname
created: '2026-01-23'
---Goal
ユーザー認証機能を実装し、セキュアなログイン体験を提供するContext
- 既存システムはセッションベース認証
- モバイルアプリ対応が必要
- セキュリティ要件: XSS/CSRF対策必須
- パフォーマンス要件: 認証処理は100ms以内Selection
JWT（JSON Web Token）ベースの認証を採用理由:
- ステートレスでスケーラブル
- モバイルアプリとの親和性が高い
- リフレッシュトークンで安全性を確保
実装方針:
- アクセストークン: 15分有効期限
- リフレッシュトークン: 7日有効期限、HTTP-only Cookie
- トークン検証はミドルウェアで一元管理
APIシグネチャ:
`
typescript
// POST /api/auth/login
interface LoginRequest {
email: string
password: string
}
interface LoginResponse {
accessToken: string
user: { id: string; email: string }
}// POST /api/auth/refresh
interface RefreshResponse {
accessToken: string
}
`
テスト戦略:
- ユニットテスト: トークン生成・検証ロジック
- 統合テスト: ログイン・リフレッシュフロー
- セキュリティテスト: 無効トークン、期限切れトークンの拒否
Rejections
$3
- モバイルアプリで複雑になる
- サーバー側の状態管理が必要
- スケーリング時の課題$3
- 過剰に複雑
- 自社システム内での認証には不要
- 学習コストが高い
`
このように、cdd.mdには決断の背景、理由、却下した案、APIシグネチャ、テスト戦略などを記述します。
これにより、AIと人間が共通の文脈を持ち、効率的に開発を進めることができます。
CLI Commands
| コマンド | 説明 |
|---------|------|
|
cdd init
| プロジェクトを初期化（.cdd-manifest.json作成） |
| cdd new
<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 新しい決断ドキュメントを作成 |<br />| </code>cdd status<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 全ての決断のステータスを一覧表示 |<br />| </code>cdd status --detailed<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 詳細なファイル一覧表示 |<br />| </code>cdd status --decision <status><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | Decision Statusでフィルタ |<br />| </code>cdd status --implementation <status><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | Implementation Statusでフィルタ |<br />| </code>cdd status --doc-unsynced<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | DONE かつドキュメント未同期の決断を表示 |<br />| </code>cdd status --in-review<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | IN_REVIEW の実装を表示 |<br />| </code>cdd tree<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 決断の親子関係をツリー表示 |<br />| </code>cdd validate<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 全てのcdd.mdをバリデーション |<br />| </code>cdd archive<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 完了した決断（DECIDED + DONE）をアーカイブ |</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Skills（AIエージェント用）</h2></p><p class="my-3">| Skill | 説明 |<br />|---------|------|<br />| </code>/cdd-discuss [id]<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 決断の議論・記録 |<br />| </code>/cdd-implement <id><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 決断の実装 |<br />| </code>/cdd-review <id><code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | 実装のレビュー |<br />| </code>/cdd-doc-update<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> | DONE決断のドキュメント同期 |</p><p class="my-3">これらのSkillsは、</code>cdd init<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> 実行時に選択したプラットフォームに自動配置されます。</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">対応プラットフォーム</h2></p><p class="my-3">- <strong>Claude Code</strong> (</code>.claude/skills/<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) - Anthropic<br />- <strong>Codex CLI</strong> (</code>.codex/skills/<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">) - OpenAI</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">AIプラットフォームのセットアップ</h2></p><p class="my-3"></code>cdd init<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> を実行すると、</code>CDD/PROMPT.md<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> ファイルが生成されます。<br />このファイルには、AIがCDDワークフローを理解するための情報が含まれています。</p><p class="my-3">各AIプラットフォームの設定ファイルに以下を追加してください：</p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>.claude/CLAUDE.md<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> に追加:</p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">markdown<br /><h2 class="text-xl font-semibold mt-5 mb-3">CDD Workflow</h2></p><p class="my-3">Read and follow: CDD/PROMPT.md<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3"><h3 class="text-lg font-medium mt-4 mb-2">$3</h3></p><p class="my-3"></code>AGENTS.md<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"> に追加:</p><p class="my-3"></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono">markdown<br /><h2 class="text-xl font-semibold mt-5 mb-3">CDD Workflow</h2></p><p class="my-3">Read and follow: CDD/PROMPT.md<br /></code>`<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"></p><p class="my-3">これにより、AIがCDDの開発プロセスを理解し、適切にサポートできるようになります。</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">ドキュメント</h2></p><p class="my-3">詳細なガイドは以下を参照してください:</p><p class="my-3">- <strong>フォーマットと書き方</strong>: </code>CDD/GUIDE.md<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />- <strong>ワークフローと運用ルール</strong>: </code>CDD/WORKFLOW.md<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />- <strong>ファイル配置と粒度</strong>: </code>CDD/STRUCTURE.md<code class="bg-muted px-1 py-0.5 rounded text-sm font-mono"><br />- <strong>例</strong>: </code>CDD/00-example.cdd.md`</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">License</h2></p><p class="my-3">MIT</p><p class="my-3"><h2 class="text-xl font-semibold mt-5 mb-3">Links</h2></p><p class="my-3">- GitHub: https://github.com/yourusername/cdd-cli<br />- Issues: https://github.com/yourusername/cdd-cli/issues<br /></p></div><div class="flex justify-center absolute inset-x-0 bottom-0 bg-gradient-to-t from-background via-background to-transparent pb-4 pt-16"><button data-slot="button" class="inline-flex items-center justify-center whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down mr-1 h-4 w-4"><path d="m6 9 6 6 6-6"></path></svg>Show more</button></div></div></div><template id="P:3"></template><template id="P:4"></template></div></div></div><script>self.__next_f.push([1,"26:[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}]\n27:[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^3.3.2\"}]\n28:[\"$\",\"$L5\",\"gray-matter\",{\"href\":\"/package/gray-matter\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"gray-matter\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^4.0.3\"}]]}]\n29:[\"$\",\"$L5\",\"markdown-it\",{\"href\":\"/package/markdown-it\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"markdown-it\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^14.0.0\"}]]}]\n2a:[\"$\",\"$L5\",\"prompts\",{\"href\":\"/package/prompts\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"prompts\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^2.4.2\"}]]}]\n"])</script><script>self.__next_f.push([1,"2b:[\"$\",\"div\",null,{\"data-slot\":\"card\",\"className\":\"bg-card text-card-foreground flex flex-col gap-6 rounded-xl border shadow-sm py-4 lg:col-span-2\",\"children\":[[\"$\",\"div\",null,{\"data-slot\":\"card-header\",\"className\":\"@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-2 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6 pb-2\",\"children\":[\"$\",\"div\",null,{\"data-slot\":\"card-title\",\"className\":\"font-semibold flex items-center gap-2 text-base\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-wrench h-4 w-4\",\"children\":[[\"$\",\"path\",\"cbrjhi\",{\"d\":\"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z\"}],\"$undefined\"]}],\"Dev Dependencies\",[\"$\",\"span\",null,{\"data-slot\":\"badge\",\"className\":\"inline-flex items-center justify-center rounded-md border px-2 py-0.5 font-medium w-fit whitespace-nowrap shrink-0 [\u0026\u003esvg]:size-3 gap-1 [\u0026\u003esvg]:pointer-events-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive transition-[color,box-shadow] overflow-hidden border-transparent bg-secondary text-secondary-foreground [a\u0026]:hover:bg-secondary/90 ml-auto text-xs\",\"children\":4}]]}]}],[\"$\",\"div\",null,{\"data-slot\":\"card-content\",\"className\":\"px-6\",\"children\":[\"$\",\"div\",null,{\"className\":\"grid gap-1 sm:grid-cols-2 lg:grid-cols-3\",\"children\":[[\"$\",\"$L5\",\"@types/node\",{\"href\":\"/package/%40types%2Fnode\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"@types/node\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^20.11.5\"}]]}],[\"$\",\"$L5\",\"tsup\",{\"href\":\"/package/tsup\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"tsup\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^8.0.1\"}]]}],[\"$\",\"$L5\",\"typescript\",{\"href\":\"/package/typescript\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[\"$L2d\",\"$undefined\"]}],\"typescript\"]}],\"$L2e\"]}],\"$L2f\"]}]}]]}]\n"])</script><script>self.__next_f.push([1,"2d:[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}]\n2e:[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^5.3.3\"}]\n2f:[\"$\",\"$L5\",\"vitest\",{\"href\":\"/package/vitest\",\"className\":\"group flex items-center justify-between rounded-md px-2 py-1.5 text-sm transition-colors hover:bg-accent\",\"children\":[[\"$\",\"span\",null,{\"className\":\"flex items-center gap-1.5 truncate font-mono text-foreground\",\"children\":[[\"$\",\"svg\",null,{\"ref\":\"$undefined\",\"xmlns\":\"http://www.w3.org/2000/svg\",\"width\":24,\"height\":24,\"viewBox\":\"0 0 24 24\",\"fill\":\"none\",\"stroke\":\"currentColor\",\"strokeWidth\":2,\"strokeLinecap\":\"round\",\"strokeLinejoin\":\"round\",\"className\":\"lucide lucide-chevron-right h-3 w-3 text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100\",\"children\":[[\"$\",\"path\",\"mthhwq\",{\"d\":\"m9 18 6-6-6-6\"}],\"$undefined\"]}],\"vitest\"]}],[\"$\",\"span\",null,{\"className\":\"ml-2 shrink-0 font-mono text-xs text-muted-foreground\",\"children\":\"^1.2.0\"}]]}]\n"])</script><div hidden id="S:3"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-dependencies" hidden="" id="radix-_R_aav5ubrb_-content-dependencies" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS=function(a,b){a=document.getElementById(a);b=document.getElementById(b);for(a.parentNode.removeChild(a);a.firstChild;)b.parentNode.insertBefore(a.firstChild,b);b.parentNode.removeChild(b)};$RS("S:3","P:3")</script><div hidden id="S:4"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-versions" hidden="" id="radix-_R_aav5ubrb_-content-versions" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS("S:4","P:4")</script><script>$RC("B:1","S:1")</script></body></html>