autodev

/autodev

/autodev は、自律開発に関するリポジトリローカルの運用契約を管理します。 evolve や rpi を置き換えるものではありません。

ループ内での位置づけ

運用ループ が各ティックで読み取る設定／意図レイヤーであり、ループそのものではありません。/autodev は、PROGRAM.md／AUTODEV.md で宣言された契約（変更可能な範囲、変更不可の範囲、検証コマンド、エスカレーションルール、停止条件）を定義し、検証します。ドライバー（evolve とデーモンである Factory）がその契約を使用してループを実行します。autodev はループを実行しません。自律実行中もループの規律は適用されます。有効性チェックなしに並行ウェーブを実行しないこと。Given/When/Then に対応する合格済みテストなしにスライスを完了しないこと。キャプチャはプロモーションラチェットを通じて行い、廃棄場に放置しないこと。

• PROGRAM.md または AUTODEV.md が、契約（変更可能な範囲、変更不可の範囲、実験単位、検証コマンド、判断ポリシー、エスカレーションルール、停止条件）を定義します。
• ao autodev は、その契約を作成、確認、検証します。
• evolve は v2 の自律的な改善ループを実行します。
• 運用ループは、調査 -> 計画 -> 実装 -> 検証のライフサイクルを1回実行します。

振り分け

Claude Code では、/autodev はスキル呼び出しとして /evolve または /rpi に作業を引き継ぎます。ターミナル用ラッパーは人間やスキル非対応のランタイム向けに引き続き利用できますが、スキル間の引き継ぎにおけるデフォルトではありません。

ユーザーが、従来の evolve フローを新しいコマンドまたはスキルにするべきか尋ねた場合は、次のように使い分けます。

意図	対応
リポジトリローカルの自律ポリシーを定義または修復する	/autodev と ao autodev を使用します
自律的な改善ループを実行する	/evolve を呼び出します
範囲を限定したライフサイクルを1回実行する	/rpi を呼び出します

PROGRAM.md は AUTODEV.md より優先されます。AUTODEV.md は互換性のための別名として扱ってください。

実行手順

ステップ 1：契約を検出する

if [ -f PROGRAM.md ]; then
  PROGRAM_PATH=PROGRAM.md
elif [ -f AUTODEV.md ]; then
  PROGRAM_PATH=AUTODEV.md
else
  PROGRAM_PATH=
fi

契約が存在する場合は、使用する前に検証します。

ao autodev validate --json ${PROGRAM_PATH:+--file "$PROGRAM_PATH"}

契約が存在せず、ユーザーからループの初期化または定義を依頼された場合は、作成します。

ao autodev init "<objective>"

明確であれば、ユーザーの依頼から目標を推定します。リポジトリのコンテキストから目標を特定できず、それを推測すると契約が誤解を招くものになる場合に限り、質問してください。

ステップ 2：検証失敗を修正または説明する

検証に失敗した場合、不足しているフィールドを確認し、契約の作成または修正をユーザーから依頼されていれば、プログラムファイルを修正します。必須セクションは次のとおりです。

• Objective
• Mutable Scope
• Immutable Scope
• Experiment Unit
• Validation Commands
• Decision Policy
• Escalation Rules
• Stop Conditions

変更可能な範囲は狭くし、検証コマンドは具体的にすることを優先してください。必要な作業が変更不可の範囲に及ぶ場合、契約の範囲を黙って広げるのではなく、bead を作成または更新します。

ステップ 3：ループに引き継ぐ

ao autodev validate が合格した後は、次のようにします。

• ライフサイクルを1回実行する場合は、セッション内で運用ループを実行します。ループをセッション外で実行する必要がある場合は、NTM／Agent Mail または ao agent を使用します。
• 自律ループを繰り返し実行する場合は、/evolve を呼び出すか（スキル駆動）、セッション外での実行には NTM 経由でディスパッチします。
• PROGRAM.md と GOALS.md の両方が存在する場合、GOALS.md は戦略的な適合性を定め、PROGRAM.md は運用上の実行レイヤーとなります。

メインのテストに合格したというだけで、自律サイクルを成功と判定しないでください。プログラムの検証バンドルと停止条件も満たす必要があります。

例

User: turn this postmortem/analyze/plan/pre-mortem/implement/validate loop into
a v2 command.
Agent: Explain that `evolve` runs the loop, then create or validate
`PROGRAM.md` with `/autodev` so the loop has explicit scope and gates.

ao autodev init "Continuously improve AgentOps skills within explicit scope."
ao autodev validate
# then run the repeated loop: /evolve (skill-driven; /evolve CLI retired, ag-llni)

トラブルシューティング

問題	対応
PROGRAM.md not found	セットアップを依頼された場合は、ao autodev init "<objective>" を実行します。
検証で不足しているセクションが報告される	不足している必須セクションを修正してから、ao autodev validate --json を再実行します。
依頼された作業が変更不可の範囲外である	直接編集を中止し、bead を作成するか、契約の明示的な変更を依頼します。
ユーザーから「これは evolve ですか？」と尋ねられる	autodev はループの契約を定義し、evolve はループを実行すると回答します。

参考ドキュメント

• references/autodev.feature — 実行可能な仕様：契約で制約された無人ループ、進化／RPIを置き換えるのではなく管理する、自律性のもとでのループ規律（soc-qk4b）
• references/autodev-cli.feature — 実行可能な仕様：ao autodev CLI コマンドの動作、cmd テストとの連携（soc-jnfgi）