¿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:
- Técnicas de desviación — Métodos que fuerzan un pensamiento fresco
- Perspectivas múltiples — Diferentes modelos mentales que detectan cosas distintas
- 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:
| Perspectiva | Enfoque | Mejor Para |
|---|---|---|
| Arquitecto | Estructura, patrones, acoplamiento, cohesión | Diseño de sistemas, refactorización |
| Retador | Supuestos, riesgos, alternativas | Validación de decisiones, mitigación de riesgos |
| Oportunista | Nueva tecnología, atajos, simplificación | Optimización, reducción de deuda |
| Seguridad | Límites de confianza, modos de fallo | Seguridad, fiabilidad |
| Economista | Coste, complejidad, ROI | Asignación de recursos, priorización |
| Usuario | Usabilidad, valor, fricción | UX, decisiones de producto |
| Arqueólogo | Legado, deuda, historia | Comprensión, migración |
| Futurista | Tendencias, escalado, evolución | Planificació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:
- Modo Ojos Frescos: Ignorar deliberadamente la implementación existente. Preguntar: "¿Qué construiría si empezara desde cero, sabiendo solo el objetivo?"
- 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?
- 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:
- Acuerdos: En qué coinciden múltiples perspectivas (alta confianza)
- Desacuerdos: Dónde hay conflicto entre perspectivas (profundizar — estos revelan compromisos)
- Ideas Novedosas: Cosas que solo una perspectiva detectó
- 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 perspectivaagents/perspective.md— Instrucciones para subagentes que ejecutan análisis de perspectivas individualesagents/synthesizer.md— Instrucciones para un subagente de síntesis que combina múltiples resultados de perspectivas