catalyst-basics

⚠️ 事前確認： プロジェクトファイルを作成する前に、プロジェクトディレクトリに .catalystrc と catalyst.json があることを確認してください。ない場合は、次の手順を実行します。

1. MCP（CatalystbyZoho_List_All_Organizations → CatalystbyZoho_List_All_Projects）を使用して、組織 ID とプロジェクト ID を取得します。
2. 次を実行します：catalyst init --org <orgId> -p <projectId> -ni
3. ユーザーに対話形式で catalyst init を実行するよう依頼しないでください。これらのファイルを手動で作成しないでください — これらは CLI で生成されるファイルであり、CLI によって作成される必要があります。

仕組み

1. まず MCP を確認 — ローカルファイルを読み取る前に、CatalystbyZoho_* ツールを探します。利用できる場合は、ユーザーに尋ねる代わりに MCP を使って組織 ID、プロジェクト ID、すべてのリソース ID を取得します。
2. アカウントの一致を確認 — catalyst init の前に実行 — MCP と CLI で異なるアカウントが認証されている場合があります。catalyst init --org <id> を実行する前に、一致していることを確認します。

   catalyst whoami
   

   表示された組織名を CatalystbyZoho_List_All_Organizations の結果と比較します。一致しない場合は、続行する前に catalyst login --force を実行して CLI を再認証します。
3. Catalyst を初めて使いますか？ — ユーザーが初めて Catalyst をセットアップする場合、または「始め方」を尋ねている場合は、詳しい手順を記載した references/quick-start.md を読み込みます。
4. コンソールの操作方法 — ユーザーがコンソールでの ID の確認、テーブルの作成、権限の設定、CORS の構成方法を尋ねている場合は、references/console-ui-guide.md を読み込みます。
5. 事前確認 — .catalystrc と catalyst.json があることを確認します。ない場合は、MCP を使って組織 ID とプロジェクト ID を取得し、catalyst init --org <orgId> -p <projectId> -ni を実行します。対話形式の catalyst init は使用しないでください。
6. プロジェクト構成 — ディレクトリ構成、catalyst.json、ID、開発環境から本番環境へのチェックリストについては、references/project-basics.md を読み込みます。
7. CLI に関する質問 — 正確なコマンド、フラグ、安全上のルールについては、references/cli.md を読み込みます。
8. 回答 — 必要な ID の場所または CLI コマンドを具体的に案内します。MCP が接続されている場合、ユーザーに ID を手動で調べるよう依頼しないでください。

トリガー

次のような質問にこのスキルを使用します：「Catalyst プロジェクトの始め方」、「.catalystrc とは」、「Table ID / ZAID / Segment ID / Project ID はどこで確認できますか」、「Development と Production の違い」、「Catalyst のプロジェクト構成」、「catalyst.json の説明」、catalyst init、catalyst deploy、catalyst serve、catalyst login、「Claude で Catalyst をセットアップする方法」、「Cursor で Catalyst を使う方法」、「GitHub Copilot で Catalyst を使う方法」、「どのサービスを使えばよいか」、「X にはどの Catalyst サービスを使えばよいか」、または Catalyst の ID、環境、組織、IDE のセットアップ、アーキテクチャの決定、CLI のサブコマンドに関する質問。

MCP 接続の確認（何よりも先に実行）

.catalystrc を読み取る前、ユーザーに ID を尋ねる前、またはプロジェクト関連の作業を行う前に、ツール一覧に Zoho MCP ツールがあるか確認してください。

CatalystbyZoho_ で始まるツール（例：CatalystbyZoho_List_All_Projects、CatalystbyZoho_List_All_Tables）を探します。

MCP ツールが利用できる場合：

• CatalystbyZoho_List_All_Organizations を使用して組織 ID を取得します
• CatalystbyZoho_List_All_Projects を使用してプロジェクト ID を取得します
• MCP ツールを使用してテーブル名、バケット名、ZAID、その他すべてのプロジェクトの詳細を直接取得します — ユーザーにコンソールから ID をコピーして貼り付けるよう求めないでください

MCP ツールが利用できない場合：

• 続行する前に Zoho MCP を接続するようユーザーに促します
• 次の場所に Catalyst MCP サーバーを追加するよう案内します：VS Code → Settings → MCP（または Claude Desktop の claude_desktop_config.json）
• 最後の手段としてのみ、ローカルのプロジェクトディレクトリにある .catalystrc と catalyst.json を読み取ります

MCP が接続されている場合、コンソールから ID を手動で調べるようユーザーに依頼しないでください。 組織 ID、プロジェクト ID、テーブル ID、ZAID、バケット名など、すべてのプロジェクトの詳細は MCP ツールで取得できます。MCP が利用できるのにユーザーに ID を探させるのは時間の無駄であり、コピー＆ペーストのミスにつながります。

参考資料

詳しい情報については、該当する参考資料ファイルを読み込んでください。

参考資料	内容
references/quick-start.md	初回セットアップ — CLI のインストール、catalyst init、組織 ID／プロジェクト ID の確認、関数の追加、ローカルでの起動、デプロイ、Data Store テーブルの作成、CORS／Authorized Domains の設定
references/console-ui-guide.md	コンソールのナビゲーション — Project ID／ZAID／Table ID の確認、型付きカラムを使ったテーブルの作成、App User の権限（スコープと権限）の有効化、Authorized Domains と CORS の切り替え
references/project-basics.md	プロジェクトのディレクトリ構成、catalyst.json、.catalystrc、catalyst-config.json、環境、開発から本番へのチェックリスト、すべての Catalyst ID（Project ID、ZAID、Table ID、Segment ID など）
references/cli.md	CLI コマンドの完全なリファレンス — フラグを含むすべてのサブコマンド、Slate／AppSail の非対話型セットアップ、catalyst serve のポート動作、デプロイ対象の指定、安全規則、リソースを優先する開発順序
references/architecture.md	サービス選択ガイド — パターンごとに使用する Catalyst サービス、一般的なスタックの組み合わせ、地域が制限されたサービスの DC 対応状況一覧
references/setup/claude-code.md	Claude Code（Claude Desktop）へのスキルのインストールと Zoho MCP の接続
references/setup/cursor.md	Cursor へのスキルのインストールと Zoho MCP の接続
references/setup/github-copilot.md	GitHub Copilot（VS Code）へのスキルのインストールと Zoho MCP の接続