11個のClaudeスキルでクリーンルーム方式のアプリレプリカを構築する

Replicaスキルの機能

Replicaスキルは、アプリの機能とユーザーフローをゼロから再構築するための11個のClaudeスキルのコレクションです。ワークフローは、調査、アーキテクチャ、デザイン、実装、バックエンドサービス、テスト、比較、ポジショニング、ブランディング、ローンチ準備、デプロイまでを網羅します。

クリーンルーム方式での再構築を目的に設計されています。このプロジェクトが調査するのは、アプリが何をするかであり、アプリが何を所有しているかではありません。機能やインタラクションパターンは再現できますが、ソースコード、専有アセット、ロゴ、商標、テキスト、非公開API、保護されたコンテンツをコピーしてはいけません。

アプリが何をするかを再構築します。所有物は決してコピーしません。

リポジトリはMITライセンスで提供され、サインアップやAPIキーは不要です。また、外部ネットワークに接続しない標準ライブラリのみのPythonツールが含まれています。

スキルをインストールする

Claudeからインストールする

リポジトリのURLとインストール指示をClaudeに貼り付けます。

https://github.com/Jakeschincariol/replica-skill

install skill

Claude Codeプラグインとしてインストールする

Claude Codeでマーケットプレイスを追加し、プラグインをインストールします。

/plugin marketplace add Jakeschincariol/replica-skill
/plugin install replica-skill@replica-skill

プラグインとしてインストールすると、Claude Codeはスキルに名前空間を付けます。たとえば、reconスキルは/replica-skill:replica-reconとして表示されます。

フォルダーを手動でコピーする

/replica-reconのような通常のスキル名を使うには、リポジトリをクローンし、スキルフォルダーをグローバルClaudeスキルディレクトリにコピーします。

git clone https://github.com/Jakeschincariol/replica-skill.git
cp -r replica-skill/replica-* ~/.claude/skills/

プロジェクト固有のスキルを使う場合は、同じフォルダーをリポジトリの.claude/skills/ディレクトリにコピーします。個別のSKILL.mdファイルをClaudeの会話に貼り付け、モードとして実行することもできます。ただし、この方法ではPythonツールは含まれません。

ツールにはPython 3.8以降が必要です。pipでインストールするパッケージはありません。

11個のスキルによるワークフローを理解する

推奨プロセスでは、スキルを順番に実行します。各スキルは、プロジェクトのreplica/ディレクトリに前のスキルが書き出した成果物を読み込みます。

recon -> architect -> design -> build -> backend -> test -> diff -> entrepreneur -> brand -> launch -> deploy

• /replica-reconは、許可された情報源から画面、フロー、コンポーネント、推定データモデルをリバースエンジニアリングします。
• /replica-architectは、技術スタック、データベーススキーマ、API、実装順序を計画します。
• /replica-designは、独自のアセットを使い、視覚的な観察結果を色、タイポグラフィ、スペーシング、コンポーネントのデザイントークンに変換します。
• /replica-buildは、reconマップに基づいて画面単位でアプリケーションを実装します。
• /replica-backendは、認証、データベース、決済、外部連携を追加します。
• /replica-testは、ユーザーフロー、エッジケース、バグをテストします。
• /replica-diffは、レプリカとオリジナルを比較し、一致している点と不足している機能を報告します。
• /replica-entrepreneurは、実際のユーザーレビューを分析し、不満、プロダクトの機会、ポジショニングの切り口を特定します。
• /replica-brandは、独自の名前、ビジュアルアイデンティティ、トーンを作成し、コードベースに元のブランドの痕跡が残っていないか確認します。
• /replica-launchは、ランディングページ、料金設定、App StoreまたはGoogle Playの掲載情報を準備します。
• /replica-deployは、事前確認を実行し、独自ドメインでのプロダクト公開を支援します。

プロジェクト全体を実行する

1. 対象アプリを調査する

/replica-reconから始め、アプリのURLや、その他の許可された調査ソースを指定します。このスキルは、公開ページ、ヘルプセンター、料金ページ、ストア掲載情報、公開された操作ガイド、スクリーンショット、自分のアカウントを利用できます。replica/recon.mdやfeatures.csvなどのファイルを生成します。

reconの出力には、画面、ユーザーフロー、コンポーネント、推定データモデルが記録されます。また、再構築できる機能と、非公開ネットワークや専有カタログなど、元の企業に属するリソースも区別されます。

2. アーキテクチャを計画する

/replica-architectを実行して、reconの結果を実装計画に変換します。技術スタックを選定または推奨し、データベーススキーマとAPIを定義し、最も重要なエンドツーエンドフローを中心に開発順序を決めます。

たとえば、スケジューリング製品には、ユーザー、イベントタイプ、空き時間、予約が必要になる場合があります。また、2人のゲストが同じ時間枠を予約できないようにするなど、ドメイン固有の制約もアーキテクチャに組み込む必要があります。

3. デザインシステムを再構築する

/replica-designを使い、オリジナルのアセットをコピーするのではなく、観察したインターフェースをデザイントークンとして記述します。出力には、色の役割、タイポグラフィ、スペーシング、コントロール、コンポーネント仕様を含められます。元のアイコン、フォント、文言、画像は、使用が許可されたアセットに置き換えます。

4. アプリケーションを実装する

