¿Qué hace launchdarkly-flag-discovery?
Audita tus feature flags de LaunchDarkly para comprender el panorama, encontrar flags obsoletos o lanzados, y evaluar su preparación para eliminación. Útil cuando el usuario pregunta sobre deuda de flags, flags obsoletos, candidatos para limpieza, salud de flags o desea conocer su inventario de flags.
Descripción general
Esta habilidad te ayuda a realizar una auditoría de tus feature flags en LaunchDarkly. Obtiene una visión completa de todos los flags en tu organización y los clasifica según su estado, antigüedad y uso. Esto te permite identificar:
- Flags obsoletos (sin cambios recientes, en estado
live) - Flags lanzados (sin targeting activo o sin variaciones personalizadas)
- Flags archivados o en borrador
- Posibles dependencias entre flags
- Recomendaciones para limpieza
Cómo funciona
La habilidad realiza lo siguiente:
- Consulta la API de LaunchDarkly para obtener la lista completa de flags en tu organización.
- Analiza cada flag según su metadata: estado (
live,archived,draft), fecha de última modificación, configuraciones de targeting y variaciones. - Clasifica los flags en las siguientes categorías:
archived: Flags que ya han sido archivados.draft: Flags que están en modo borrador.stale: Flags en estadoliveque no han sido modificados en más de 30 días (configurable).launched: Flags en estadoliveque no tienen targeting habilitado o que tienen una sola variación (indicativo de que la funcionalidad ya se lanzó por completo).healthy: Flags que no entran en ninguna categoría anterior.cleanup_candidates: Flags que son obsoletos y además lanzados (combinación de ambas condiciones).
- Identifica dependencias entre flags (por ejemplo, si un flag depende de otro para activarse).
- Genera un informe estructurado con conteos, tablas detalladas (incluyendo nombre del flag, estado, última modificación, y razón de clasificación) y recomendaciones accionables.
Soporte de plataformas
Esta habilidad está diseñada para ser utilizada en agentes de IA como:
- Claude Code (Anthropic)
- Cursor
- Codex (GitHub Copilot)
- Cualquier otro agente que soporte habilidades markdown.
Requisitos previos
Para usar esta habilidad, necesitas:
-
Una cuenta de LaunchDarkly con acceso a la organización.
-
Un token de API de LaunchDarkly con permisos de lectura (
Readero superior). El token debe configurarse como variable de entorno:export LAUNCHDARKLY_API_KEY="tu-token-api" -
Alternativamente, el agente puede solicitar el token al usuario durante la ejecución.
Ejemplo de uso
Caso 1: Auditoría general
"Audita mis flags de LaunchDarkly"
El agente ejecutará la habilidad y devolverá un resumen como:
## Resumen de auditoría de flags
- **Total de flags**: 45
- **Archivados**: 5
- **Borradores**: 3
- **Obsoletos (>30 días sin cambios)**: 12
- **Lanzados (sin targeting)**: 8
- **Saludables**: 17
- **Candidatos para limpieza**: 6
### Tabla de candidatos para limpieza
| Nombre del flag | Estado | Última modificación | Razón |
|---|---|---|---|
| `feature-new-ui` | live | 2024-01-15 | Obsoleto y lanzado |
| `old-payment-flow` | live | 2023-11-20 | Obsoleto y lanzado |
...
Caso 2: Flags obsoletos
"Muéstrame flags obsoletos"
El agente filtrará los flags con estado stale y devolverá los detalles.
Caso 3: Dependencias
"¿Hay dependencias entre flags?"
El agente listará los flags que tienen dependencias definidas, si las hay.
Limitaciones
- La habilidad depende de la metadata disponible en la API de LaunchDarkly. No puede detectar el uso de flags en código fuente (solo análisis de configuración).
- Los umbrales de antigüedad (como "30 días") son configurables; por defecto se usan 30 días para considerar un flag como obsoleto.
- Las dependencias entre flags solo se detectan si están explícitamente definidas en LaunchDarkly.
Notas adicionales
- Los resultados se devuelven en formato markdown para fácil lectura.
- Se recomienda ejecutar esta habilidad periódicamente para mantener el inventario de flags limpio.
- Para flags obsoletos, la recomendación es considerar su eliminación después de revisar que no haya código dependiente.
Habilidad generada para agentes de IA.