この1年で何かが変わった。AIエージェントはもはやチャットボットだけではない――それらは運用製品として機能している。 Claudeにはコンピューターを使う能力がある。エージェントはUIをナビゲートし、ボタンをクリックし、フォームに入力し、ワークフローを完了させる。
顧客はあなたの製品でタスクを実行するAIエージェントを送るようになるでしょう。すでにそうしている人もいます。
問題点：あなたのSaaSはおそらくエージェント向けに壊れている。あなたのせいではない - これを想定して設計された人はいなかった。しかし、エージェントがつまずくポイントは次のとおりです：
- 空の状態のように見えるスケルトンローダー
- すべてのキーストロークでトリガーされる自動保存（エージェントは待つことを知らない）
- すべての表示データを変更するワークスペース切替機能
- 新しいウィンドウで開くOAuthポップアップ
- エージェントが文字通り完了できないMFAフロー
- 分単位でかかり、停止しているように見える非同期処理
- 「承認」ボタンが確認なしに有料操作をトリガーします
自分のプロダクト（BrandyBee）をClaudeにナビゲートさせたとき、これらすべてに遭遇しました。完璧に正常なロード画面で「壊れているのですか？」と尋ね続けてきました。
そこで operate.txt を作りました - yourdomain.com/operate.txt にあるシンプルな YAML ファイルで、AIエージェントのためにあなたの製品が実際にどのように機能するかを文書化しています。読み込み状態、取り返しのつかない操作、フォームの依存関係、非同期処理、タスクのフロー。
AIエージェントがあなたの製品を操作するための、特別なプロダクトドキュメントと考えてください。
この仕様を例とともにオープンソース化しました： https://github.com/serdem1/operate.txt
作成プロセス: Claudeと並行してあなたの製品を開き、初めて使うユーザーのようにナビゲートするよう伝え、どこで躊躇するかを観察します。そうした部分があなたの最優先エントリになります。Claude にファイルを下書きさせ、あなたが間違っている箇所を修正します。
operate.txt は今日の競争上の優位性です。3年後には標準的な期待になるでしょう。エージェントが安定して成功するSaaS製品こそ、顧客が選ぶ製品になるでしょう。
[リンク] [コメント]
