プロジェクトのセットアップ

プロジェクトとは、application.json ファイルを含むマシン上のディレクトリです。BRICKS CTORは単一ウィンドウで動作し、開いているすべてのプロジェクトをサイドバーに表示します。

​

プロジェクトを開く

1. サイドバーのプロジェクトを開くボタンをクリックする
2. BRICKSプロジェクトを含むディレクトリを選択する（または親ディレクトリ——アプリは最大3階層まで検索します）
3. 検出されたプロジェクトがサイドバーにノードとして表示される

​

新しいプロジェクトを作成する

プロジェクトを作成する方法は2つあります：

• メインチャットエージェントに依頼する（推奨）。 チャットを始めるで作りたいものを伝えると、エージェントが bricks ctor init を実行します。完了するとチャット下部に Created projects カードが表示されます——Start session をクリックすると、新しいプロジェクトがすでに選択された状態でプロジェクトスコープのチャットが開きます。メインチャットでのコンテキストは CONTEXT.md を介して引き継がれ、プロジェクトエージェントが続きから作業を始められます。
• 「新しいプロジェクト」ダイアログを使う（手動）。 サイドバーの新しいプロジェクトをクリックして、エージェントを介さずフォームからプロジェクトをスキャフォールドします。

このセクションの残りでは手動フローを説明します。

​

新しいプロジェクトダイアログ

新しいプロジェクトダイアログには2つのタブがあります：既存からと新規作成。 複数の認証済みプロファイルがある場合、ダイアログ上部にプロファイルドロップダウンが表示され、任意のワークスペースでアプリを閲覧・作成できます。

​

既存のアプリから

既存からタブを使用して、BRICKS Controller に既に存在するアプリからローカルプロジェクトを作成します。

​

新しいアプリを作成する

新規作成タブを使用して、サーバーに新しいアプリを作成し、ローカルプロジェクトを一度に初期化します。

​

プロジェクトの管理

開いているプロジェクトはそれぞれサイドバーに展開可能なノードとして表示されます。プロジェクトをクリックすると展開され、セッションが表示されます。セッションはプロジェクトごとにスコープされています——プロジェクトを選択すると、そのチャットセッションのみが表示されます。

​

プロジェクトを削除する

サイドバーからプロジェクトを削除するには：

1. プロジェクトにカーソルを合わせ、Xボタンをクリックする
2. 表示された確認ボタンをクリックする（または3秒待つとリセットされます）

プロジェクトを削除しても、サイドバーから取り除かれるだけです。ディスク上のプロジェクトファイルは削除されません。

​

最近のプロジェクト

以前に開いたプロジェクトはクイックアクセス用に最近のプロジェクトリストに表示されます。アプリを再起動すると、開いているすべてのプロジェクトも復元されます。

​

プロジェクトコンテキストファイル

プロジェクトのルートに CLAUDE.md または AGENTS.md ファイルを配置すると、AI エージェントにカスタム指示を提供できます。これらのファイルはそのプロジェクトのすべてのセッションのエージェントシステムプロンプトに自動的に含まれます。 これは以下のような用途に役立ちます：

• プロジェクト固有のコーディング規約の定義
• プロジェクトアーキテクチャの説明
• エージェントが従うべきカスタムルールの追加

アプリはプロジェクトルートの application.json も読み取り、エージェントのコンテキストにアプリのメタデータを含めます。

​

次のステップ