AI向け実行ガイド
このページは商品の宣伝ではありません。キットを扱うAIが、何を読み、何を確認し、どの順番で実行し、どこまで終えればよいかを定義します。
最優先：作業中のリポジトリにある指示書とユーザーの最新指示を優先してください。このページは汎用キットの入口であり、個別アプリの確定仕様を上書きしません。
1. 目的
このキットは、個別アプリの設定を1か所へ集め、Web・iPhone・Android・Chrome拡張の公開準備と確認を、再実行できる形で進めるためのテンプレートです。
このキットがしないこと
- ユーザーに代わってアプリの目的や価格を決定する
- 本人確認、契約、支払い、ストア審査の承認を代行する
- 未確認の外部状態を「完了」や「正常」と推測する
2. 読む順番
START-HERE.md— 人とAIの開始地点- リポジトリ直下の
CLAUDE.md/AGENTS.md— 作業規則 app.config.json— アプリ固有の入力値- 対象プラットフォームの説明書 — Web / iOS / Android / Chrome
- 現在の変更、診断結果、引き継ぎ文書 — 既存作業を壊さないため
ファイルが存在しない場合は、存在しないことを報告し、同等の情報源をリポジトリ内で探してください。名前だけを推測して作成しないでください。
3. 必要な入力
- アプリ名、短い説明、対象ユーザー
- 公開対象：Web / iPhone / Android / Chrome拡張
- 連絡先、運営者、公開ドメイン
- 課金の有無、広告の有無、扱うデータ
- 各ストアのアカウント・ID（取得済みのものだけ）
質問ルール：空欄を一度にすべて質問しないでください。現在の作業を止める入力だけを、理由と入力例を添えて1問ずつ確認します。仮の値を確定値として保存しません。
4. 実行手順
現状を読む
不足を分類
安全な作業を実行
検査・表示確認
人の作業を報告
- Git状態、既存ファイル、未完了作業を確認し、ユーザーの変更を保持する。
app.config.jsonを検証し、確定値・未入力・仮の値を分ける。- 対象プラットフォームだけを選び、自動化できる準備を実行する。
- ビルド、診断、リンク、公開ページを確認する。測れないものは未確認として残す。
- iPhone・Androidが対象なら、起動画面を生成して
npm run splash:checkを実行する。自動検査後も実機で1回目視する。 - Webを公開した場合は
npm run security:scoreを実行する。内部先取りと malwarecheck.site 本体の両方が100点になるまで、公開設定を修正して再実行する。 - 外部サービスへの送信・契約・課金・公開など、状態変更の前に必要な承認を確認する。
- 最後に、完了・未完了・問題・人が次に行うこと・確認URLをまとめる。
5. 禁止・安全上の境界
- 秘密情報、鍵、トークン、証明書の本文を公開ページ・ログ・回答へ出さない。
- ストア送信、料金発生、アカウント作成、外部への連絡を、許可なく行わない。
- 未計測・対象外・認証不足を、成功として扱わない。
- 既存の未コミット変更を消去・巻き戻し・上書きしない。
- 別アプリの固有値、ドメイン、ID、スクリーンショットを流用しない。
セキュリティ診断：malwarecheck.siteへ送るのは公開URLだけです。秘密情報やローカルファイルは送信しません。100点は外部から見える簡易診断の満点であり、安全性の保証ではありません。
6. 完了条件
- 対象プラットフォームとアプリ固有値が明確である。
- 必要な生成・設定・ビルド・診断が実行され、結果が確認できる。
- iPhone・Androidが対象なら、起動画面の自動検査が合格し、実機確認の結果または未確認が明記されている。
- 公開する場合は本番URLが表示でき、主要導線が動く。
- Web公開が対象なら、内部先取りと malwarecheck.site 本体のスコアが両方100点である。
- 人の作業とAIの作業が分離され、残作業に担当者が付いている。
- 未確認項目、既知の問題、制約を隠していない。
- 変更が再実行できる形でソースと説明書に残っている。
7. 最終報告の形式
結果：何が使える状態になったか 完了： - 実行して確認できたこと 未完了： - 残っていること／止まっている理由／担当 問題： - 見つかった問題と影響 次に人がすること： 1. 具体的な画面・操作・入力 確認URL： - 本体 - 更新情報と動作チェック