Communityコーディング&開発github.com

mmsample97/scale-readiness-checker

アプリを5ユーザーから5,000ユーザーへと成長させる計画を平易な言葉で作成します。アプリのアイデアやコードをアップロードし、いくつかの質問に答えるだけで、データベースインデックス一覧、キャッシュ計画、負荷テスト計画、ホスティング計画を含む完全なスケール準備状況チェックを取得できます。あらゆるAIエージェントに対応しています。

scale-readiness-checker とは?

このスキルは、アプリのスケーラビリティを評価し、具体的な改善計画を提供するAIエージェント用ツールです。特に、データベースインデックス、キャッシュ、負荷テスト、ホスティングの4つの観点からアプリの成長準備状況をチェックし、詳細なドラフト計画を作成します。このスキルは、コードの変更やデータベースの操作を直接行うことはなく、あくまでオーナーによるレビューのための計画案を提供します。Claude Code、Cursor、Codexなど、ほとんどのAIエージェントと互換性があり、技術者でないユーザーにも理解しやすい平易な言葉で結果を出力します。また、チェック結果は証拠に基づいて厳格に評価され、「Pass」「Fail」「Not confirmed」のいずれかで判定されます。計画の最終承認は常にアプリオーナーに委ねられます。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/mmsample97/scale-readiness-checker/tree/HEAD

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

スケール準備状況チェッカー

見出し

アプリを5ユーザーから5,000ユーザーへと成長させる計画を、平易な言葉で

フック

アプリをアップロード。いくつかの質問に答える。アプリが遅くなったりクラッシュしたりせずに成長するための完全な計画を入手。

課題(平易な言葉で)

ほとんどのアプリは5ユーザーでは正常に動作しますが、より多くの人が参加すると遅くなったりクラッシュしたりします。データベースはすべての行を検索しなければならず、同じデータが何度も何度も取得され、そして誰も1,000人のユーザーが同時にアクセスした場合のテストを行っていません。最初に行うべき解決策は、より大きなサーバーを用意することではありません。解決策は計画を立てることです。データにインデックスを付け、頻繁に使用されるデータをキャッシュし、負荷をテストし、成長に対応できる場所でホスティングすることです。

得られるもの

スケール準備状況チェック、そしてスケール計画。あなたのアプリだけのために作られます。チェックでは、最初に何が壊れるかを見つけます。計画では、レビュー用のドラフト修正案が提供されます。それ自体でライブの変更を行うことは決してありません。

対象読者

コードが書けない創業者で、自分のアプリが成長できるかどうか、そして何を最初に修正すべきかを平易な言葉で知りたい方。ユーザーが増えているアプリやWebアプリを持つ中小企業の経営者。インデックス、キャッシュ、負荷テスト、ホスティングを含む明確なスケール計画を開発者に渡す必要があるフリーランサーやビルダー。

なぜ節約になるのか

スケール問題を早期に修正することは、後でクラッシュを修正するよりも安上がりです。明確な計画があれば、ビルダーが推測で動いたり、データベースを再構築したり、まだ必要のない大きなサーバーを購入したりするのを防げます。

技術者向け

構造化されたスケール計画。データベースインデックス一覧、キャッシュキーと有効期限を含むキャッシュ計画、ユーザーレベルと限界点を含む負荷テスト計画、スケーリングに関する注意事項を含むホスティング計画。Claude、Cursor、または任意のAIビルダー、あるいは人間の開発者に説明する準備ができています。特定のユーザー数を保証するものではなく、計画だけでアプリがスケールすることを主張するものでもありません。計画はオーナーレビュー用のドラフトであり、ライブの変更ではありません。

目的

アプリが少数のユーザーから多数のユーザーへと成長する準備ができているかどうかを確認し、スケール計画を作成すること。このスキルは、最初にチェックし、次に計画を立てます。コードの変更、データベースの変更、実際のユーザーへのライブ負荷テストの実行、またはそれ自体でのデプロイは行いません。

使い方

ステップ1: 以下の質問を、ユーザーに一つずつ、平易な言葉で尋ねます。 ステップ2: アプリを以下の4つのスケールチェックに照らして確認します。 ステップ3: 見つかったギャップに対するドラフト修正案を含むスケール計画を作成し、DRAFT, NOT LIVE とラベル付けします。 ステップ4: 最後に不足しているチェックを実行し、完了しているもの、不足しているもの、確認されていないものをリストアップします。

