AI-DLC Starter Kit
AI-DLC (AI-Driven Development Lifecycle) を使った開発をすぐに始められるスターターキット
概要
このリポジトリには、AWS が提唱する AI-DLC 方法論の日本語リソースと、Claude Code 向けのスキルプラグイン実装が含まれています。
- AI-DLC とは: AI を「支援ツール」ではなく、開発プロセスの「中心的な協働者」として位置づける新しいソフトウェア開発方法論
- v3 のサイクル:
define（定義）→ develop（実装）→ release（リリース）の 3 フェーズ + 任意の reflect（振り返り）
v3 について（RC）
v3.0.0-rc.1 より、/aidlc は v3 を起動します（本流化済み）。v3 は、フェーズ進行を会話履歴の推論ではなく、リポジトリ内の .aidlc/state.json + work item frontmatter から明示的に導出する新設計です。セッションを跨いでも /aidlc の実行だけで現在地から再開できます。
- v2 を使い続けたい場合: v2 実装一式は v2-maintenance ブランチに保全されています
- v2 から v3 へ移行する場合:
/aidlc-migrate が v2→v3 マイグレーション（new-cycle-only / 旧成果物は残置）を実行します
フィードバックは Issue でお寄せください。
インストール
前提条件
- Claude Code がインストール済みであること
- Git がインストール済みであること
- jq がインストール済みであること（
state.json 操作に使用）
- （推奨）dasel がインストール済みであること（設定ファイル操作に使用）
インストール手順
- Claude Code でマーケットプレイスを追加:
/plugin marketplace add ikeisuke/ai-dlc-starter-kit
- プラグインをインストール:
/plugin install aidlc@ikeisuke-ai-dlc-starter-kit
以下のスキルがまとめてインストールされます:
| スキル | 用途 |
|---|
aidlc | AI-DLC v3 オーケストレーター（メインスキル / /aidlc） |
aidlc-migrate | v2→v3 マイグレーション |
aidlc-feedback | AI-DLC へのフィードバック送信 |
reviewing-construction-plan | 計画承認前レビュー |
reviewing-construction-design | 設計レビュー |
reviewing-construction-code | コード+セキュリティレビュー |
reviewing-construction-integration | 統合レビュー |
reviewing-operations-deploy | デプロイ計画レビュー |
reviewing-operations-premerge | PRマージ前レビュー |
- 対象プロジェクトのルートに
.aidlc/config.toml を作成:
[rules.depth_level]
level = "standard" # minimal / standard / comprehensive
[rules.automation]
mode = "manual" # manual / semi_auto
すべてのキーにはデフォルト値があるため、空ファイルでも動作します。設定キーの全リファレンス（v3 終端 8 キー）は docs/configuration.md を参照してください。
/aidlc define を実行してサイクルを開始:
/aidlc define
対話形式で目的・スコープ・受け入れ基準（Intent）と work item を確定し、.aidlc/ 配下にサイクル成果物と state.json を初期化します。
v2 からの移行（v2 → v3）
v2（.aidlc/config.toml があり state.json が無い環境）からの移行は、マイグレーションスキルで自動化されています:
/aidlc-migrate
- new-cycle-only（推奨）: 旧成果物は変換せず残置し、v3 は新規サイクルから開始します
- archive-only: 残置に加えて、旧成果物の所在を示す index を生成します
- 実データ変換（best-effort）は未サポートです（選択時は書き込みなしで安全に中断します）
- v1 環境を検出した場合は書き込みを行わず、v2-maintenance ブランチでの v1→v2 移行を案内します
v2 から撤去されたスキルと v3 での代替
v3 本流化に伴い、以下の v2 スキルは配布または main から撤去されました（aidlc-retrospective は非 marketplace スキルで main からのみ撤去。実装はいずれも v2-maintenance ブランチに保全されています）:
| 撤去された v2 スキル | v3 での代替 |
|---|
/aidlc-setup | 廃止。.aidlc/config.toml を手動作成（空ファイル可 / 上記手順 3） |
/aidlc-v3 | /aidlc に統合（本流化） |
/squash-unit | 個別スキル廃止。develop フローが work item 完了時にコミットを集約 |
/write-history | 個別スキル廃止。journal.md への追記は各フェーズフローが直接実施 |
aidlc-retrospective | /aidlc reflect |
reviewing-inception-intent / -stories / -units | 個別スキル廃止。Intent / work item の確認は define の承認ゲートで実施 |
上記の代替で不足する v2 機能は v2-maintenance ブランチで継続利用できます。
v1 / v2 ブランチについて
リポジトリ構成
ai-dlc-starter-kit/
├── skills/ # Claude Code スキルプラグイン
│ ├── aidlc/ # v3 オーケストレーター（メインスキル）
│ │ ├── SKILL.md # スキル定義・コマンドルーティング
│ │ ├── steps/ # フェーズ実行手順（define / develop / release / reflect / status / doctor）
│ │ ├── scripts/ # state.json / work item 操作スクリプト
│ │ ├── templates/ # 成果物テンプレート（intent / work-item / design 等）
│ │ ├── guides/ # 補助ガイド
│ │ └── config/ # デフォルト設定
│ ├── aidlc-migrate/ # v2→v3 マイグレーション
│ ├── aidlc-feedback/ # フィードバック送信
│ ├── reviewing-common/ # レビュー共通基盤
│ ├── reviewing-construction-*/ # 実装時レビュー（plan / design / code / integration）
│ └── reviewing-operations-*/ # リリース時レビュー（deploy / premerge）
│
├── .aidlc/ # プロジェクト設定・サイクル成果物
│ ├── config.toml # プロジェクト設定
│ ├── state.json # サイクル状態（フェーズ導出の正本データ）
│ └── cycles/<cycle>/ # サイクル成果物（intent / work-items / designs / reviews / journal 等）
│
├── docs/
│ ├── v3/ # v3 設計正本（workflow / data-model / migration / rfc）
│ └── translations/ # AI-DLC ホワイトペーパーの日本語翻訳
│
└── bin/ # リポジトリ開発用スクリプト（CI チェック / GitHub Projects 連携）
クイックスタート
1. AI-DLC について学ぶ
まず、AI-DLC の概要を理解しましょう：
2. プロジェクトをセットアップ
対象プロジェクトのルートに .aidlc/config.toml を作成します（インストール手順 3 参照）。ディレクトリ構造と state.json は /aidlc define が自動生成します。
3. 開発サイクルを回す
v3 のコマンド体系:
| コマンド | 責務 | 状態変更 |
|---|
/aidlc define | 目的・スコープ・完了条件・作業単位（work item）を決める（Intent 承認ゲート） | あり |
/aidlc develop | 次の work item を 1 件実装・検証・完了する（1 実行 = 1 work item） | あり |
/aidlc release | main に安全に取り込む（PR 整備・merge） | あり |
/aidlc reflect | 振り返り・改善 Issue 起票（任意実行） | なし |
/aidlc status | 現在地と次アクションを表示（読み取り専用） | なし |
/aidlc doctor | config / state / work item / git / gh 等の問題を診断（自動修正しない） | なし |
引数なしの /aidlc は、state.json + work item frontmatter からフェーズを導出して適切なコマンドへ自動ルーティングします。迷ったら /aidlc だけで進められます。
/aidlc（引数なし）
├─ state.json 不在 → define
└─ state.json 存在 → フェーズ導出
├─ define 未完了 → define
├─ work item 残あり → develop
├─ 全 work item 完了 → release
└─ merged + 承認済 → reflect（任意）
This is the beginning of the README. Read the rest at the original. Read the full README ↗
