waitlist-launch — 候補名單站上線プロセス は何をしますか?
fare-waitlist 実戦から抽出(2026-07, early-fare.hengshiou.com、参考実装:
/Users/xiuxiu/Documents/個人事宜/1_Projects/fare-waitlist)。
コアコンセプト:KV が名簿の唯一の真値、スパム対策に KV write を使わない、公開設定はすべて runtime var、
アナリティクスがないうちはトラフィックを流さない、コピーは逆営業で信頼を構築
三つのロール別ドキュメント(必要に応じて読み込み、一度に全部読まないこと)
| ファイル | ロール | いつ読むか |
|---|---|---|
references/architecture.md | 情報アーキテクト | 開発着手時に必読:事前インタビューリスト、6フェーズプロセス、API/KV 契約(そのまま流用可)、var vs secret の境界、ツール権限表、検証マニュアル、既知の落とし穴 |
references/copywriting.md | マーケティング担当 | ページコピー、シェア用コピー、OG 画像、トラフィックチャネル計画作成時に読む:H1 痛点表現、lede 構造、同意フォーム、逆営業ガイド、チャネルプレイブック + ref アトリビューションコード |
references/operations.md | プロダクトマネージャー | リリース前検収とリリース後運用時に読む:ゲートチェックリスト(必須/推奨の2段階)、成功指標と虚栄指標、エンゲージメント維持のリズム、意思決定の境界、イテレーションバックログテンプレート |
実行プロセス(オーケストレーター視点)
- 事前インタビュー:
architecture.md§1 の9つの質問をユーザーに行い、回答が得られなければ作業を開始しない。 特に注意:コミュニティハンドルは必ず検証すること(ユーザーの既存サイトのソースコードを grep するか、本人に確認してもらう)。モデルの記憶で推測してはいけない。 - 現状調査:既存のリポジトリの場合は、まず
git logで確認する。wrangler のログインアカウントと zone 権限を確認する。 - フェーズ別実装(詳細手順、Done の定義は
architecture.md§2 参照):- フェーズ1 基本サイト構築(Worker + assets + KV + custom domain)
- フェーズ2 Resend 名簿同期(best-effort + ops/sync で冪等にバックフィル)
- フェーズ3 スパム対策3層(ハニーポット → ネイティブレート制限 → Turnstile、すべて KV write を使わない)
- フェーズ4 個人ブランド footer(控えめに、CTA より視覚的重みを低く)
- フェーズ5 露出層(og:image → referral → analytics、この順番で、すべて index.html を変更)
- フェーズ6 デプロイ検証(smoke チェックリスト + cache-buster)
- コピー:すべてのコピー箇所(H1/lede/bullets/consent/証明カード/シェア用コピー)に
copywriting.mdの公式を適用する。 誠実な説得回避文は必ず本物でなければならない。 - リリースゲート:
operations.md§1 に従い、各項目をチェックする。「必須」レベルの項目が1つでも合格しなければリリースしない。 アナリティクスがないうちはトラフィックを流さない。 - リリース後:チャネルに ref コードを付けてアトリビューション(
copywriting.md§4)、名簿が100を超えたらエンゲージメント維持、 社会的証明の人数が閾値を超えたら表示する(operations.md§3)。
タスクディスパッチのルール(複数 subagent の場合)
- 複数のタスクが同じファイルを変更する場合(典型的には、露出層の3つのサブタスクがすべて index.html を変更)→ 順番にタスクを割り当て、並行実行しないこと。
- 各 subagent へのタスク指示には必ず:変更して良いファイルのみ、Done の定義、実測の証拠(スクリーンショット/curl 出力)を添付するよう要求、 コミットもデプロイも禁止。
- オーケストレーターはタスクごとに diff を検収し、重要な成果物を目視確認(画像は必ず Read で確認する)、タスクごとにコミットする。 すべて完了したらまとめてデプロイ + オンライン smoke テストを実行する。
- 報告は4つのことを伝える:ブランチ、コミットハッシュ、デプロイ済みかどうか、ワークツリーをクリーンアップしたかどうか。
ユーザーが手動で行う必要があること(自動化不可、事前に伝える)
- CF ダッシュボードで Turnstile site を作成(site key + secret を取得)
- CF ダッシュボードで Web Analytics site を作成(beacon token を取得。wrangler OAuth には RUM 権限がなく、API では作成不可)
- Resend:オーディエンスを作成、専用の API key を生成(他サイトから流用しない)、送信ドメインの DNS 検証
- Custom domain を初めて設定する場合、ダッシュボードで DNS/証明書を確認する必要がある場合がある
コードは runtime var モードで事前に記述しておく(/api/health が動的にフロントエンドに提供)。上記の認証情報が準備でき次第、var/secret を入力し、再デプロイするだけで有効になる – コードの変更は不要。これにより「認証情報待ち」が開発をブロックしない。
最もハマりやすい落とし穴(完全なリストは architecture.md §5.3 を参照)
- Headless Chrome で OG 画像をキャプチャする際:
--force-device-scale-factor=1(Retina だと 2x になってしまう)+--virtual-time-budget=4000(Web フォントの読み込みを待つ)。キャプチャ後は必ず目視確認する(フォールバックフォント、見出しの orphan 行)。 - デプロイ後にエッジキャッシュが古い HTML を返す →
?cb=<timestamp>で検証する。 - 本番環境で Turnstile が有効だと、curl で
/api/joinをテストできない → 契約テスト(正常/重複/ハニーポットの3ケース)はローカルのwrangler devでのみ行う(secret がなければ自動的にスキップされる)。 - ハニーポット/レート制限に引っかかった場合は、ソフトに成功を返すが、refCode は返さない(ボットに情報を与えない)。既に名簿にある場合は、already と同一の refCode を返す(冪等)。
- 平文の API key が会話やファイルに現れた → 直ちに secret に変更する。