Communitygithub.com

Council — Análisis Multiperspectiva

Un framework de análisis multiperspectiva que proporciona una evaluación objetiva y sin sesgos de codebases, proyectos y documentación. Utiliza múltiples puntos de vista y técnicas de desviación para superar la tendencia a anclarse en el código existente.

¿Qué es Council — Análisis Multiperspectiva?

Council es un framework de análisis diseñado para ayudar a desarrolladores y equipos a evaluar de manera objetiva codebases, proyectos y documentación, superando el sesgo de confirmación que tiende a anclarse en el código existente. A diferencia de las revisiones tradicionales, Council emplea múltiples perspectivas (Arquitecto, Retador, Oportunista, Seguridad, Economista, Usuario, Arqueólogo, Futurista) junto con técnicas de desviación como el 'Modo Ojos Frescos', 'Modo Desafío' y 'Modo Reconstrucción'. El flujo de ejecución consta de cuatro fases: Scout (recopilación de hechos), Generar Perspectivas (aplicación de perspectivas en paralelo o secuencial), Sintetizar (combinación de acuerdos, desacuerdos e ideas novedosas) y Validar (verificación de consistencia y supuestos). Council es agnóstico al modelo de IA y se puede ejecutar en plataformas como Claude Code, Cursor, Codex, entre otras, ofreciendo informes estructurados con recomendaciones priorizadas por impacto y confianza. Es especialmente útil para explorar alternativas, identificar supuestos ocultos, tomar decisiones importantes o salir de óptimos locales.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add adulari/forge

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Council — Análisis Multiperspectiva?

Un framework de análisis multiperspectiva que proporciona una evaluación objetiva y sin sesgos de codebases, proyectos y documentación. Utiliza múltiples puntos de vista y técnicas de desviación para superar la tendencia a anclarse en el código existente.

El Problema que Resuelve

Las herramientas de IA (y los humanos) tienden a anclarse en el código existente. Ven lo que ES y luchan por imaginar lo que PODRÍA SER. Validan en lugar de explorar. Council utiliza:

  1. Técnicas de desviación — Métodos que fuerzan un pensamiento fresco
  2. Perspectivas múltiples — Diferentes modelos mentales que detectan cosas distintas
  3. Síntesis estructurada — Combinación de ideas mientras se rastrean los desacuerdos

Cuándo Usarlo

  • Evaluar si el enfoque actual sigue siendo óptimo
  • Explorar alternativas a la implementación existente
  • Identificar supuestos ocultos en tu proyecto
  • Obtener retroalimentación objetiva antes de decisiones importantes
  • Cuando estás atascado en un óptimo local
  • Cuando sospechas que podría haber una mejor manera pero no la ves
  • Cuando las herramientas de IA siguen repitiendo tus patrones existentes

Entrada

El usuario proporciona:

  • Objetivo: Ruta del repositorio, documentación o descripción de un problema específico
  • Meta (opcional): Cómo se ve el éxito (ej., "maximizar la rentabilidad")
  • Restricciones (opcional): Qué debe preservarse (ej., "debe usar el modelo de datos existente")

Flujo de Ejecución

Fase 1: Exploración

Leer y comprender el objetivo a fondo. Documentar:

  • Qué hace el proyecto
  • Cómo está estructurado actualmente
  • Qué restricciones existen
  • Cuáles son los objetivos declarados

NO formar opiniones todavía. Solo recopilar datos.

Fase 2: Generar Perspectivas

Seleccionar de 3 a 5 perspectivas relevantes según el objetivo:

PerspectivaEnfoqueMejor Para
ArquitectoEstructura, patrones, acoplamiento, cohesiónDiseño de sistemas, refactorización
RetadorSupuestos, riesgos, alternativasValidación de decisiones, mitigación de riesgos
OportunistaNueva tecnología, atajos, simplificaciónOptimización, reducción de deuda
SeguridadLímites de confianza, modos de falloSeguridad, fiabilidad
EconomistaCoste, complejidad, ROIAsignación de recursos, priorización
UsuarioUsabilidad, valor, fricciónUX, decisiones de producto
ArqueólogoLegado, deuda, historiaComprensión, migración
FuturistaTendencias, escalado, evoluciónPlanificación a largo plazo

Para objetivos complejos, usar spawn_agents para ejecutar perspectivas en paralelo — cada agente trabaja de forma independiente para evitar el pensamiento grupal, luego los resultados se combinan en la Fase 3.

Para objetivos más simples, ejecutar perspectivas secuencialmente en un solo agente.

Cada perspectiva aplica estas técnicas de desviación:

  1. Modo Ojos Frescos: Ignorar deliberadamente la implementación existente. Preguntar: "¿Qué construiría si empezara desde cero, sabiendo solo el objetivo?"
  2. Modo Desafío: Cuestionar cada supuesto. ¿Por qué existe este componente? ¿Qué pasaría si lo elimináramos? ¿Qué pasaría si lo contrario fuera cierto?
  3. Modo Reconstrucción: "Si tuviera que resolver esto desde cero con el conocimiento actual, ¿qué haría diferente?"

Ver references/debiasing.md para técnicas de desviación detalladas y prompts.

Fase 3: Sintetizar

Combinar perspectivas en una salida estructurada:

  1. Acuerdos: En qué coinciden múltiples perspectivas (alta confianza)
  2. Desacuerdos: Dónde hay conflicto entre perspectivas (profundizar — estos revelan compromisos)
  3. Ideas Novedosas: Cosas que solo una perspectiva detectó
  4. Recomendaciones Priorizadas: Clasificadas por impacto y confianza

Ver agents/synthesizer.md para instrucciones detalladas de síntesis cuando se usan subagentes.

Fase 4: Validar

  • Verificar que las recomendaciones no se contradicen entre sí
  • Señalar cualquier supuesto que no haya sido validado
  • Identificar qué información cambiaría las conclusiones

Formato de Salida

# Informe Council: [Objetivo]

## Resumen Ejecutivo
[Evaluación objetiva de 2-3 oraciones — no un resumen de lo que se hizo, sino un veredicto]

## Hallazgos Clave

### [Nombre del Hallazgo]
- **Qué**: [Descripción clara del hallazgo]
- **Perspectivas que coinciden**: [Lista]
- **Perspectivas que discrepan**: [Lista + breve razón]
- **Confianza**: [Alta/Media/Baja]
- **Evidencia**: [Archivo:línea específico, métrica u observación]

## Recomendaciones

### [ALTO IMPACTO] [Título de la Recomendación]
- **Problema abordado**: [El hallazgo que soluciona]
- **Solución**: [Acción concreta]
- **Impacto esperado**: [Qué mejora y en cuánto]
- **Esfuerzo**: [Bajo/Medio/Alto]
- **Riesgo**: [Bajo/Medio/Alto]
- **Perspectivas que apoyan**: [Lista]

### [MEDIO IMPACTO] ...

### [BAJO IMPACTO] ...

## Enfoques Alternativos Considerados

| Enfoque | Pros | Contras | Veredicto |
|---------|------|---------|-----------|
| ...     | ...  | ...     | Mantener/Reemplazar/Explorar más |

## Qué Cambiaría Esta Evaluación
- Si [X] es cierto, entonces [la recomendación Y cambia]
- [Supuesto no validado que importa]

Recursos Incluidos

  • references/debiasing.md — Técnicas de desviación detalladas y prompts por tipo de perspectiva
  • agents/perspective.md — Instrucciones para subagentes que ejecutan análisis de perspectivas individuales
  • agents/synthesizer.md — Instrucciones para un subagente de síntesis que combina múltiples resultados de perspectivas

Skills relacionados