feature-flag-patterns

name	feature-flag-patterns
description	機能フラグ（Feature Flag/Feature Toggle）による段階的リリースとA/Bテスト実装スキル。 リスク管理とカナリアリリースを可能にし、本番環境での安全な機能展開を実現します。 Anchors: • Feature Toggles (Pete Hodgson - Martin Fowler blog) / 適用: フラグ設計パターン / 目的: Release/Experiment/Ops/Permission Togglesの適切な使い分け • Continuous Delivery (Jez Humble) / 適用: デプロイ戦略 / 目的: デプロイと機能リリースの分離による安全性向上 Trigger: Use when implementing feature flags, feature toggles, A/B testing, gradual rollouts, canary releases, or managing feature lifecycles. feature flag, feature toggle, A/B testing, canary release, gradual rollout, dark launch, percentage rollout, kill switch
allowed-tools	["Read","Write","Edit","Bash","Glob","Grep","Task"]
tags	["deployment","release-management","feature-management","devops"]

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	起動タイミング	入力	出力
design-flag	Phase 1開始時	機能要件	フラグ設計書
implement-flag	Phase 2開始時	フラグ設計書	実装コード＋テスト
rollout-flag	Phase 3開始時	実装コード	ロールアウト計画＋設定
manage-flags	Phase 4開始時	既存フラグ一覧	クリーンアップ計画

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

---

ベストプラクティス

すべきこと

推奨事項	理由
フラグに有効期限を設定	テクニカルデット防止
デフォルト値を安全な状態に	フラグサービス障害時の安全性確保
フラグ評価ログを記録	デバッグとトラブルシューティング支援
段階的ロールアウト実施	リスク最小化（1%→10%→50%→100%）
Kill Switchを準備	緊急時の即座な機能無効化
フラグごとにオーナーを指定	責任の明確化とクリーンアップ促進

避けるべきこと

禁止事項	問題点
フラグのネスト	複雑性の爆発的増加（2^n の組み合わせ）
ビジネスロジックへの埋め込み	コードの可読性低下
無期限のフラグ保持	テクニカルデットの蓄積
フラグなしでのテスト	全状態の検証漏れ
フラグ命名の不統一	管理の困難化

---

リソース参照

references/（詳細知識）

リソース	パス	読込条件
基礎概念	references/Level1_basics.md	初回利用時
実装パターン	references/Level2_intermediate.md	実装時
高度な戦略	references/Level3_advanced.md	複雑なロールアウト時
エキスパートパターン	references/Level4_expert.md	スケール・最適化時
実装パターン詳細	references/implementation-patterns.md	Phase 2実行時
ロールアウト戦略	references/rollout-strategies.md	Phase 3実行時
フラグタイプリファレンス	references/flag-types.md	フラグタイプ選択時
アンチパターン集	references/anti-patterns.md	設計レビュー時

scripts/（決定論的処理）

スクリプト	機能
scripts/audit-flags.mjs	フラグ一覧の監査と分析
scripts/validate-flag.mjs	フラグ定義の検証
scripts/log_usage.mjs	フィードバック記録

assets/（テンプレート）

アセット	用途
assets/flag-template.ts	TypeScript フラグ定義
assets/flag-config-schema.json	フラグ設定のJSON Schema
assets/rollout-plan.md	ロールアウト計画テンプレート

---

変更履歴

Version	Date	Changes
1.0.0	2025-12-31	初版作成。18-skills.md完全準拠版。