Trabuco

 ████████╗██████╗  █████╗ ██████╗ ██╗   ██╗ ██████╗ ██████╗
 ╚══██╔══╝██╔══██╗██╔══██╗██╔══██╗██║   ██║██╔════╝██╔═══██╗
    ██║   ██████╔╝███████║██████╔╝██║   ██║██║     ██║   ██║
    ██║   ██╔══██╗██╔══██║██╔══██╗██║   ██║██║     ██║   ██║
    ██║   ██║  ██║██║  ██║██████╔╝╚██████╔╝╚██████╗╚██████╔╝
    ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝  ╚═════╝  ╚═════╝ ╚═════╝
  

コーディングエージェントに必要な AI コンテキストを組み込んだ、本番環境対応の Java プロジェクトを生成します。

新しい Java プロジェクトの開始には時間がかかります。コーディングエージェントが手伝ってくれても同じです。Maven モジュールを設定し、データベースやテストを接続し、「だいたいうまくいく」あのプロジェクトから定型コードをコピーし、それから最初の1時間をかけて、すべてのアーキテクチャ規約を Claude Code、Cursor、Copilot、Codex に一から説明します。ビジネスロジックを1行も書く前に、何時間も経ってしまいます。Trabuco は、あなたの時間もエージェントのコンテキストウィンドウも、設定に悩んだり規約を教え直したりするのではなく、機能の開発に使うべきだという考えから生まれました。

Trabuco はコマンドラインツールであり、Claude Code プラグインでもあります。現代的な Java コードベースの両面、つまり本番環境に対応した完全なマルチモジュール Maven プロジェクトと、その中での作業方法をコーディングエージェントに教える AI コンテキストを生成します。trabuco init を実行するか、Claude Code 内で /trabuco:new-project と入力して必要なものを平易な言葉で説明し、いくつかのプロンプトに回答するか、自動化用のフラグを渡せば、すぐに使える Spring Boot コードベースに加えて、タスク別のプロンプト、品質仕様、エージェントごとのルールファイル、Claude Code、Codex、Cursor、GitHub Copilot 向けに設定済みのワークフローフックが得られます。ダウンロードするテンプレートも、手動でのセットアップも、プロジェクトを理解させるためだけにエージェントとのセッションを費やす必要もありません。

生成されるコードは、デフォルトで本番環境向けの品質を備えています。Spring Data JDBC を使った Spring Boot（JPA による予想外の問題なし）、Flyway のマイグレーション、実際の統合テスト用の Testcontainers、Resilience4j のサーキットブレーカー、Spotless による Google Java Format の適用、レイヤー違反があるとビルドを失敗させる ArchUnit ルール、相関 ID トレーシング、Prometheus メトリクス、OpenAPI と Swagger UI、レスポンスをサニタイズするグローバル例外ハンドラーを備えています。PostgreSQL、MySQL、MongoDB、Redis は、すべて Docker Compose で設定されます。バックグラウンドジョブには JobRunr、イベント駆動型の処理には Kafka、RabbitMQ、AWS SQS、GCP Pub/Sub を利用できます。モジュール構成は Model、SQLDatastore / NoSQLDatastore、Shared、API、Worker、EventConsumer で、コンパイル時に明確な境界を設けているため、API が Worker のコードをインポートすることは物理的に不可能です。すべての設計判断には意図があります。キーセットページネーション、外部キー制約なし、モジュール境界での Immutables、コンストラクターインジェクションのみ、件数を制限したバルク書き込みを採用しています。

コードに加えて、Trabuco は主要なコーディングエージェントが標準で読み込める AI 連携レイヤーを用意します。.ai/prompts/ ディレクトリには、タスク別のガイド（add-entity、add-endpoint、add-service、add-event、add-job、add-tool）と、アーキテクチャ境界、例外処理、データストアのパフォーマンス（バルク I/O、キーセットによる排出ループ、非正規化）、テスト標準を網羅する正式な仕様書 JAVA_CODE_QUALITY.md が含まれています。エージェントごとのルールファイルである、Claude Code 用の CLAUDE.md、Codex 用の AGENTS.md、Cursor 用の .cursor/rules/java.mdc、Copilot 用の .github/instructions/java.instructions.md によって、各ツール固有の検出方法に合わせて規約を設定します。Claude にはコミット、PR、レビューのワークフロー用に .claude/skills/ も用意され、Codex と Cursor にはフック、Copilot にはセットアップ手順が用意されます。すべてのアーキテクチャ規約は2つの場所に反映されます。生成されたコードで強制されると同時に、そのコードを拡張するエージェントにも説明されます。 Trabucoはさらにその先を実現します。AI Agentモジュールには、Spring AI上でAIエージェント自体を構築するための、本番環境向けの基盤が用意されています。ツール呼び出し、LLM入出力ガードレール、マルチエージェントのオーケストレーション、ナレッジベース連携、MCP サーバーエンドポイント、A2A（Agent-to-Agent）プロトコル、ストリーミング応答、Webhookコールバック、スコープベースの認可、レート制限、相関IDトレーシングが、最初のコミットから接続済みで、テスト可能な状態で利用できます。Trabuco自体もMCP サーバーです。trabuco mcpを実行すると、コーディングエージェントがスキャフォールディング操作（init_project、add_module、design_system、suggest_architecture）をネイティブに呼び出せます。

既存のSpring Bootプロジェクトの移行はtrabuco migrateでサポートされています。14フェーズのオーケストレーションによる移行で、MavenベースのSpring Bootリポジトリをその場で、Trabuco形式のマルチモジュールプロジェクトに変換します。各フェーズは専門家が担当し、構造化された変更案を提示します。変更は、承認ゲートで承認した後にコミットされます。フェーズごとのGitタグにより、アトミックなロールバックが可能です。trabuco migrate assess /path/to/repoから始めてください。詳しいガイド：「docs/migration-guide.md」。