まず、以下の質問を一つずつ尋ねてください。

  1. あなたのアプリは何をするものですか?平易な言葉で教えてください。
  2. 現在誰が使っていて、現在のユーザー数は何人ですか?
  3. 将来的に何人までのユーザーを処理したいですか?いつまでに?
  4. ユーザーがアプリで最も頻繁に行う操作は何ですか?順番に教えてください。
  5. 現在、データはどこに保存されていますか?(例:Supabase、Firebase、データベース、その他)
  6. 現在、アプリはどこでホスティングされていますか?(例:Netlify、Vercel、その他)
  7. 現在、何か遅い部分はありますか?それはいつ遅く感じますか?
  8. 多くのユーザーが同時に参加しても、絶対に壊れてはいけないものは何ですか?
  9. 実際のユーザー数データをお持ちですか?それとも目標値のみですか?
  10. 修正は誰が行いますか?AIビルダー、人間の開発者、それともあなた自身(サポートを受けながら)?

ユーザーが答えを知らない場合は、「確認されていません (Not confirmed)」とマークし、そのアプリタイプによくある答えを使用し、その旨を明記してください。答えをでっち上げないでください。

4つのスケールチェック

4つすべてを順番にチェックします。各チェックについて、証拠を記録します。ファイル、テーブル、クエリ、設定、または証拠を見つけたユーザーの回答。証拠がない場合は「不合格 (Fail)」となります。

1. データベースインデックス

  • 最もよく使われるクエリにインデックスがあること(本の索引のように)。これにより、データベースはすべての行を読む代わりに行を高速に見つけられます。
  • 使用頻度の高いクエリをトップ5まで平易な言葉でリストアップし、それぞれにインデックスがあるかどうかを述べてください。
  • 上位のクエリにインデックスがない場合、または同じクエリが行数の増加に伴い遅い場合は、不合格です。
  • ドラフト修正案: テーブル名、カラム名、そのインデックスが役立つ理由を含むインデックス一覧を、オーナーレビュー用に作成します。自分でインデックスを作成しないでください。

2. キャッシュ

  • 頻繁に使用され、めったに変更されないデータがキャッシュされていること。これにより、毎回データベースから取得されるのを防ぎます。
  • 現在キャッシュされているもの、キャッシュすべきもの、その期間を平易な言葉でリストアップしてください。
  • 同じデータがページが読み込まれるたびにキャッシュなしで取得されている場合、またはキャッシュされたデータが変更されても決してクリアされない場合は、不合格です。
  • ドラフト修正案: キャッシュキー、保持するデータ、有効期間、クリアされるタイミングを含むキャッシュ計画を、オーナーレビュー用に作成します。ユーザーがすでに使用している場合にのみキャッシュツールの名前を挙げてください(例:Redis)。それ以外の場合は「提案 (Suggested)、未確認 (not confirmed)」とマークしてください。自分でキャッシュを設定しないでください。

3. 負荷テスト

  • 多くの偽ユーザーを使用してアプリがテストされており、実際のユーザーが見つける前に、どこで最初に壊れるかを特定していること。
  • テストされたユーザーレベル(例:同時50人、500人、5,000人)と、各レベルの結果をリストアップしてください。
  • 負荷テストが行われていない場合、またはテストで5ユーザーのみを使用した場合、または限界点が不明な場合は、不合格です。
  • ドラフト修正案: ユーザーレベル、各テストの内容、監視すべき点、合格基準を含む負荷テスト計画を、オーナーレビュー用に作成します。実際のユーザーに対して負荷テストを実行したり、ユーザーが許可しない限りライブアプリでテストを実行したりしないでください。

4. 成長に対応できるホスティング

  • ホスティングがユーザー数の増加に応じて、完全な再構築なしで成長できること。
  • 現在のホスティングをリストアップし、それが自動的にスケールするのか、それとも成長のために手動での作業が必要かを述べてください。
  • ホスティングが単一の小さなサーバーで成長計画がない場合、またはトラフィックの急増でアプリが停止する場合は、不合格です。
  • ドラフト修正案: 現在のホスティング、変更すべき点、そして現状維持すべき点を含むホスティング計画を、オーナーレビュー用に作成します。ユーザーがすでに複雑なセットアップを使用していて維持したい場合を除き、KubernetesやAzureのような複雑なセットアップよりも、VercelやNetlifyのような自動スケールするシンプルなホスティングを推奨します。自分でホスティングを移動しないでください。

追加チェック

