前提条件
- Bun v1.3 以降
- Git（強く推奨）
- BRICKS CLI（2.25.0 以降）
- BRICKS ワークスペースアカウント
プロジェクトの作成
bricks-ctor プロジェクトを取得する方法は 3 通りあります。オプション 1：BRICKS Controller（推奨）
BRICKS Controller の Web インターフェースからプロジェクトを生成します：- BRICKS Controller でアプリケーションを開く
- Generate Project をクリック
- オプションを設定する：
- AGENTS.md — AI エージェントの指示（Claude Code、Codex など向け）
- CLAUDE.md — Claude Code 専用の指示
- GEMINI.md — Gemini CLI の指示
- GitHub Actions — CI/CD デプロイワークフロー
- Download Project (.zip) をクリック
オプション 2：CLI
BRICKS CLI をインストールし、コマンドラインからプロジェクトを初期化します：bricks ctor init コマンドはプロジェクトファイルを生成し、依存関係をインストールします。フラグで出力をカスタマイズできます：
オプション 3：CTOR
CTOR を使用します — AI エージェントが統合されたデスクトップ IDE で、チャットを通じてプロジェクトの作成・編集・デプロイが可能です。開発ワークフロー
コンパイル
TypeScript の型チェックを実行し、BRICKS ランタイムが使用する JSON 設定にコンパイルします：bricks ctor compile を実行します。
Simulator
ローカルの Simulator ウィンドウでアプリを起動します：bricks ctor simulator を実行します。CTOR の統合 IDE における同等機能については、組み込みプレビューを参照してください。
デプロイ
コンパイル済みのアプリを BRICKS サーバーにデプロイします：bricks ctor deploy --auto-commit を実行します。
バージョン解決の優先順位：
--version フラグ > --auto-version インクリメント > package.json バージョン。--version と --auto-version はいずれもデプロイ前に package.json を更新します。
リリースを作成せずにプッシュ
現在の設定をコンパイルし、リリースを作成せずに現在のステージへプッシュします：bricks ctor push --auto-commit を実行します。
プル
サーバーからアプリケーションの最新バージョンをプルします：bricks ctor pull を実行し、ローカルプロジェクトとサーバーバージョンの間で 3-way Git マージを行います。--force を使用するとローカルの変更を上書きします。
既存プロジェクトの移行
古い@fugood/bricks-ctor npm パッケージで作成したプロジェクトは、BRICKS CLI 2.25.0 以降がグローバルにインストールされていれば、次回の bun install 実行時に自動的に移行されます。移行時には次の処理が行われます：
- プロジェクトのスクリプトが
bricks ctorコマンドを呼び出すよう書き換えられます @fugood/bricks-ctorの依存関係が削除されます- ローカルの
ctor/ライブラリ、MCP 設定、skills が再生成されます
AI 支援開発
bricks-ctor は AI コーディングエージェントと連携するよう設計されています。AI 指示を有効にしてプロジェクトを生成すると、次のファイルが作成されます：
これらのファイルには、AI エージェントがアプリケーションを理解・修正するためのプロジェクト固有の指示、アーキテクチャパターン、BRICKS のドメイン知識が含まれています。
BRICKS CLI は 内蔵 MCP server と 内蔵 skills もセットアップし、AI エージェントにツールとドメイン知識を提供します。