インストール

# Recommended: use via npx (no install needed)
claude mcp add trabuco -- npx -y trabuco-mcp

# Or install the CLI globally
npm install -g trabuco-mcp                                       # via npm
go install github.com/arianlopezc/Trabuco/cmd/trabuco@latest     # via Go
curl -sSL https://raw.githubusercontent.com/arianlopezc/Trabuco/main/scripts/install.sh | bash  # via shell

エージェントごとのMCP設定（Cursor、Copilot、Codex）、オフライン用tarball、バイナリのフォールバックについては、「docs/manual.md#installation」を参照してください。

クイックスタート

# Interactive — Trabuco asks what you need
trabuco init

# Or all flags
trabuco init --name=myapp --group-id=com.company.myapp \
  --modules=Model,SQLDatastore,Shared,API --database=postgresql

cd myapp
mvn clean install
cd API && mvn spring-boot:run

APIはhttp://localhost:8080で動作します。Worker、EventConsumer、AIAgent、CIの例については、「docs/manual.md#quick-start」を参照してください。

Claude Codeプラグイン

TrabucoはAnthropicのコミュニティプラグインマーケットプレイスで公開されています。Claude Code内で次のように操作します。

/plugin marketplace add anthropics/claude-plugins-community
/plugin install trabuco@claude-community

claude.com/pluginsでカタログを閲覧することもできます。また、リリース前の変更などのためにこのリポジトリを直接指定するには、/plugin marketplace add arianlopezc/Trabucoを実行してから、/plugin install trabuco@trabuco-marketplaceを実行します。

このプラグインには、8つのスキル（/trabuco:new-project、/trabuco:design-system、/trabuco:add-module、/trabuco:extend、/trabuco:migrate、/trabuco:doctor、/trabuco:suggest、/trabuco:sync）、17の専門サブエージェント（アーキテクト、AIエージェントの専門家、移行オーケストレーター、14の移行フェーズ専門家）、および25のツールを備えたMCP サーバーが含まれています。プラグインの詳しいドキュメント：「plugin/README.md」。

このプラグインを使うには、trabuco CLIがPATH上に必要です。先にインストールしてください（後からでも構いません。SessionStartフックがバイナリの不足を検出し、アシスタントに必要な手順を正確に伝えます）。

主な特長

• マルチモジュール Maven — Model、SQLDatastore／NoSQLDatastore、Shared、API、Worker、EventConsumer、AIAgent 間のコンパイル時の境界を明確にします。
• Spring Boot + Java — Spring Data JDBC（JPA なし）、Flyway マイグレーション、仮想スレッドがデフォルトで有効、実際の統合テストには Testcontainers を使用します。
• OIDC リソースサーバーのひな形（API／AIAgent 向けに自動生成） — Spring Security のデュアル SecurityFilterChain、JWT 検証、スコープに対応付けられた権限、RFC 7807 ProblemDetail ハンドラー、RSA 署名付き E2E テストを備えています。初期状態では無効です — trabuco.auth.enabled=true に切り替え、OIDC_ISSUER_URI を設定すると、Keycloak／Auth0／Okta／Cognito／汎用 OIDC のトークンを検証できます。CLI フラグも、中途半端にインストールされたプロジェクトもありません。詳しくは docs/auth.md をご覧ください。
• 本番環境向けのオブザーバビリティ — RFC 7807 Problem Details、OpenTelemetry 自動計装、Prometheus メトリクス、相関 ID、ヘルスプローブを備えています。
• AI エージェントモジュール — ツール、LLM ガードレール、MCP サーバー、A2A プロトコル、マルチエージェントオーケストレーション、ナレッジベース、Webhook を備えた Spring AI。OIDC チェーンは、段階的な移行に対応するため、レガシーな ApiKeyAuthFilter（独立したプロパティで制御）と共存します。
• AI コラボレーションレイヤー — タスクガイド .ai/prompts/、仕様書 JAVA_CODE_QUALITY.md、Claude Code／Codex／Cursor／GitHub Copilot 向けのエージェントごとのルールファイルを備えています。
• 既存リポジトリの移行 — trabuco migrate は、各フェーズに承認ゲートを設け、アトミックなロールバックに対応した 14 フェーズのオーケストレーションフローを実行します。
• モジュールを把握する CI — --ci github を指定すると、各モジュールに必要な Docker サービスを正確に含むワークフローを出力します。
• 新しいリリースとの同期を維持 — trabuco sync --apply を実行すると、新しい CLI バージョンで追加された AI ツール用ファイルを追加できます。

機能の一覧は docs/manual.md#features をご覧ください。

ドキュメント

• docs/manual.md — CLI の完全なリファレンス（インストール、モジュール、MCP サーバー、コード品質、設定オプション、すべてのフラグ）。
• docs/migration-guide.md — 既存の Spring Boot プロジェクトの移行方法。
• docs/README.md — 設計の背景（理念、パターンのレシピ、使用を避けるべき場合、制約）を含む、ドキュメントの完全な索引。
• plugin/README.md — Claude Code プラグイン：スキル、サブエージェント、フック、MCP サーバー。

要件

• Java（Trabuco がインストール済みのバージョンを自動検出します）
• Maven
• Docker（Testcontainers およびローカル開発用）

コントリビューション

Issue とプルリクエストを歓迎します。

ライセンス

MIT — ご自由にお使いください。

---

Trabuco で構築されています。 さあ、素晴らしいものを作りましょう。