feature-flag-patterns

概要

機能フラグによる段階的リリースとA/Bテスト実装スキル。 デプロイと機能リリースを分離し、本番環境でのリスクを最小化する。

ワークフロー

Phase 1: フラグ設計

目的: 機能フラグの種類・スコープ・ライフサイクルを決定

アクション:

1. 機能要件から適切なフラグタイプを選択（Release/Experiment/Ops/Permission）
2. フラグのスコープを決定（global/user/organization/request）
3. ライフサイクル計画を策定（一時的 vs 長期的）
4. 必要なリソースレベル（Level 1-4）を判定

Task: agents/design-flag.md を参照

Phase 2: フラグ実装

目的: 選択されたパターンに基づいてフラグを実装

アクション:

1. assets/flag-template.ts を使用してフラグ定義を作成
2. references/implementation-patterns.md でパターンを確認
3. フラグ評価ロジックを実装（クライアント/サーバー）
4. テストケースを作成（全状態をカバー）

Task: agents/implement-flag.md を参照

Phase 3: 段階的ロールアウト

目的: 安全な段階的リリース戦略の実行

アクション:

1. references/rollout-strategies.md でロールアウト戦略を選択
2. パーセンテージベースまたはコホートベースの展開を実装
3. メトリクス収集とモニタリングを設定
4. ロールバック手順を準備

Task: agents/rollout-flag.md を参照

Phase 4: フラグ管理とクリーンアップ

目的: フラグライフサイクル管理とテクニカルデット防止

アクション:

1. scripts/audit-flags.mjs でフラグ一覧を監査
2. 古いフラグや不要なフラグを特定
3. フラグ削除計画を策定
4. scripts/log_usage.mjs で使用記録を保存

Task: agents/manage-flags.md を参照

Task仕様ナビ

詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照

ベストプラクティス

すべきこと

避けるべきこと

リソース参照

references/（詳細知識）

scripts/（決定論的処理）

assets/（テンプレート）

変更履歴