factory-lines

Islo Factories

Factory には Machine、再利用可能な Agent、Line が含まれます。Agent はユーザーが直接操作する実行単位です。Line は Agent 間のやり取りをつなぎ、その結果を振り分けます。ランタイムは Agent のステージを内部 Job にコンパイルする場合がありますが、ユーザーに Job の選択や設定を求めてはいけません。Manager はステージ間の Line を振り分けます。

セットアップの契約

Factory の構築または大幅な変更を依頼された場合は、factory-design.md を確認してから create-a-line.md に進んでください。まず、読み取り専用コマンドでリソースを調査します。確認できたリソース、推定したデフォルト、ユーザーへの確認が必要な決定事項を区別します。未解決の決定事項だけをまとめて一度に質問し、その後、完全な設計案を1つ提示します。作成、更新、デプロイ、プロバイダーイベント、外部への書き込みを行う前に、その設計案への明示的な承認を待ちます。

話し合いでは、Factory、Machine、Agent、それらのやり取り、共有ワークスペース、意味的な入力と出力、インテグレーション、副作用、検証など、製品としての用語を使います。ランタイムが、より詳細な型付き契約、決定論的なコマンド、スナップショット、ファンアウト、検証、ライフサイクル制御を必要とする場合に限り、内部 Job を使います。開発者から質問された場合にのみ、その実装の詳細を説明します。

マニフェストを記憶だけで作成してはいけません。インストール済みの islo schema factory --short、islo schema agent、内部 Job を使う場合は islo schema job --short を確認し、デプロイ前に検証してください。インストール済みの CLI に必要なコマンドまたは Agent ステージのフィールドがない場合は、無関係なリソースで黙って代用せず、具体的にどの機能が不足しているかを報告します。Agent ステージでは、ランタイムのデフォルトの input および output 契約を使います。CLI で Agent ステージのカスタムパラメーターと出力が公開されるまでは、より詳細な型付き契約に内部 Job を使います。

参照資料

必要な内容	参照先
リソースの検出、Factory の設計、承認の取得	factory-design.md
リソースの作成、Line の検証	create-a-line.md
Machine のライフサイクルと準備状況	machines.md
Agent、Manager、ハーネス、モデル、Skills、MCP	agents-and-managers.md
Line マニフェスト、トリガー、実行のデバッグ	line-manifest.md、triggers.md、run-control-and-debugging.md
内部 Job のハーネス、モデル、Knowledge、マニフェスト、または明示的に依頼されたスタンドアロン Job	harness-models-knowledge.md、job-manifest.md、standalone-jobs.md

サンドボックスとスナップショットのライフサイクル、環境、ゲートウェイプロファイル、プロバイダー接続、受信 Webhook、Knowledge の CRUD には、プラットフォームスキルを使用します。近くにある例は構造の参考として扱い、新しい Factory にそのリポジトリ、セレクター、宛先、ゲートウェイの識別情報をコピーしてはいけません。

scripts/validate_commands.sh と scripts/validate_examples.sh は、記載されたコマンドとマニフェストの例をインストール済み CLI に照らして検証します。