CLI
AI-SDD CLI

AIエージェントがスペック駆動開発（SDD）を実装するためのフレームワーク

構造化されたアプローチでAI開発ワークフローを変革します：要件 → 設計 → タスク → 実装。

前提条件

  • Node.js （最新のLTSバージョン）
  • AIコードアシスタントがインストール済み： Claude Code, Antigravity CLI (agy), Cursor, Codex CLI, GitHub Copilot, Qwen Code, Windsurf

インストール 

# ターミナルを開き、プロジェクトのルートディレクトリに移動するか、新しいディレクトリを作成します
mkdir my-new-project
cd my-new-project
npx ai-sdd --lang ja  # リストからAIコードエージェントを選択

# AIアシスタントを起動
claude  # または agy など

# 以上です！エージェントに話しかけてください：
# 退職金計算機のWebアプリの仕様を開始してください

2つのパス 

# AIエージェントを起動し、すぐにスペック駆動開発を開始
/sdd:spec-init "退職金計算機を作成"       # 仕様を開始
/sdd:spec-requirements retirement-calculator # 要件を生成
/sdd:spec-design retirement-calculator       # 設計を作成
/sdd:spec-tasks retirement-calculator        # 実装タスクに分割
/sdd:spec-impl retirement-calculator         # TDDで実行

生成される成果物

約10分で生成されるもの：

requirements.md

EARS形式の要件

design.md

Mermaidダイアグラム付きアーキテクチャ

tasks.md

依存関係付きの実装タスク

ユースケース

コマンドを実行する代わりに、AIエージェントと会話します。各フェーズの後に承認を行い、次に進みます。

あなた 「退職金計算機の仕様を始めて」
AI requirements.md を生成し、内容を確認します
あなた 「要件は問題ない — 承認する」
AI ✅ 要件を承認しました。design.md を生成中...
あなた 「設計はしっかりしている — 承認する」
AI ✅ 設計を承認しました。tasks.md に分割中...
あなた 「タスクは正しい — 承認する」
AI ✅ タスクを承認しました。TDDで実装を開始します...

コミットするファイル（としないファイル）

npx ai-sddはエージェントのツールレイヤー（.claude/、CLAUDE.md、.sdd/settings/）を構築します。仕様とステアリングファイルは、specコマンドやsteeringコマンドの実行時に別途作成されます。それらがプロジェクトの共有言語です。ツールではなく、成果物をコミットしてください。

以下の行を.gitignoreに追加してください：

# AI-SDDエージェントファイル（Claude Code—`npx ai-sdd`で再生成）
CLAUDE.md
.claude/
.sdd/settings/

各開発者が npx ai-sdd を実行して、エージェントファイルをローカルに構築します。

.sdd/specs/ と .sdd/steering/ をバージョン管理に残します。

CLAUDE.mdや.claude/commands/をコミットして、エージェントの指示やカスタムスラッシュコマンドをチームで共有することを好むチームもいます。チームに合った方法を選んでください。仕様とステアリングファイルは、spec-as-codeの監査証跡としてコミットすることを前提に設計されています。

カスタム Steering

/sdd:steering-custom は、エージェントがプロジェクトの記憶として読む .sdd/steering/ のファイルを拡張します。ほとんどのテンプレートは、コードベースの一度のスキャンからパターンを抽出します。そのうち2つは仕組みが異なり、詳しく見る価値があります。

どれも必須ではありません。 標準フロー（要件 → 設計 → タスク → 実装）は、カスタムファイルなしで動作します。これらは、標準では足りなくなったときのためのものです。

標準テンプレート（コードベースから一度だけ生成）:

api-standards testing security database error-handling authentication deployment cross-repo jira azure-devops
リビングドキュメント

Research Notes

コードからは得られない答え。

他のテンプレートは、コードのスキャンから一度だけ生成されます。これはほぼ空の状態から始まり、会話のたびに成長します — フィールドが実際に何を意味するのか、どのシステムが何をどこに書き込むのか、ステークホルダーへの回答、文書化されていない癖。実際に苦労して発見した事実を一度記録しておけば、エージェントが同じ苦労をやり直すことはありません。

エージェントに伝える 「research notes の steering を作成して」 → .sdd/steering/research-notes.md
オプトインのスタイル設定

Diagram Conventions

何が変わったかが分かる設計図。

デフォルトでは design.md の図はプレーンなMermaid（構造のみ、色なし）です。このファイルを一度追加するだけで、すべての図に意味が加わります: 新規コンポーネントは緑、変更は青、未変更はグレー、外部システムは淡い黄色で、モジュールごとのスイムレーンにグルーピングされます。

エージェントに伝える 「diagram conventions の steering を作成して」 → .sdd/steering/diagram-conventions.md

エージェントが、誰かがすでに答えた質問を繰り返すようになったら research notes を。設計レビューで変更の影響範囲を一目で示す必要が出てきたら diagram conventions を。それまでは、デフォルトが正解です。

さらに詳しく

ai-sdd.com npm i ai-sdd

AI-SDDは進化し続けています。