AI-DLC 2.11.0 はコード生成前に Codex CLI のワークフローを止め、開発者が提案された計画を読んで承認できるようにします。このガイドは、2026 年 10 月 8 日の v2.11.0 リリースと、そのバージョンに対応するCodex CLI、ワークフロープロファイル、Plan Approvalの手順に従っています。BIG CHANGE はこれらの文書と、タグ付きバージョンのコマンドリファレンスを確認しました。AI-DLC のインストールも実行もしていません。以下のすべての手順は文書のみに基づいています。

想定読者は、Git プロジェクトを持ち、AI コーディングアシスタントがファイルを生成する前にコード計画を確認したい開発者です。期待する結果は、計画を明示し、開発者が変更を求められ、回答するまでビルドを待機させる Plan Approval の質問が表示されることです。AI-DLC には後続の確認もありますが、このゲートはコード計画を対象としています。

始める前に

タグ付きバージョンのCodex ガイドでは、Codex CLI 0.145.0 以降、プロジェクトフック用の Git リポジトリ、設定済みのモデルプロバイダーが必要です。ネイティブ版 AI-DLC には Bun も Node.js も不要です。コードと計画を設定済みのモデルプロバイダーに送信する権限のあるプロジェクトを使用してください。プロバイダーのデータ処理条件と課金条件は別途確認してください。AI-DLC リポジトリには、このワークフローについて一律のプロバイダー利用料金は記載されていません。

入力として具体的な開発タスクを用意します。この手順では、Featureプロファイルを選びます。v2.11.0 の文書では Feature の Plan Approval が有効とされているためです。ExpressとProof of conceptでは最初は Plan Approval が無効ですが、特定の計画のレビューを人が求めることはできます。すべての AI-DLC 実行が停止するという一般的な期待よりも、プロファイルの選択が重要です。

1. 固定したリリースをインストールして確認する

macOS、Linux、WSL 向けに、v2.11.0 リリースはこのバージョン専用のインストーラーコマンドを提示しています。

Terminal
curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/download/v2.11.0/install.sh | sh -s -- --version 2.11.0

このリリースには PowerShell 用のバージョン専用 Windows インストーラーもあります。実行前にインストーラーを確認し、自分のマシンに合う方法を選んでください。その後、プロジェクトからインストール済みバージョンと環境を確認します。

Terminal
aidlc --version
aidlc doctor
codex --version

まず aidlc --version が 2.11.0 を示すことを確認します。aidlc doctor は設定やランタイムの問題を報告し、codex --version では Codex CLI の最低バージョン要件を確認できます。インストール済みのバージョンが異なる場合はここで止まり、v2.11.0 リリースのインストールまたは更新手順を使ってください。以下の手順はこのリリースに固定しています。

2. Codex を設定してプロジェクトフックを信頼する

Git プロジェクトのルートから、タグ付きバージョンの Codex 設定手順を使います。

Terminal
aidlc config --harness codex
aidlc doctor
codex

Codex はプロジェクトフックを信頼するか尋ねます。プロジェクトと生成されたフックを確認してから、Trust all and continue（すべて信頼して続行）を選んでください。タグ付きガイドによると、閉じたダイアログは次のコマンドで開き直せます。/hooks、次に t、そして Esc を押します。信頼を設定した後、Codex で $aidlc --doctor を実行します。フックが動いていない場合は、ハーネスガイドの信頼回復手順に従ってください。インストーラーの成功だけではプロジェクトフックが有効であるとは確認できません。モデルプロバイダーとその認証情報は Codex のユーザーレベルの設定で構成し、AI-DLC が提供するものではありません。

3. Feature ワークフローを開始して設定を確認する

最初に Codex で $aidlc --status を実行し、アクティブなワークフローがないことを確認します。タグ付きバージョンのコマンドリファレンスによると、ワークフローがアクティブな場合、スコープコマンドだけを入力すると既存の作業を続けます。この手順ではアクティブなワークフローのないプロジェクトを使ってください。

設定済みの Codex プロジェクトで $aidlc feature と入力し、作成したいタスクについての問いに答えます。入力では機能とその制約を説明してください。最終的な計画はその作業から生成されます。コード計画の作成前に、v2.11.0 のコマンドリファレンスを使って実際に適用される制御を確認します。

