オーバーシェアリングの防止
ビルダープロンプトは内部コンテキストであり、決して顧客向けコピーではありません。顧客向けインターフェースは、人間のプロダクトチームが書いたように読めるべきです。内部情報の漏洩ゼロ、無駄なサブタイトルゼロ、AIコピーライティングの痕跡ゼロを目指します。
対象範囲
- 厳格: UIコンポーネント、ランディングページ、価格設定、オンボーディング、設定、フォーム、モーダル、空状態、トースト、ローダー、エラー、ストアリスティング、SEOメタデータ。
- 冷静かつ事実ベース:
/privacy、/terms、/security、llms.txt、SDKドキュメント、チェンジログ(プレーンな技術的事実は許可。誇大表現や「~を置き換えるために追加」のようなメタナレーション、AIの決まり文句は禁止)。 - 対象外: コードコメント、コミットメッセージ、プルリクエスト、内部ドキュメント、管理者ビュー。
1. オーディエンスゲート
UIコピーを書く前に、プロンプトからのすべての事実を分類します。
- 削除(UIに0単語): レビューキュー(
in review、TestFlight、pending approval)、KYCやDNSのブロッカー、ストレージやデータベースの配管(localStorage、IndexedDB、SQLite、Redis、ベクターDB、モデル名)、ホスティングコストの理由、キーストア、散文内のパッケージIDやストアID、署名の言い訳。 - 翻訳: ビルダーのコンテキストを、落ち着いた顧客の言葉に書き換えます。
| 内部コンテキスト | 絶対に書かない | 代わりに書く |
|---|---|---|
| アプリまたは拡張機能がレビュー中 | In App Store review、Pending approval | Coming soon (ロードマップバッジのみ) |
| オフラインまたはブラウザストレージ | Stored in IndexedDB、No backend | 0単語 (またはヒーローにWorks offline) |
| AI検索とフォールバックLLM | Querying Pinecone vectors via Haiku fallback... | Ask your docs / Searching... |
| 課金またはSSOのブロッカー | Stripe KYC pending、SAML blocked | 出荷済みのパスを記載(Subscribe in app) |
| 署名されていないデスクトップビルド | Notarization pending; right-click Open | Direct download · macOS and Windows |
| 暗号化の配管 | Military-grade encryption outside DB | Encrypted sync (/privacyに詳細) |
| アプリまたはバンドル識別子 | com.acme.app、id1234567890 | 散文からは省略。ストアバッジのリンクのみ |
- 保持: 今日動作しているものと次のアクション。
references/translations.mdおよびreferences/leak-patterns.mdを参照。
2. 密度契約と見出しの繰り返しルール
見出しやラベルを繰り返すヘルパーテキストを削除します(Notifications -> 「通知を受け取る方法を設定」)。表示されているレイアウトを説明しない(「以下の表は…を比較しています」、「以下のフォームを使用して…」)。スカスカのカードにパディングを追加しない。
| スロット | 上限 | ルール |
|---|---|---|
| ヒーローサブタイトル | 1文、18語以内 | 成果とサポートプラットフォーム |
| ステータスバッジ | 1~3語 | ライブがデフォルト。バッジはComing soonのみ |
| プランバレット | 6語以内 | 出荷済み機能のみ |
| カードサブタイトル | 10語以内 (または0) | 見出しとボタンで十分な場合は省略 |
| 設定またはフォームのヘルパー | 0語 がデフォルト | 非自明な形式の場合のみ<= 10語 |
| 空状態 | 6語以内 + 1ボタン | データベース、テーブル、クエリの名詞はゼロ |
| トースト | 1~4語、!なし | Saved、Copied、Invite sent |
| 読み込み状態 | 1~3語 | Searching...、Generating... |
| エラー | 何が失敗したか + 次のステップ | HTTPコード、ルート、レートウィンドウはゼロ |
3. 反パラノイアルール
求められていない否定を自発的に行わない(「決してあなたのコンピューターを離れない」、「サーバーゼロ」、「100%ローカル」、「軍事グレード」)。データの取り扱いについては/privacyで冷静に開示する。
4. 人間らしい声
内部リークとともに、AIコピーライティングの人工的な痕跡を削除します。
- 「Xではなく、ただY」という対比は禁止: 否定の前置きを削除(「単なるメモアプリではなく、それは…」、「スピードのために作られ、肥大化のためにではない」、「無駄を省き、ただ…」)。製品が何をするかを直接述べる。
- 強制的な三連符やスタッカートスローガンは禁止: 三拍子の断片を削除(「速い。シンプル。パワフル。」、「計画。追跡。出荷。」)。三重項(「デザイン、コラボレーション、スケール」)を、1つの具体的な機能や数字に置き換える。
- UIコピーにemダッシュ(
—)やスペース入り--は禁止: ピリオド、カンマ、コロンを使用するか、2番目の節を削除する。 - AIの定番バズワードや
-ingの語尾を禁止:seamless、seamlessly、effortless、effortlessly、supercharge、unleash、elevate、empower、streamline、cutting-edge、next-generation、game-changing、robust、tailored、delve、tapestry、pivotal、reimagining、crafted for modern teams、およびむりやり接続された分詞(「…によりシームレスな同期を実現」)を禁止。serves asやboastsではなく、プレーンな動詞(is、has、syncs、exports)を優先。 - 装飾的な書式は禁止: 見出し、カードラベル、ボタンは文ケースで記述(固有名詞とプラン名のみタイトルケースを保持)。機能一覧や見出しに絵文字の箇条書き(
🚀、✨、⚡、🔒、💡、🎉)を決して使わない。機能一覧全体で**Bold Label:** 説明を繰り返さない。 - チャットボットや偽の元気なマイクロコピーを禁止: 段取りされたオープナー(「さっそく始めましょう」、「知っておくべきことはこちら」)、誇張された賞賛(「準備完了です!」、「素晴らしい!」)、偽の謝罪(「おっと!何か問題が発生しました」)、および日常的なUI状態での感嘆符を禁止。
5. 監査モードとレッドフラグ
python3 scripts/audit.py src/ app/ でソースツリーをスキャンし、フラグが立ったコピーを、単語を同義語に置き換えるのではなく具体的な事実に基づいて書き換えます。references/examples.md を参照。
即時書き換えが必要なレッドフラグ: in review、pending approval、localStorage、local storage、IndexedDB、no backend、vector embeddings、fallback model、rate limit、KYC、notarization、never leaves your、military-grade、散文内のパッケージID、設定サブタイトルの繰り返し、has been successfully saved、seamless、effortless、supercharge、unleash、not just a、スタッカート3語スローガン、絵文字機能箇条書き、括弧付きemダッシュ、Oops! Something went wrong、You're all set!。