aidlc

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