autoresearch

Autoresearch

Autoresearch は、非推奨となった omx autoresearch コマンドに代わる、スキルファーストの仕組みです。 測定に基づくリサーチループという有用な機能は維持していますが、直接的な CLI や tmux の起動ではなく、ネイティブフックによるステートフルなワークフローとして実行されるようになりました。

プランニング前のリサーチとの境界

リサーチの成果物そのものが、明示的なバリデーターによる検証を通過しなければならない、範囲が限定された成果物である場合に $autoresearch を使用してください。通常のプランニング前のドキュメント調査や一般的なベストプラクティスの確認には推奨しないでください。その場合は $best-practice-research を使用してください。$autoresearch をアーキテクチャのプランニングの前に意図的に実行する場合、承認された成果物は $ralplan へのエビデンスとして渡されるべきです。ユーザーが継続的なリサーチの自動化を明示的に求めない限り、最終的なアーキテクチャ/コンポーネントになるべきではありません。

使用する場合

• Ralph 風の永続的なリサーチループが必要な場合
• 明示的な検証エビデンスが存在するまで、タスクを継続的に促し続けるべき場合
• 初期化時に、スクリプトによる検証と、プロンプト+アーキテクトによる検証のどちらかを選びたい場合

使用しない場合

• 従来の omx autoresearch コマンドのインターフェース（強く非推奨）を使いたい場合
• tmux のデタッチ起動や分割ペインでの起動と同等の動作が必要な場合
• まだ検証方式を決めていない場合

中核となる契約

1. 初期化時に検証モードを選択します。 次のいずれか 1 つを必ず選んでください:
   • mission-validator-script
   • prompt-architect-artifact
2. モードの状態を永続化します。 .omx/state/.../autoresearch-state.json に、次の項目を含めてください:
   • validation_mode
   • completion_artifact_path
   • mission_validator_command または validator_prompt
   • 任意項目: output_artifact_path
3. 完了は成果物によって制御されます。 モデルが「完了」と述べたとき、ストップフックが一度発火したとき、あるいはいくつかのターンが何も行わなかったときに、ループは停止しません。
4. 直接の CLI 起動は廃止されました。 取り込みには $deep-interview --autoresearch を、実行には $autoresearch を使用してください。

完了成果物の契約

mission-validator-script

完了成果物が存在し、バリデーターが合格した結果を記録している必要があります。例:

{
  "status": "passed",
  "passed": true,
  "summary": "metric improved beyond baseline"
}

prompt-architect-artifact

完了成果物には、アーキテクトの承認判定と出力成果物のパスの両方を含める必要があります。例:

{
  "validator_prompt": "Review the research output against the mission.",
  "architect_review": { "verdict": "approved" },
  "output_artifact_path": ".omx/specs/autoresearch-demo/report.md"
}

推奨フロー

1. $deep-interview --autoresearch を実行して、ミッションと評価者を明確にします。
2. .omx/specs/autoresearch-{slug}/mission.md、sandbox.md、result.json を具体化します。
3. モード状態に保存された検証モードを指定して $autoresearch を開始します。
4. 完了成果物が選択された検証モードを満たすまで、ストップフック/自動ナッジによって処理を継続させます。
5. バリデーターの成果物が完成してから、初めて終了します。

移行に関する注意

• omx autoresearch は強く非推奨です。
• 直接の CLI 起動はありません。
• tmux の分割ペインでの起動はありません。
• ノーオペレーション回数による完了ゲートはありません。