> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

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

> BRICKSプロジェクトを作成・管理する

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

## プロジェクトを開く

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

<Info>
  選択したディレクトリに `application.json` ファイルが含まれていない場合、アプリはエラーメッセージを表示します。閉じて別のディレクトリを試してください。
</Info>

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

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

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

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

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

**新しいプロジェクト**ダイアログには2つのタブがあります：**既存から**と**新規作成**。

複数の認証済み[プロファイル](/ja/ctor/guide/authentication#multi-profile-support)がある場合、ダイアログ上部に**プロファイル**ドロップダウンが表示され、任意のワークスペースでアプリを閲覧・作成できます。

### 既存のアプリから

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

<Steps>
  <Step title="新しいプロジェクトダイアログを開く">
    サイドバーの**新しいプロジェクト**をクリックします。
  </Step>

  <Step title="アプリを選択する">
    ダイアログには選択したプロファイルのワークスペースのアプリが一覧表示されます。検索フィールドを使用して名前や説明でフィルタリングできます。
  </Step>

  <Step title="ディレクトリを選択する">
    アプリを選択し、**プロジェクトを作成**をクリックして、マシン上のディレクトリを選択します。アプリはそのディレクトリにプロジェクトを初期化します。
  </Step>
</Steps>

### 新しいアプリを作成する

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

<Steps>
  <Step title="新しいプロジェクトダイアログを開く">
    サイドバーの**新しいプロジェクト**をクリックし、**新規作成**タブを選択します。
  </Step>

  <Step title="アプリの詳細を入力する">
    * **アプリ名**（必須）——新しいアプリの名前
    * **説明**（オプション）——アプリの機能についての簡単な説明
  </Step>

  <Step title="アプリとプロジェクトを作成する">
    **アプリとプロジェクトを作成**をクリックし、ディレクトリを選択します。BRICKSサーバーにアプリが作成され、ローカルプロジェクトが初期化されます。新しいセッションが自動的に開きます。
  </Step>
</Steps>

## プロジェクトの管理

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

### プロジェクトを削除する

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

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

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

### 最近のプロジェクト

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

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

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

これは以下のような用途に役立ちます：

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

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

## 次のステップ

<CardGroup cols={2}>
  <Card title="AIエージェントを使い始める" icon="robot" href="/ja/ctor/guide/agent-usage">
    AIエージェントとチャットしてアプリケーションをビルドしましょう。
  </Card>

  <Card title="bricks-ctor SDK" icon="cube" href="/ja/ctor-pkg">
    bricks-ctorアプリケーションを動かすTypeScript SDKについて学びましょう。
  </Card>
</CardGroup>