Cloudflare向けAIエージェント用モノレポスターター公開

開発者がpnpmワークスペース、Turborepo、Cloudflare Workersインフラを組み合わせた本番指向のモノレポスターターを公開した。AIエージェントがアプリケーションを安全に構築・保守できるように明示的に設計されている。テンプレートはNode.js 22以上、pnpm（ルートpackage.jsonで固定）をベースに構築。Cloudflare Workers APIゲートウェイ（Hono）、Reactフロントエンド（Vite + Tailwind CSS v4 + TanStack Router/Query）、DTO（Zodを使用したデータ転送オブジェクト）、列挙型、TypeScript設定プリセット用の構造化共有パッケージを含む。

モノレポは3つのカテゴリに編成される。バックエンドサービス（worker-api、worker-*ビジネスロジック、queue-*コンシューマー、webhook-*入口、mcp-* MCPサーバー）、フロントエンドアプリケーション（React SPA）、共有パッケージ（@repo/dtos-common、@repo/enums-common、@repo/typescript-config）。アーキテクチャは厳密な命名規則とパターンで強制される。公開HTTPゲートウェイ（worker-api）がリクエストを検証し、サービスバインディングRPC経由で非公開ビジネスワーカー（worker-*）へ作業をルーティングする。各ワーカーはsrc/db/下で最大1つのDrizzleデータベーススキーマを所有し、他のワーカーはそのデータにRPCまたはキューチャネル経由でのみアクセスする。複数のアプリから同じデータベースバインディングをアタッチしない。これはエージェントがインフラをスカッフォルドする際の一般的なミスを防ぐ。同じデータベースの複数の所有者を誤って作成すること。

開発ワークフローはレポジトリルートからMakefile駆動。インストールはmake install（生のpnpm installより推奨。ワークスペース一貫性を維持）。make devコマンドはTurborepo経由ですべての開発サーバーを起動。スコープ付き作業はmake dev SCOPE=worker-nameを使用。環境設定は.dev.vars（.dev.vars.exampleテンプレートから）をワーカーシークレット、.env.localをフロントエンドVite変数に使用。各ワーカーは開発レジストリからニーモニック開発ポートを割り当て。worker-apiは8700～8709、worker-*は8710～8739、queue-*は8740～8759、webhook-*は8760～8779、mcp-*は8780～8789を使用。フロントエンドはViteのデフォルト5174（開発）と4174（プレビュー）を使用。ワーカー間のサービスバインディングテストは、単一の複数設定wrangler devコマンド（wrangler dev -c apps/worker-api/wrangler.jsonc -c apps/worker-example/wrangler.jsonc。最初の設定がHTTP主要）か別のターミナル実行を使用。

新しいワーカーのスカッフォルディングはコピーおよびリネームパターンに従う。ジェネレーターCLIはない。開発者またはエージェントは既存アプリ（例：apps/worker-api）を新しい名前にコピー（例：apps/worker-account）し、package.json名、wrangler.jsonc名を更新、開発レジストリから次の空きポートを割り当て、新しいワーカーのMakefileにmake/app.mkを含め、@repo/typescript-configプリセットを拡張する。このアプローチはテンプレートパーサーよりもエージェント向けにシンプルで、設定不正リスクを削減する。デプロイはmake deploy（すべてのワーカー）またはmake deploy SCOPE=worker-name（単一ワーカー）。テンプレートはAIエージェント統合用のフック（hooks/下、Huskyではない）を含み、キューのみ（queue-*）とハイブリッド（キュー付きworker-*）アプリ向けの双方向ハンドラーパターンをサポート。HTTPリクエスト処理（ローカルデバッグ用）をqueue()ハンドラー経由のキューメッセージ消費から分離。

テンプレートはAIエージェントを第1級の用例として明示的にターゲットにしている。そうでなければコードレビューを通じて学習される可能性があるアーキテクチャ制約（専有データベース所有権、RPC専用ビジネスロジック、公開・非公開分離）は、フォルダ構造、命名規則、設定パターンに組み込まれている。モノレポはこれらのガードレールを自動的に強制し、すべての変更の人間によるレビューなしに、非人間のシステムが本番インフラを変更する際により安全にしている。

このモノレポスターターは、アプリケーションテンプレートの設計方法における意図的な転換を示している。汎用スカッフォルディングから、非人間のエージェント（AIシステム）が本番コードベースを変更するために最適化されたアーキテクチャへのシフトだ。テンプレートが認識している現実的なリスクがある。AIエージェントが新しいワーカーを作成したり既存のインフラを変更したりする際、人間の開発者がコードレビューで引っかかるようなアーキテクチャ制約を誤って違反する可能性がある（例えば、同じデータベースバインディングを複数のワーカーにアタッチしたり、ビジネスロジックレイヤーに公開ルートを作成したりすること）。

設計はセーフなパターンをデフォルトにし、ミスをアーキテクチャ的に不可能にすることでこれを解決する。データベース所有権はスキーマと同じ場所に配置される。各ワーカーは最大1つのデータベースバインディングを所有する。ワーカー間通信は共有バインディングではなく、明示的なRPCチャネルまたはキューを通じて流れる。テンプレートはエージェント統合用のフックを含み、著者がコードベースが非人間のシステムによって読み取られ、変更されることを第1級の用例として期待していることを示唆している。

開発体験もエージェントスカッフォルディング向けに最適化されている。コードジェネレーター（パースされたテンプレートが必要で、サイレントに失敗する可能性がある）の代わりに、新しいワーカーは既存の兄弟アプリをコピーしてpackage.jsonと設定ファイルをリネームすることで作成される。これは人間とエージェントの両方にとって正しく実行しやすい。モノレポのMakefile駆動ワークフロー（make dev SCOPE=worker-name、make deploy SCOPE=worker-name）は設定不正の表面積をさらに削減する。ポート레지스트리（定義されたロールのワーカーの8700～8789）はエージェントがネットワーク設定を割り当てる際の判断をさらに排除する。

まだコメントがありません。最初のコメントを投稿しましょう！