これらは上記4つのチェックの一部ではありませんが、メモとして別途報告してください。4つのポイントスコアに混在させないでください。

  • 遅いページ: 最も遅いページと、その遅さの原因を平易な言葉でリストアップしてください。
  • 重い処理: ユーザーをブロックする代わりにバックグラウンドで実行すべき処理(例:多数のメール送信、多数のファイル作成)をリストアップしてください。
  • コスト: ユーザー数の増加に伴ってコストが増加するもの(例:データベース読み取り、ホスティング)を、でっち上げの価格なしで平易な言葉でリストアップしてください。
  • モバイル: アプリがスマートフォンで使用されているかどうか、そして遅い部分がスマートフォンでより悪化するかどうかを述べてください。

厳格なルール

  • 証拠なしに「合格 (Pass)」とマークしないでください。
  • ユーザー数、速度、コスト、データベーステーブル、インデックス、キャッシュキー、テスト結果をでっち上げないでください。
  • 負荷テストで証明されていない限り、アプリが5,000ユーザー、または任意の数を処理できると主張しないでください。何がテストされ、何がテストされなかったかを明確に述べてください。
  • オーナーからの別途の承認なしに、インデックスを作成したり、キャッシュを設定したり、ライブユーザーに対して負荷テストを実行したり、ホスティングを移動したり、何かをデプロイしたりしないでください。
  • 提案されたアイテムは「提案 (Suggested)、未確認 (not confirmed)」とマークする必要があります。
  • スケール計画は、成長、ユーザー数、または収入を約束するものではありません。
  • 計画は平易で短い文章で記述してください。オーナーは技術的な読者ではない可能性があります。

スケール計画のフォーマット

常に以下のフォーマットで、この順序で、DRAFT, NOT LIVE, Owner approval needed とラベル付けして終了してください。

スケール計画: [アプリ名]

現在のユーザー数: [数値 または Not confirmed] | 目標ユーザー数: [数値 または Not confirmed] | 主な用途: [平易な言葉]

判定: 成長準備完了 (Ready to grow) / 修正が必要 (Needs fixes first) / 成長準備未完了 (Not ready to grow)

4つのチェックで「不合格 (Fail)」がなければ「成長準備完了 (Ready to grow)」を使用してください。それ以外の場合は「修正が必要 (Needs fixes first)」、またはブロッカーが見つかった場合は「成長準備未完了 (Not ready to grow)」を使用します。

結果

#チェック結果証拠
1データベースインデックス合格 / 不合格 / 未確認テーブル、クエリ、またはファイル
2キャッシュ合格 / 不合格 / 未確認現在キャッシュされているもの
3負荷テスト合格 / 不合格 / 未確認テストレベルと結果
4成長に対応できるホスティング合格 / 不合格 / 未確認ホスティング名

優先順位順のドラフト修正案

  1. インデックス一覧: [テーブル、カラム、それが役立つ理由]
  2. キャッシュ計画: [キャッシュキー、保持するデータ、期間、クリアされるタイミング]
  3. 負荷テスト計画: [ユーザーレベル、テスト内容、合格基準]
  4. ホスティング計画: [現在のホスティング、変更点、現状維持点]

各ドラフト修正案は DRAFT, NOT LIVE, Owner approval needed とマークする必要があります。

最初に壊れるもの

  • [ユーザー数が増えるにつれて最初に壊れるもの、平易な言葉で、証拠とともに]

オーナーの手順(クライアントの同意が必要)

  • [例:目標ユーザー数を確認する]
  • [例:インデックス一覧を作成する前に承認する]
  • [例:負荷テストの時間を選ぶ(ライブユーザーには行わない)]

メモ

  • [追加チェックセクションからのメモ、または「なし (None)」]

チェックされなかったものとその理由

  • [例:オーナーの承認なしには負荷テストを実行できませんでした。]

不足しているチェック

計画の後、以下の6つのチェックを実行し、各結果をリストアップしてください。

  1. トップ5クエリはリストアップされましたか?
  2. ギャップに対するインデックス一覧は作成されましたか?
  3. キャッシュ計画は(キーと有効期限を含めて)作成されましたか?
  4. 負荷テスト計画は(ユーザーレベルを含めて)作成されましたか?
  5. ホスティング計画は作成されましたか?
  6. 目標ユーザー数はオーナーによって確認されましたか?または「未確認 (Not confirmed)」とマークされましたか?

結果を「完了 (Complete)」、「不足 (Missing)」、または「未確認 (Not confirmed)」としてリストアップしてください。オーナーの承認なしに不足している項目を追加しないでください。

関連スキル