Show HN: AIエージェントが安全にアプリケーションを構築・保守できるモノレポ

このモノレポテンプレートは、AIエージェントが安全かつ効率的にアプリケーションを構築・保守できる環境を提供するために設計されました。構造化された規約と明確な境界により、意図しない副作用のリスクを低減し、AI支援による開発を必要とする本番プロジェクトに最適です。

テンプレートはpnpmワークスペースとTurborepoを基盤とし、効率的な依存関係管理とビルドキャッシュを実現します。Cloudflare Workersを使用したエッジデプロイにより、低レイテンシとグローバルな可用性を確保。フロントエンドスタックにはReact（Vite 8）、Tailwind CSS v4、TanStack Router/Queryを採用し、モダンな開発体験を提供します。バックエンドはHonoフレームワークで構築され、実行時ロールに応じてHTTPゲートウェイ（worker-api）、ビジネスロジックWorker（worker-*）、キュー専用コンシューマ（queue-*）、Webhookイングレス（webhook-*）、MCPサーバー（mcp-*）に分類され、それぞれ明確な通信パターンと責務を持ちます。

プロジェクト構造は、バックエンドサービス（apps/ディレクトリ内のWorkerアプリ）、フロントエンドアプリ（front-app）、共有パッケージ（packages/）の3つに整理されます。共有パッケージにはDTOコントラクトと列挙型が含まれ、スタック全体でデータの一貫性を保証します。特に、データベーススキーマ（Drizzle）は単一のWorkerが所有し、他のWorkerはサービスバインディングRPCまたはキューを介してデータにアクセスする設計となっており、複数アプリによる直接的なDBバインディングを防ぎます。

テンプレートには、インストール、リンティング、テスト、デプロイのためのMakefileコマンドが用意されています。ポート割り当ては統一ルールに従い、Workerは87xxポート、フロントエンドは51xx/41xxポートを使用します。AIエージェントのフックとスキル設定がリポジトリに統合されており、自律エージェントが安全にコードベースと対話し、一般的なタスクを実行できます。さらに、新しいWorkerの作成方法、環境変数の設定方法、サービスバインディングのテスト方法が詳細に説明されており、開発者にとって包括的な入門ガイドとなっています。

全体として、このモノレポスターターはコードの組織化とセキュリティに重点を置きつつ、AIエージェントの自律操作に特化して最適化されており、スケーラブルで保守性の高いクラウドアプリケーションを構築するための堅固な基盤を提供します。