Text
$aidlc --status
$aidlc config get plan-approval
$aidlc config get guard-policy

Plan Approval の on（有効）と、その設定元を確認します。このインテントで無効なら、$aidlc --plan-approval on で次の計画に対する質問を有効にします。マシンレベルのスイッチで強制的に無効にすることも、チームメモリーのルールで有効を必須にすることもできます。ステータス行には実際の値が表示されます。この手順で、承認済みの計画やそのテスト手順を編集した際にも再承認を必須にしたい場合は、次のコマンドで Guard Policy を strict にします。$aidlc --guard-policy strict。Plan Approval の有効化は最初の質問を制御し、Guard Policy は承認済みの計画が変更された後の動作を制御します。

4. ゲートでコード計画を確認する

Code Generation の計画ができるまでワークフローを進めます。Plan Approval が有効なら、v2.11.0 エンジンは計画の要約とパスを示し、次の選択肢を提示します。Approve Plan（計画を承認）、Request Changes（変更を要求）、またはI'll edit the files（自分でファイルを編集）。指定された code-generation-plan.md を開き、提案されたファイル、順序、テスト手順を読んでください。承認前に、すべてのコマンド、プロジェクトデータへのアクセス、リポジトリを変更する可能性のある操作を確認します。

別の実装やテストが必要なら、Request Changes（変更を要求）を選びます。自分でファイルを編集する場合は、編集したことを承認とはみなさず、エンジンのI'll edit the files（自分でファイルを編集）の手順を使ってください。計画を許可するのはあなたの回答だけであり、モデルが代わりに承認することはできません。ゲートが有効な場合、コード生成はその回答を待ちます。リリースノートによると、ビルドが待機中でも、レビュー、設定、コミット、その他の許可された要求は進められます。

5. 承認して記録を確認し、計画変更に対応する

計画に問題がなければ、開いている質問でApprove Plan（計画を承認）と答えます。エンジンはその計画に対する承認を記録し、通常の next の流れでビルドを再開します。リリースノートによると、変更のない承認済み計画は、チャットのコンテキスト圧縮や保留をまたいで保持されます。タグ付きバージョンのコマンドリファレンスには、記録された時系列を調べるための読み取り専用コマンド aidlc engine audit history が記載されています。また、$aidlc --status はワークフローの位置を示します。これらの記録と、コード生成前にゲートが目に見える形で表示されることを合わせて、成功を確認します。

ビルド前に計画やそのテスト手順が変わると、strict の Guard Policy は再承認を求めます。relaxed または off では変更を報告して記録しますが、新たな必須承認なしでワークフローを続けられます。タグ付き文書では、承認後に無関係なソースファイルが変わる場合も区別しています。その変更は報告されますが、計画の承認は引き続き計画とテスト手順を対象とします。人が「承認済みの計画に戻る」と指示すれば、ビルド前に以前の計画を復元できます。計画が変わっていないのに、チャットが圧縮されたという理由だけで再び質問されるべきではありません。

停止しない場合

最初に $aidlc --status と $aidlc config get plan-approval を確認します。選択したスコープ、実際の設定とその設定元を調べてください。Express と Proof of concept はデフォルトで無効です。そのインテントで Plan Approval を有効にするか、全ライフサイクルがタスクに適するなら Feature ワークフローを開始します。設定やフックに問題がありそうなら、aidlc doctor を実行し、Codex ハーネスの回復手順に従ってください。アクティブなプロジェクトのランタイムを変える前に、バージョンの不一致を確認します。質問がないことを、承認が記録された証拠だと考えてはいけません。設定が無効な場合、AI-DLC は PLAN_APPROVAL_SKIPPED という行を記録します。タグ付き文書では、これを人による承認と明確に区別しています。

大きな変化

  • AI-DLC 2.11.0 は計画の質問をエンジンに組み込みます。エンジンが判断を記録し、セッションの保留やコンテキスト圧縮をまたいでも、変更のない承認済み計画を保持します。
  • Codex CLI の Feature 実行では、開発者は Plan Approval の実際の設定を確認し、コード生成前に計画を読み、ゲートで変更を求められます。
  • 計画編集後の再承認は Guard Policy に依存します。計画やテスト手順が変わったときに再び止めるには、開発者は strict を選べます。

出典と参考資料