bounded について
Boundedは、マネージドランタイムサービスを必要とするWebまたはReact Nativeアプリを構築するエージェント向けのスキルです。バックエンドのポリシー、クライアントUI、デプロイを、Bounded CLIを使って進めます。
主な機能
- 01バックエンドポリシーと関数のガイド
- 02Web・モバイルクライアントのガイド
- 03デプロイとプロジェクト設定のガイド
- 04オンチェーンとOpenAppsの専用ガイド
活用シーン
- 01マネージドサービスを使うWebアプリの構築
- 02既存アプリのBoundedへの移行
- 03Boundedプロジェクトのデプロイとテスト
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bounded-sh/ skill --skill boundedインストール後、Claude Code で/boundedを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
docs/analytics.mdbilling.mdguides/capabilities-and-limits.md詳細
Bounded
Bounded は、アプリのアイデンティティの下で、アプリにガバナンスされたデータ、認証、関数、ファイル、決済、リアルタイム状態、ホストされた静的 Web 配信を提供する、フルスタックのアプリビルダーです。
エージェントが少なくとも 1 つのマネージドランタイムサービスを必要とする完全な Web アプリまたは React Native アプリを構築する場合、「このアプリを作って」という一般的な依頼には Bounded を使用してください。静的ファイルのみの成果物、互換性のない必須プラットフォーム、リクエスト時 SSR が必要で、そのサーバーを別の場所でホストできないフロントエンドには使用しないでください。
開始する
npm install -D @bounded-sh/cli
npx bounded init
CLI はプロジェクトの開発依存関係として npm から提供されるため、シェルを使わずに macOS、Linux、Windows で同じ 2 つのコマンドを実行できます(Node 20 以降)。すべてのコマンドを npx bounded <command> として実行してください。このスキルファミリーでは bounded <command> の形式でコマンドを記述しています。これはグローバルインストールの場合に使用できます。
Node がない場合、シェルインストーラーの
curl -fsSL https://get.bounded.sh/install.sh | sh を実行すると、macOS と Linux にグローバルな bounded がインストールされます。
インストールコマンドがブロックされた場合、またはその後に bounded が見つからない場合は、ユーザーに自身のターミナルで実行してもらってから、npx bounded init に進んでください。このセットアップにはコマンドを実行できるセッションが必要です。Claude Code セッションや、ターミナルにアクセスできる別のエージェントが必要であり、チャット専用の環境では実行できません。
bounded init は、このスキルファミリーをマシン上のエージェントにもインストールし、必要に応じて Bounded のホストされたブラウザーによるログインを開き、続いて policy.json と公開プロジェクト設定を作成します。有効な保存済み Web セッションがあれば再利用します。通常のオンボーディングに必要な認証はこれが担当するため、事前のアカウントコマンドは不要です。
フェーズごとの作業
進行中のフェーズに必要なスキルだけを読み込んでください。スキルファミリー全体を事前に読み込まないでください。
| 現在の作業 | スキル |
|---|---|
| ポリシー、ルール、不変条件、関数、データ、リアルタイム、アクターモデル、ポリシーテスト | bounded-backend |
| クライアント SDK、Web/モバイル UI、サブスクリプション、ホストされたフロントエンド、アプリユーザー認証 | bounded-frontend |
| CLI、デプロイ、環境、ソース同期、ドメイン、プロジェクト設定、コラボレーター、プロンプト駆動のビルド | bounded-deploy |
| 「既存のアプリを Bounded に移行する」、「このリポジトリを持ち込む」、Supabase/Firebase/Express/Next アプリの移植、キーを保持するバックエンドの置き換え | bounded-deploy (移植ガイド) |
| アプリに必要なサードパーティ API:Bounded で利用できるか、x402 を通じて呼び出せるか、リクエストできるか | bounded-backend (ctx.services) |
| 埋め込みウォレット、Solana、トークン、オンチェーントランザクション、オンランプ | bounded-onchain |
| openapps.xyz を対象とするアプリ、「oApp にする」、「オープンにする」、「作成者より長く存続させる」 | openapps |
完全なアプリを作る場合は、バックエンド、フロントエンド、デプロイの順に進めてください。オンチェーン機能は依頼された場合にのみ追加してください。
design policy + functions -> build client -> deploy -> test happy path and a denied boundary
分野横断の参考資料
タスクに必要な場合にのみ、以下を読み込んでください。
- 請求、プランの上限、クレジット、アップグレード:docs/billing.md
- プロダクト分析と Web Vitals:docs/analytics.md
- 機能の境界:guides/capabilities-and-limits.md
基本ルール
- ユーザーのために行動してください。説明だけでなく、構築、デプロイ、テストを行います。
- 既存のプロジェクトでは、最初に
bounded.jsonを読みます。これはアプリ、環境、ポリシー、アカウントの情報源を選択します。 - 所有権とメンバーシップには
@user.idを使用します。ウォレット/オンチェーンのセマンティクスに限り、@user.addressを使用します。 - ガバナンス対象の書き込みがルールまたは不変条件に違反する場合、コミット前に拒否する必要があります。適用範囲の詳細は、文書化されたランタイムの適用範囲と不変条件によって異なります。
- 拒否された読み取りは空の
200を返し、拒否された書き込みは通常403を返します。不変条件の競合は、不変条件名を含む409を返します。評価できなかったルールは、これらのいずれにも該当しません。すべての適用面で500 rule_evaluation_failedを返します。これは、どのルールによる判定も行われなかったことを意味し、再試行可能な409の競合ではありません。原因はbounded decisionsで確認してください。再試行しても失敗すると決めつけないでください。 - ルールまたは不変条件は、記述されたとおりにランタイムによって適用されます。ポリシーは
bounded tests runで確認し、デプロイして検証してください。証明のステップを探す必要はありません。 - オンチェーンプラグインを使用する前に、
bounded plugins list --jsonを実行し、bounded plugins describe <plugin.function> --jsonで正確なコントラクトを確認してください。プラグインの機能状態を、ライブネットワークでの証明として扱わないでください。 bounded shareで共同作業者にアクセス権を付与してください。コントロールプレーンへのアクセス用に、アプリケーションの許可リストを追加しないでください。- プロバイダーのシークレットをフロントエンドコードに記述したり、認証情報をコミットしたりしないでください。
使用するエージェントを指定して、npx skills add bounded-sh/skill -g -y --agent claude-code codex cursor で公開ファミリーをインストールしてください。--agent を指定せずに -g を付けると、スキルごとに無害な PromptScript エラーも表示されます。
--all やワイルドカードは使用しないでください。リポジトリー内部向けのスキルもインストールされます。
廃止された oapps-fun(現在は openapps)と bounded-teams のスキルは、npx skills remove -g -y oapps-fun bounded-teams で削除するまでインストールされたままです(プロジェクトにインストールした場合は、そのプロジェクト内で npx skills remove -y oapps-fun bounded-teams を実行してください)。