| name | aidlc |
| description | AI-DLC v3（AI-Driven Development Lifecycle）のオーケストレーター。 define / develop / release / reflect の 4 フェーズコマンドと status / doctor の 補助コマンド、連続実行ラッパ express、旧名エイリアス（inception / construction / operations / retrospective）を統一的にルーティングする。 define / develop（normal / risky 含む）/ release / reflect の各フェーズフローと status / doctor の補助コマンドを実装済み（doctor は shallow scope）。 |
AI-DLC v3 オーケストレーター
AI-DLC v3 は、フェーズ進行を会話履歴の推論ではなく、リポジトリ内の state.json +
work item frontmatter への明示的な状態書き込みから導出する（RFC DG-6）。
本ファイルの位置づけ（v3.0.0-rc.1 / 本流化済み）: 本 SKILL.md は
ルーティングの骨組みである。実体の手順ファイルとして steps/define.md / steps/status.md /
steps/develop.md（tiny / normal / risky）/ steps/release.md（Step 1–4）/ steps/reflect.md（Step 0–4）/
steps/doctor.md（出力仕様 / scripts/doctor.sh が実行実装）が存在する。
doctor は shallow scope（8 領域 + parse-guard）を実装済みで、[phase] / [trace] は後続バージョンへ defer する。
起動表面は /aidlc（v3.0.0-rc.1 で本流化 = 旧 skills/aidlc-v3 を skills/aidlc へ置換済み）。
旧 v2 実装は v2-maintenance branch に保全されている。
コマンド体系
フェーズコマンド
define / develop / release は状態を進行させ承認ゲートを持つ。reflect は例外で、状態を変更せず
（state.json 非変更）明示の承認ゲートを持たない（任意実行 / 人間関与は Step 2 KPT 編集・Step 3 Issue 化確認）。
| コマンド | 責務 | 旧フェーズ | 実体 |
|---|
define | 目的・スコープ・完了条件・作業単位（work item）を決める | Inception | steps/define.md |
develop | 次の work item を実装・検証・完了する（1 実行 = 1 work item） | Construction | steps/develop.md（tiny / normal / risky） |
release | main に安全に取り込む（PR 整備・merge） | Operations | steps/release.md（Step 1–4） |
reflect | 振り返り、改善 Issue を作る（任意実行 / state 非変更・ゲートなし） | Retrospective | steps/reflect.md（Step 0–4） |
補助コマンド（状態を変更しない）
| コマンド | 責務 | 実体 |
|---|
status | state.json + frontmatter からフェーズを導出し現在地・次アクションを表示（読み取り専用） | steps/status.md |
doctor | config / state / cycle / work-items / git / gh / pr / scripts / parse-guard の問題を診断（自動修正しない） | steps/doctor.md + scripts/doctor.sh（shallow scope。[phase] / [trace] は後続バージョンへ defer） |
コマンド名規約（RFC DG-1）
- Construction 相当のコマンド名は
develop で確定する。build / implement は
採用せず、エイリアスにもしない（build は compile を連想させるため不採用）。
旧名エイリアス（後方互換 / RFC DG-1）
旧フルネームのみを後方互換エイリアスとして維持する。
| 旧名 | v3 コマンド |
|---|
inception | define |
construction | develop |
operations | release |
retrospective | reflect |
不採用動詞（build / implement 等）はエイリアスに含めない。
express（連続実行ラッパ）
express は独立コマンドではなく、フェーズコマンドの連続実行ラッパである。
- define で生成される work item が 1 つ（
tiny または normal）の場合のみ、
define → develop → release を連続実行する。
- work item が 複数になった場合は define 完了後に終了し、
develop / release
を個別実行するよう案内する。
risky work item を含む場合は連続実行しない（承認・レビューの厚みが必要なため
個別実行へ案内）。
引数なし実行のルーティング
/aidlc（引数なし）は state.json + work item frontmatter からフェーズを導出し、
対応するフェーズコマンドへ自動ルーティングする。
/aidlc（引数なし）
├─ state.json 不在 → define
└─ state.json 存在 → フェーズ導出（正本: docs/v3/data-model.md §5）
├─ define 未完了 → define
├─ work item 残あり → develop
├─ 全 work item 完了 → release
└─ merged + 承認済 → reflect（任意）
フェーズ導出ロジックの正本（SoT）は docs/v3/data-model.md §5。本 SKILL.md は
導出結果を参照してルーティングを記述し、導出規則そのものを再定義しない（上図は
非規範サマリであり、評価順序・complete 最優先などの正確な規則は data-model §5 を参照）。
コアルール参照
v3 の共通開発ルール（コミット規約・レビューフロー・終了コード規約等）への参照ポイント。
- レビューの処理パス選択・フォールバック:
steps/common/review-routing.md
- 反復レビュー・指摘対応・Defer・機密マスク:
steps/common/review-flow.md
- 終了コード規約:
guides/exit-code-convention.md
- Bash ツール安全パターン:
steps/common/bash-tool-safety.md（規約 SoT はリポジトリルート CLAUDE.md）
パス解決
scripts/ / templates/ / steps/ で始まるパスは、本 SKILL.md と同じスキルベース
ディレクトリからの相対パスとして解決する（例: scripts/state-read.sh、
templates/work-item.md、steps/define.md）。step ファイルからの単純相対参照
（steps/templates/... のような解釈）は行わない。
scripts/: state-read.sh / state-write.sh / state-validate.sh / state-init.sh（state.json 操作）/ work-item-next.sh（選定）/ work-item-validate.sh（work item 検証）/ work-item-status.sh（work item frontmatter status の read / 遷移）/ lib/frontmatter.sh（frontmatter パース安全境界）/ doctor.sh（環境診断 / 9 領域）/ read-config.sh（config.toml 読取の公開 API）templates/: intent.md / work-item.md / journal.md / release.md / reflect.md / design.md（成果物テンプレート）steps/: define.md / status.md / develop.md / release.md / reflect.md / doctor.md