/replica-buildは、アプリケーションを画面単位で実装します。実用的な順序は、シェルを構築し、主要フローを実装してから、二次画面と各種状態を完成させることです。機能マトリクスを使うと、完了状況を追跡できます。

5. バックエンド機能を追加する

認証、データベースの動作、決済、インテグレーションには /replica-backend を実行します。使用するサービスでは、自分の認証情報と各サービスの公式APIを使用してください。たとえば、スケジューリングのレプリカでは、カレンダー連携にGoogle独自のAPI、有料予約にStripe、リマインダーにメールプロバイダーを利用できます。

6. すべてのフローをテストする

/replica-test は、調査フローの一覧からテスト計画を作成し、エンドツーエンドテストを定義できます。タイムゾーン、予約中にスロットが利用できなくなるケース、重複送信など、成功する経路とエッジケースの両方を含めてください。重大度がCriticalおよびHighの問題が解消されるまで、ログの記録とバグ修正を続けます。

7. パリティを測定する

/replica-diff を使って、結果を元のアプリと比較します。パリティスコアと不足機能の一覧が表示されるため、意図的な除外と未完成の作業を区別できます。省略した機能が、再現できないネットワーク、カタログ、またはライセンスに依存している場合、スコアが低くても自動的に問題とは限りません。

8. プロダクトの機会を見つける

プロダクトのポジショニングに使える根拠が必要なときは、/replica-entrepreneur を実行します。提供したレビューのデータを分析し、繰り返し現れる不満を順位付けして、元の行へのリンクを保持します。引用、数値、顧客の意見を捏造することはありません。レビューやソースが少なすぎるテーマには、情報不足の印が付きます。

9. 独立したブランドを作る

/replica-brand は、新しい名前、配色、ロゴブリーフ、ボイスを作成します。また、実行すべき商標とドメインのチェックも提示します。ローンチ前にこの段階を完了し、コードベースから元の名前、ドメイン、色、その他の識別要素を削除してください。

10. ローンチの準備をする

/replica-launch は、ランディングページ、料金設定、ストア掲載情報の草案を作成します。掲載情報ツールは、App StoreとGoogle Playの制限、ランキングに関する主張、無駄なキーワード文字、元のアプリ名への言及をチェックします。

11. プリフライト後にのみデプロイする

最後に、/replica-deploy を使ってプリフライトプロセスを実行します。本番環境の設定前に、テスト、パリティ、ブランドの総点検、ストア掲載情報をチェックします。ドメイン用のDNSレコードを提示でき、リリースを承認した場合にのみ出荷できます。

付属のPythonツールを使う

リポジトリには6つのコマンドラインツールが含まれています。Pythonの標準ライブラリを使用し、ネットワークには接続しません。

python3 replica-diff/imgdiff.py original.png clone.png --out diff.png
python3 replica-diff/parity.py replica/features.csv
python3 replica-entrepreneur/reviews.py replica/reviews.csv
python3 replica-design/contrast.py replica/design/tokens.json
python3 replica-brand/sweep.py . --avoid "Original App"
python3 replica-launch/listing.py replica/launch/listing.json

• imgdiff.py はスクリーンショットをエッジマップに変換し、色の違いを無視してレイアウト領域を比較します。
• parity.py はMust、Should、Couldの機能に重み付けし、部分的な完了を半分として計算し、不足項目を一覧表示します。
• reviews.py はリンクのないレビューを除外し、提供したソース行に対応する引用を出力します。
• contrast.py はデザイントークンのWCAGコントラストをチェックします。
• sweep.py は識別子を含むコードを検索し、元の名前、ドメイン、色を探します。
• listing.py はストアの制限、ランキングに関する主張、キーワードの使用状況、模倣を示す言及をチェックします。

リポジトリのテストスイートは次のコマンドで実行します。

python3 -m unittest discover -s tests -v

プロジェクトの境界内で作業する

公開ページや自分のアカウントなど、アクセスを許可されている情報だけを使用してください。ログインの先をスクレイピングしたり、ペイウォールを回避したり、他人のアカウントにアクセスしたり、サイトの利用規約に違反したりしないでください。アカウントの規約で競合サービスの構築が禁止されている場合は、その規約に従ってください。

このワークフローでも、アプリが所有するものを再現することはできません。音楽サービスのプレーヤー、プレイリスト、共有フローは再構築できる可能性がありますが、その音楽カタログをコピーする権利はありません。同様に、専有の文章、ロゴ、商標、ソースコード、アセットを再利用しないでください。

結果を販売する前に、商標チェックを完了し、使用したすべてのサービスとアセットの規約を確認してください。プロジェクトに重大な商業上または法的なリスクが伴う場合は、弁護士に相談してください。リポジトリのガイダンスは法的助言ではありません。

まとめ

Replicaスキルは、アプリの再構築を文書化された手順に変えます。許可されたソースを調査し、システムを計画し、インターフェースと動作を再構築し、結果をテストし、パリティを測定し、機会を見つけ、リブランドして、独立してデプロイします。スキルをインストールし、成果物を replica/ に保管し、付属のチェックを使って、機能面では着想を得ながらも、法的にも視覚的にも独自の最終製品に仕上げてください。

GitHub でプロジェクトを確認し、作者については opusjake.ai で詳しく学べます。