ntm

NTM — オプションのペインアダプター

NTM は、永続的なペインで明示的なエージェントの役割をホストします。これはトランスポートであり、AgentOps のライフサイクルを制御するものではありません。ペイン、役割、コマンド、書き込み範囲、停止時点は呼び出し側が選択します。

ロボットのインターフェースが機能するのは、ペインに送信された内容ではなく、ペインで何が行われているかを報告するためです。送信できたことしか証明できないディスパッチレイヤーでは、停止したワーカーまで稼働中に見えてしまいます。

ペインの稼働状況は、信頼できる情報を上から順に確認して判断します。ディスク上の新しい成果物、トランスクリプトの増加、ロボットの状態と注意フラグ、そしてプロセスが存在するという事実だけ、の順です。プロンプトの送信に成功したことは、これらすべてよりも証拠として弱く、作業が行われていることの証明にはなりません。

名前付きの障害モード — kill-the-witness：停止したペインの状態を記録する前に再起動し、停止した理由を示す唯一の証拠を破棄してしまうことです。

アンチパターン：応答しないペインの再起動を、既定の対処法にすること。 是正策：再起動の前に救出します。ロボットの状態とトランスクリプトをスナップショットし、ナッジを試み、信頼できる情報のどのレベルにも稼働状況が示されない場合にのみ再起動します。

境界

• インストールされているという理由だけで、NTM を起動したり、状態を調べたりしないでください。
• 不慣れな操作を行う前に、ntm --help、ntm --robot-capabilities、ntm --robot-snapshot を使って、現在のコマンド仕様を確認してください。
• 呼び出し側から渡された各コマンドは一度だけディスパッチします。NTM は作業を選択したり、失敗したコマンドを再試行したり、候補を検証したり、変更を統合したり、次に実行する処理を決めたりしません。
• ペインの役割は説明用です。所有権、受け入れ、Git、リリース、配信に関する権限を与えるものではありません。
• 同時に書き込みを行う場合、呼び出し側が互いに重ならない範囲と、リポジトリに必要な分離手段を指定する必要があります。NTM は安全な並行処理を推測しません。
• 安全性、ロック、メール、パイプラインの機能は基盤の事実として扱われます。それらの状態によって RPI フェーズの結果や意味上の判定が変わることはありません。このアダプターは AgentOps の意味論を選択したり、拘束力のある判定を下したり、ファクトリーの完了を配信や検証の証拠に変えたりすることはできません。

ワンショットディスパッチ

1. 明示的なセッション、ペイン、役割、作業ディレクトリ、コマンドを記録します。
2. ロボットの機能と現在のスナップショットを確認します。
3. 指定されたペインのみを作成または選択します。
4. コマンドを一度だけ送信します。
5. コマンドが終了するか、呼び出し側の観察時間が終了するまで、ロボットの状態、注意フラグ、トランスクリプトを観察します。
6. 事実に基づく結果を返し、終了します。

ソフトウェアファクトリーのレイアウトでは、呼び出し側がプロデューサー、テスター、バリデーター、インテグレーターのペインを指定できます。それでも同じ識別ルールが適用されます。候補のバリデーターは、その候補の作成者とは異なるコンテキスト識別情報を持つ必要があります。2 つの役割を別々のペインに配置したという事実は、実行時の宣言にすぎず、意味上の独立性を証明するものではありません。複数モデルによる判定ペインでは、agent-native のモデルディスパッチレシピ（調査し、開示し、claude -p は使用しない）に従います。

出力

次の情報を返します。

• セッションとペインの識別子
• 役割と正確なコマンド
• 開始時刻と観察時刻
• 判明している場合は終了ステータス
• ロボットの状態と、関連するトランスクリプトの参照情報
• 機能が低下している、または利用できない基盤のインターフェース
• 観察された効果と、観察されなかった効果

最終的な状態は必ず明示します。無言のまま処理をハングさせてはいけません。

• NTM を利用できない — ntm が存在しないか、ロボットのインターフェースに到達できない場合は、その旨を報告して終了します。キーを直接送信する手段に盲目的に切り替えたり、ペインがアイドル状態だと決めつけたりしないでください。
• 観察時間の期限に到達 — 最後に確認したロボットの状態とトランスクリプトの参照情報を報告します。観察時間の終了は処理の停止であり、失敗の判定ではありません。
• タイムアウト／ゼロ以外の終了ステータス／情報源の機能低下 — 観察された内容と観察されなかった内容を添えて、証拠として報告します。
• キャンセルとクリーンアップ — 別の実験を行うかどうかは呼び出し側が決定します。作成したペイン、または実行中のまま残したペインを報告し、何も通知されないまま孤立することがないようにします。NTM は自ら再試行したり、プロセスを回収したりしません。

便利なライブサーフェス

機能、スナップショット、注意、テール、パイプラインの観測には、機械可読なロボット用サーフェスを優先してください。呼び出し元が対話型の操作を明示的に要求し、必要な動作を実現するロボットコマンドがない場合にのみ、対話型のキー入力を使用してください。

コマンド構文については、外部の NTM ドキュメントとサンプルを引き続き参照してください。このスキルが担うのは、上記の AgentOps 境界のみです。NTM の CLI はバージョンによって変化するため、記憶しているコマンドを信頼するのではなく、実行時にサーフェスを確認してください（ntm --version、ntm --robot-capabilities）。