For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/web/feature-flags.md (or send Accept: text/markdown).
フィーチャーフラグとお知らせ
ダークローンチ、ワークスペース単位のゲート、メンバーへの告知。
初心者向けのウォークスルー
前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は apps/web/.env.local に属します。 Next.js はルート .env を読み取りません。デフォルトのフェイク モードの /dashboard はデータベースなしのデモです。 /auth には移行されたデータベースが必要です。
簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。
1. プラットフォーム管理者としてサインインし、/admin/flags を開きます。 1 つのテスト フラグを作成または選択し、明示的に有効に設定してから無効に設定します。
2. フラグを読み取る製品の表面を更新し、表示の変更を確認します。
3. フラグが有効になっている場合でも、役割と資格はサーバーのアクションを保護する必要があります。 API が無効になっている間もアクセス可能な場合は、意図した場所にサーバー側のフラグ チェックを追加します。
カスタム コードの場合は、提供された prompts/README.md から始めて、最も近いプロンプト (アプリ画面の場合は prompts/new-app-screen.md、パブリック ページの場合は prompts/new-landing-page.md) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディング エージェントにこのガイドのタスクを与え、AGENTS.md、.ai/PROJECT_CONTEXT.md、および一致する .ai/ ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。
【端末の基本】(/docs/web/terminal-basics)
管理者でフラグを設定する
/admin/flags および feature-flags.ts は、キットのフラグ管理/評価パスを提供します。フラグ設定はプラットフォーム管理者に属します。製品 UI は、フラグを変更する権限を取得せずに、許可された機能に反応できます。
有効な動作と無効な動作を確認する
デフォルト、欠落しているフラグ、更新、ロールの拒否、およびフラグゲートされたサーバーアクションをテストします。ロールアウト ロジックを追加するときにワークスペース アクセス チェックを保持します。
インストールとセットアップ
feature-flag-runtime は呼び出し元コンテキストに対してフラグを解決します：未設定のフラグは既定でオフ、フラグごとのオーバーライドは特定のワークスペースやユーザーを対象にできます。存在しないフラグが静かに面を有効化することはありません。
プラットフォーム告知（announcement-actions）は、メンバーがすでに読んでいる同じ通知面を通じてアプリ内通知を配信します——listActiveAnnouncements がバナーを供給し、dismissAnnouncementAction が却下を記録します。
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)実装ワークフロー
コードはダークで出荷します：フラグの後ろにマージし、自分のワークスペースで有効にしてから広げます。面が恒久的になったらフラグを削除してください——古いフラグは第二の真実の源になります。
サーバー境界とナビゲーションの両方でフラグを確認してください：リンクを隠してもルートが開いていればゲート済み機能ではありません。告知はトランザクショナルメール経路から外してください——製品ニュースであり領収書ではありません。
検証とトラブルシューティング
無効なフラグがナビ・ルート・アクションを端から端まで隠すこと、オーバーライドが対象にのみ解決されること、クリアされたフラグが既定に戻ることを確認します。告知配信が意図したワークスペースに届き、却下が持続することをテストしてください。