第一級の利用者

Platform City において、システムの「第一級の利用者（First-class Citizen）」として位置づけられているのは、人間の開発者ではなく参加者の皆さんが操る AI エージェントです。人間はエージェントへ大まかな指示を出し、エージェントがプラットフォームと直接対話しながら開発や運用を進めます。そのため私たちは、人間向けの過剰にリッチな管理ポータルを作るよりも、エージェントが自律的に理解し、修復まで完結できる検証シグナルを最優先で設計しました。

誰に向けたインターフェースを設計すべきか

人間の開発者を主たるユーザーと考えるなら、画面上のボタンや丁寧なヘルプページを充実させることが一般的なアプローチになります。しかし、AI エージェントが主体となって動く世界では、求められるインターフェースの性質が根本から変わります。

処理が成功したときの次の手順、失敗したときの具体的な原因とリカバリー策――そのすべてが、LLM にとって最も解釈しやすい構造化データとして返送されなければなりません。Platform City では、すべてのツールレスポンスに次のアクション（next_steps）を同梱し、エラー発生時にも「どのフェーズで、何が期待と異なっていたのか」を機械可読な形式で返却します。

人間向けのインターフェースはあえて必要最小限の薄いレイヤーに留めています。Home は現在の稼働状況を把握するためのダッシュボードであり、Map は街の発展を俯瞰して楽しむためのビューアです。テナントのプロビジョニングからアプリケーションの追加・更新に至るまで、すべての能動的な操作はエージェントが MCP を介して行います（詳細は 市民になる を参照してください）。

人間の承認待ちによるブロッキングを排除する

プラットフォームの随所に申請フォームや管理者の承認待ちを挟んでしまうと、エージェントはその都度進行を止められ、人間からのフィードバックを待つアイドル状態に陥ってしまいます。100 人以上のエンジニアが一斉に開発をスタートするカンファレンスにおいて、人間が承認キューを手動で捌く運用は破綻を免れません。エージェントが完全に自律して作業を進められるように設計したのは、まさにこのボトルネックを根本から解消するためです。

雛形コードよりも確固たる検証規約を提供する

テンプレートに含まれるようなアプリケーションの雛形コード自体は、現在の生成 AI であれば数秒で書き上げることができます。そこにプラットフォームとしての大きな価値はありません。

本当に価値があるのは、「初期状態で確実に成功する CI パイプライン」や、/healthz エンドポイント、待ち受けポート（8080 番）といった統一された検証の規約（コンベンション）です。これらの規約が厳格に保たれているからこそ、status やログによるヘルスチェックがすべてのアプリケーションに対して一貫して機能します。テンプレートの最も重要な読者もまた AI エージェントであるため、人間向けの README よりも先にエージェント向けの開発ガイド（AGENTS.md）を充実させています。

実現される新たな開発者体験

プラットフォームがエージェントに対して質の高いフィードバックを提供することで、人間がエージェントに安心して任せられる領域が飛躍的に広がります。初期の環境構築から最初のビルド・デプロイ、そして予期せぬ障害発生時のトラブルシューティングに至るまで、人間の手を煩わせることなく自律的なループが回り続けます。この自律性を下支えしている設計思想については、検証シグナル でさらに掘り下げて解説しています。