Como implementar Feature Flags con Claude Code

Que son los Feature Flags

Los feature flags son un mecanismo que permite activar o desactivar funcionalidades incluso despues del despliegue del codigo. Es una tecnica esencial para lanzamientos graduales y pruebas A/B, y con Claude Code puede construir rapidamente una implementacion robusta.

Sistema basico de feature flags

> Crea un sistema de gestion de feature flags en TypeScript.
> Que soporte tambien flags condicionales basados en atributos del usuario.

type FlagValue = boolean | string | number;

interface FlagRule {
  conditions: Record<string, any>;
  value: FlagValue;
}

interface FeatureFlag {
  key: string;
  defaultValue: FlagValue;
  description: string;
  rules: FlagRule[];
  enabled: boolean;
}

class FeatureFlagManager {
  private flags: Map<string, FeatureFlag> = new Map();

  register(flag: FeatureFlag) {
    this.flags.set(flag.key, flag);
  }

  evaluate(key: string, context: Record<string, any> = {}): FlagValue {
    const flag = this.flags.get(key);
    if (!flag || !flag.enabled) return flag?.defaultValue ?? false;

    for (const rule of flag.rules) {
      if (this.matchConditions(rule.conditions, context)) {
        return rule.value;
      }
    }
    return flag.defaultValue;
  }

  private matchConditions(conditions: Record<string, any>, context: Record<string, any>): boolean {
    return Object.entries(conditions).every(([key, value]) => {
      if (Array.isArray(value)) return value.includes(context[key]);
      return context[key] === value;
    });
  }

  isEnabled(key: string, context?: Record<string, any>): boolean {
    return Boolean(this.evaluate(key, context));
  }
}

Implementacion de hook para React

> Crea un custom hook para usar feature flags en componentes React.

import { createContext, useContext, ReactNode } from 'react';

const FlagContext = createContext<FeatureFlagManager | null>(null);

export function FlagProvider({ manager, children }: { manager: FeatureFlagManager; children: ReactNode }) {
  return <FlagContext.Provider value={manager}>{children}</FlagContext.Provider>;
}

export function useFeatureFlag(key: string, context?: Record<string, any>): boolean {
  const manager = useContext(FlagContext);
  if (!manager) throw new Error('Se requiere FlagProvider');
  return manager.isEnabled(key, context);
}

// Ejemplo de uso
function NewDashboard() {
  const showNewUI = useFeatureFlag('new-dashboard', { userId: currentUser.id });

  if (showNewUI) {
    return <ModernDashboard />;
  }
  return <LegacyDashboard />;
}

Lanzamiento por porcentaje

Tambien puede implementar lanzamientos graduales que publican funcionalidades solo a un porcentaje especifico de usuarios.

function percentageRollout(userId: string, percentage: number): boolean {
  const hash = Array.from(userId).reduce((acc, char) => {
    return ((acc << 5) - acc + char.charCodeAt(0)) | 0;
  }, 0);
  return Math.abs(hash % 100) < percentage;
}

// Configurar porcentaje al registrar el flag
flagManager.register({
  key: 'new-checkout',
  defaultValue: false,
  description: 'Nuevo flujo de checkout',
  enabled: true,
  rules: [{
    conditions: { rolloutPercentage: 20 },
    value: true,
  }],
});

Panel de administracion de flags

Para facilitar las operaciones, tambien puede construir un mecanismo para gestionar el estado de los flags mediante API.

import express from 'express';

const router = express.Router();

router.get('/api/flags', (req, res) => {
  const flags = Array.from(flagManager.getAllFlags()).map(([key, flag]) => ({
    key,
    enabled: flag.enabled,
    description: flag.description,
  }));
  res.json(flags);
});

router.patch('/api/flags/:key', (req, res) => {
  const { enabled } = req.body;
  flagManager.setEnabled(req.params.key, enabled);
  res.json({ success: true });
});

Resumen

Al introducir feature flags, es posible realizar lanzamientos graduales seguros y reducir riesgos. Con Claude Code, puede generar de manera integral la logica de ramificacion condicional, hooks de React y APIs de administracion. Para la combinacion con pruebas A/B, consulte la guia de implementacion de pruebas A/B. Para el diseno de gestion de estado, consulte el articulo sobre gestion de estado.

Para patrones de diseno de feature flags, Martin Fowler - Feature Toggles ofrece informacion detallada.