agentleFS
joobidjoobid/CPS-skills/complex-problem-solving/SKILL.md

complex-problem-solving

Skill14 starsChanged 8 months agoMITView on GitHub

Complex Problem Solving (CPS) methodology integrating Nardone, Cynefin, Rumelt, Meadows, Kahneman, De Bono, Wardley Mapping and JTBD. Use this skill ALWAYS when the user asks to: analyze a complex problem, diagnose a situation, design a strategy, evaluate alternatives, solve a business or technology challenge, kick off a complex project, analyze organizational transformation, or any task involving uncertainty, multiple root causes, conflicting stakeholders, or ambiguous information. Also trigger on: "CPS", "problem solving", "root cause", "diagnóstico", "análisis de situación", "qué está fallando", "por qué no funciona", "evaluar opciones", "tomar una decisión difícil", "cómo resolver". Works in Spanish and English.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. Goodnessmbakara/codex-skills★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No buscar UNA causa raíz. Buscar la constelación de factores que mantiene vivo el problema.

    line 130
  2. Distinctive:

    No necesitamos resolver todo de golpe.

    line 224
  3. Distinctive:

    No usar en dominio Complejo donde se necesita experimentación.

    line 299
  4. Distinctive:

    Los problemas complejos tienen múltiples causas raíz: No simplificar prematuramente.

    line 376
  5. Distinctive:

    No leerlos todos al inicio — eso sería ineficiente y cargaría contexto innecesariamente.

    line 389

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Complex Problem Solving (CPS)

Skill de Resolución de Problemas Complejos que aplica una metodología integrada con las mejores herramientas de análisis estratégico, pensamiento sistémico y creatividad estructurada.

Eje metodológico central: Problem Solving Estratégico de Giorgio Nardone — entender qué mantiene el problema, romper el ciclo de soluciones fallidas, y avanzar con experimentación controlada.

Complementado por: Cynefin (Snowden), Pensamiento Sistémico (Meadows), Estrategia (Rumelt), Sesgos Cognitivos (Kahneman/Munger), Creatividad (De Bono/Damas), Wardley Mapping, Jobs to Be Done, Team of Teams (McChrystal), y la escuela de CPS de Javier Recuenco.


Cómo arrancar: Menú de 3 niveles

Cuando esta skill se active, lo PRIMERO es preguntar al usuario qué nivel de profundidad necesita. Presenta exactamente estas tres opciones:

Nivel 1 — Análisis Rápido (~5-10 min de lectura) Cubre: Clasificación del problema + Definición rigurosa + Causas raíz principales + Primeras recomendaciones. Formato: Respuesta conversacional en el chat. Ideal para: Consultas rápidas, primeras impresiones, validar si estamos ante un problema complejo.

Nivel 2 — Análisis Estándar (~15-25 min de lectura) Cubre: Fases 0 a 5 (Clasificación → Diagnóstico → Causas → Sesgos → Soluciones → Evaluación estratégica). Formato: Respuesta estructurada en el chat o documento breve según prefiera el usuario. Ideal para: Análisis de situación, preparación de decisiones, arranque de proyectos.

Nivel 3 — Análisis Completo (~30-60 min de lectura) Cubre: Las 7 fases completas con herramientas detalladas + documento entregable. Formato: Documento (.docx o .md) con análisis completo. Ideal para: Proyectos estratégicos, transformaciones, problemas persistentes que resisten soluciones convencionales.

Tras elegir el nivel, confirmar el idioma (español/inglés) si no es evidente por contexto.


Las 7 Fases del CPS

FASE 0 — Clasificación del Problema

Propósito: Antes de analizar nada, necesitamos saber a qué tipo de problema nos enfrentamos, porque la metodología correcta depende del tipo de problema. Usar la herramienta equivocada es peor que no usar ninguna.

Aplicar el framework Cynefin (Snowden):

DominioSeñalesEnfoque correcto
Simple/ClaroCausa-efecto evidente, existen mejores prácticasPercibir → Categorizar → Responder
ComplicadoRequiere análisis experto, múltiples respuestas válidasPercibir → Analizar → Responder
ComplejoCausa-efecto solo visible en retrospectiva, emergenciaProbar → Percibir → Responder
CaóticoCrisis, no hay relación causa-efecto aparenteActuar → Percibir → Responder
DesordenNo sabemos en qué dominio estamosDescomponer y clasificar cada parte

Criterio práctico (Recuenco): Si el problema fuera sencillo, ya estaría resuelto. La mayoría de problemas que llegan a un análisis CPS son complejos con múltiples causas raíz (complex rooting). Asumir complejidad como hipótesis inicial y descartarla si el análisis lo justifica.

Para profundizar en este framework: leer references/01_clasificacion_cynefin.md.


FASE 1 — Definición Rigurosa del Problema (Diagnóstico)

Propósito: Entender QUÉ está pasando realmente antes de proponer nada. Esta es la fase más importante de todo el proceso. La inmensa mayoría de fracasos en resolución de problemas vienen de una mala definición, no de malas soluciones.

Principio Nardone: "No puedes resolver un problema que no comprendes. Y comprender un problema exige entender qué lo mantiene vivo."

Principio Rumelt: "La diagnosis es la esencia de la estrategia. Sin ella, solo hay ilusión."

Paso 1.1 — Reductor de complejidad (Nardone/Recuenco)

Responder estas preguntas con la máxima concreción:

  1. ¿En QUÉ consiste el problema? — Describir comportamientos observables, no interpretaciones.
  2. ¿QUIÉN está implicado? — Todos los actores, incluyendo los que no están en la mesa.
  3. ¿DÓNDE se produce? — Contextos geográficos, organizacionales, de mercado.
  4. ¿CUÁNDO se produce? — ¿Siempre? ¿En ciertos momentos? ¿Desde cuándo?
  5. ¿CÓMO funciona? — Mecánica del problema, secuencia de eventos.
  6. ¿Cómo lo perciben los demás? — Perspectivas de los diferentes stakeholders.

Paso 1.2 — Soluciones Intentadas Redundantes (Nardone)

Esta es una de las herramientas más poderosas del arsenal. La idea central es: la mayoría de problemas persisten no a pesar de los intentos de solución, sino A CAUSA de ellos.

Preguntar:

  • ¿Qué se ha intentado hacer hasta ahora para resolver esto?
  • ¿Qué pasó? ¿Por qué no funcionó?
  • ¿Se ha repetido alguna solución que no funciona ("más de lo mismo")?
  • ¿Hay un patrón en los intentos fallidos?

La clave es que el patrón de soluciones fallidas REVELA la estructura del problema. Si todos los intentos van en la misma dirección y fracasan, la solución real probablemente esté en una dirección diferente.

Paso 1.3 — Herramientas complementarias (según necesidad)

Si el problema lo requiere, profundizar con estas herramientas (ver references/02_diagnostico_herramientas.md):

  • CATWOE: Customers, Actors, Transformation, Worldview, Owner, Environment — Para problemas organizacionales.
  • IS/IS NOT (Kepner-Tregoe): Para aislar qué es exactamente el problema y qué no es.
  • Jobs to Be Done: Para problemas de producto/mercado — ¿qué trabajo intenta hacer el usuario/cliente? (ver references/09_jtbd_wardley.md)
  • Pensamiento Sistémico: Stocks, flujos, bucles de retroalimentación, arquetipos sistémicos (ver references/03_analisis_causal.md)

FASE 2 — Análisis de Causas Raíz

Propósito: Ir más allá de los síntomas para encontrar las causas profundas. Pero con una advertencia importante.

Advertencia (Recuenco): Los problemas complejos tienen múltiples causas raíz (complex rooting). No buscar UNA causa raíz. Buscar la constelación de factores que mantiene vivo el problema.

Advertencia (Nardone): A veces la "causa raíz" es irrelevante para la solución. Lo que importa es entender qué mantiene el problema AHORA, no necesariamente qué lo originó. Un dolor de espalda puede haberse originado por una mala postura hace 10 años, pero lo que lo mantiene hoy es un patrón de compensación muscular.

Herramientas de análisis causal

Elegir las más apropiadas según el tipo de problema (detalle en references/03_analisis_causal.md):

  1. 5 Porqués: Cadena causal iterativa. Simple pero poderosa para problemas con causalidad lineal. Ojo: en problemas complejos, cada "por qué" puede bifurcarse en múltiples ramas.
  2. Diagrama de Ishikawa (Espina de Pescado): Mapa visual de causas organizadas por categorías. Categorías clásicas: Personas, Procesos, Tecnología, Entorno, Materiales, Medición.
  3. Árboles Lógicos (Watanabe): Descomposición MECE (Mutuamente Excluyente, Colectivamente Exhaustiva). Particularmente útil cuando el problema es grande y necesita trocearse.
  4. Puntos de Apalancamiento (Meadows): ¿Dónde intervenir para máximo efecto? Desde parámetros superficiales hasta cambios de paradigma. La tentación es intervenir donde es fácil (parámetros), pero el impacto real suele estar en niveles más profundos (reglas, metas, paradigmas).
  5. Wardley Mapping: Para problemas con componente tecnológico o de posicionamiento estratégico. Mapear la cadena de valor, identificar la evolución de cada componente, y encontrar dónde actuar. (ver references/09_jtbd_wardley.md)

FASE 3 — Auditoría de Sesgos y Pensamiento Crítico

Propósito: Verificar que nuestro propio análisis no está contaminado por trampas cognitivas. Esta fase es incómoda pero esencial: consiste en cuestionar lo que creemos saber.

Fundamento (Kahneman): El Sistema 1 (rápido, intuitivo) domina nuestras decisiones y produce errores sistemáticos. El CPS requiere activar deliberadamente el Sistema 2 (lento, analítico). El problema es que el Sistema 2 es "perezoso" y se resiste a activarse.

Fundamento (Munger): "Invierte siempre. Piensa al revés." Si no puedes refutar tu propia hipótesis, probablemente no la entiendes lo suficiente.

Checklist de sesgos (aplicar al análisis realizado en Fases 1-2)

Para cada conclusión del diagnóstico, verificar:

  • Sesgo de confirmación: ¿Estamos buscando solo evidencia que confirma nuestra hipótesis?
  • Anclaje: ¿La primera información recibida está distorsionando todo el análisis?
  • Disponibilidad: ¿Estamos sobrevalorando información reciente o memorable?
  • Coste hundido: ¿Inversiones pasadas están contaminando decisiones futuras?
  • Efecto halo: ¿El éxito en un área nos hace asumir éxito en otra?
  • Sesgo del superviviente: ¿Estamos mirando solo los casos de éxito?
  • Exceso de confianza: ¿Sabemos realmente lo que creemos saber?
  • Falso consenso: ¿Asumimos que todos piensan como nosotros?

Técnica de inversión (Munger/Nardone)

Invertir el problema: ¿Qué tendríamos que hacer para GARANTIZAR que este problema empeore? Las respuestas revelan las fuerzas que mantienen el problema y los errores que debemos evitar.

Detalle completo en references/04_sesgos_pensamiento.md.


FASE 4 — Generación de Soluciones

Propósito: Producir el mayor número de opciones posibles ANTES de evaluar ninguna.

Regla de oro (Damas): Separar ESTRICTAMENTE tres tipos de pensamiento. Nunca mezclarlos en la misma conversación o sesión de trabajo:

  1. Pensamiento Creativo — proponer opciones sin juzgarlas
  2. Pensamiento Crítico-Defensivo — anticipar consecuencias negativas (DESPUÉS, no durante)
  3. Pensamiento Operativo — decidir y planificar (AL FINAL)

La contaminación más peligrosa es cuando el pensamiento defensivo entra durante la fase creativa ("eso no va a funcionar", "eso es imposible"). Mata la creatividad antes de que nazca.

Técnicas de Nardone (eje central)

  1. Técnica "Cómo Empeorar": Preguntar: "¿Qué tendríamos que hacer para empeorar voluntariamente esta situación?" Parece absurdo, pero es extraordinariamente revelador: la respuesta muestra la estructura del problema y lo que realmente lo mantiene vivo. Las soluciones suelen estar en hacer LO CONTRARIO de lo que empeora.
  2. Técnica "Más Allá del Problema": Imaginar que el problema ya se resolvió. "Si mañana nos despertáramos y el problema hubiera desaparecido, ¿qué sería diferente? ¿Qué haríamos que hoy no hacemos?" Esto define el estado deseado y revela acciones que podemos empezar a tomar ya.
  3. Técnica del Escalador: Planificar DESDE la cima hacia la base. Definir el objetivo final, luego el paso inmediatamente anterior, y así hacia atrás hasta el presente. Esto evita quedarse atrapado en la complejidad del camino.
  4. Técnica de Pequeños Pasos: Identificar micro-acciones de bajo riesgo para testar hipótesis. No necesitamos resolver todo de golpe; necesitamos aprender rápido con experimentos controlados.

Técnicas complementarias (según necesidad)

Detalle en references/05_generacion_soluciones.md:

  • Seis Sombreros de De Bono: Blanco (datos), Rojo (emociones), Negro (riesgos), Amarillo (beneficios), Verde (creatividad), Azul (proceso).
  • Pensamiento Lateral (De Bono): Romper patrones establecidos.
  • Flor de Loto, Conexiones Morfológicas Forzadas, Binomio Fantástico.
  • Jobs to Be Done: Reformular las soluciones en términos del "trabajo" que el cliente/usuario necesita que se haga (ver references/09_jtbd_wardley.md).

Enfoque dual (Recuenco)

Buscar en dos direcciones simultáneas:

  • Flashes of Brilliance: ¿Hay una solución elegante, un "golpe decisivo"?
  • Strategic Hard Nosing: ¿Cuál es la opción pragmática que funciona aunque sea incómoda? ¿A qué hay que renunciar?

FASE 5 — Evaluación Estratégica y Selección

Propósito: Filtrar las opciones y construir una estrategia coherente.

El Kernel de Rumelt (test de calidad estratégica)

Toda buena estrategia tiene tres componentes. Si falta alguno, no es estrategia, es wishful thinking:

  1. Diagnóstico: ¿Cuál es el desafío crítico? (Hecho en Fases 1-2)
  2. Política Guía: ¿Cuál es nuestro enfoque general para superar el obstáculo? No es un objetivo ("ser los mejores"), es una dirección ("competir en precio en segmento X priorizando eficiencia operativa").
  3. Acciones Coherentes: ¿Qué conjunto COORDINADO de acciones implementamos? Las acciones deben reforzarse mutuamente, no contradecirse.

Filtros de evaluación

Para cada opción que sobreviva al kernel de Rumelt:

  1. Test de Nardone: ¿Esta solución es una variante de algo que ya se intentó y fracasó? ¿Estamos cayendo en "más de lo mismo"?
  2. Test de apalancamiento (Meadows): ¿Estamos interviniendo al nivel correcto del sistema? ¿O estamos ajustando parámetros superficiales cuando deberíamos cambiar reglas o metas?
  3. Test de renuncias (Rumelt): Estrategia genuina implica renunciar. ¿A qué renunciamos al elegir esta opción? Si no renunciamos a nada, probablemente no tenemos una estrategia real.
  4. Test de Wardley: ¿Nuestra solución está alineada con la fase evolutiva de los componentes involucrados? (ver references/09_jtbd_wardley.md)

Detalle en references/06_evaluacion_estrategica.md.


FASE 6 — Planificación e Implementación

Propósito: Convertir la estrategia en un plan de acción ejecutable.

Estructura del plan de acción

  1. Qué hay que hacer — Acciones concretas, no aspiraciones
  2. Quién es responsable — Nombres, no departamentos
  3. Cuándo se hace — Fechas, no "pronto"
  4. Cómo medimos éxito — Indicadores observables
  5. Qué puede salir mal — Riesgos y mitigaciones
  6. Primeros pasos inmediatos — Las primeras 72 horas

Gestión de la implementación

Según el tipo de problema, aplicar:

  • Metodología 8D para problemas técnicos estructurados en dominio Complicado — requiere causa raíz verificable y plan formal con trazabilidad (ver references/08_metodologia_8d.md). No usar en dominio Complejo donde se necesita experimentación.
  • Team of Teams (McChrystal) para implementación en entornos complejos: construir conciencia compartida (toda la información relevante fluye a todos los niveles), habilitar ejecución empoderada (las decisiones las toma quien tiene la mejor información, no quien tiene más rango), y crear equipos adaptativos con personas en T (profundidad en su especialidad + amplitud para colaborar transversalmente)
  • Comunicación y Storytelling (Damas) para gestión del cambio: narrativa, manejo de resistencias, técnicas de consenso (ver references/07_comunicacion_consenso.md)
  • Empatía Táctica (Voss) para gestionar stakeholders difíciles: preguntas calibradas, etiquetado de emociones, auditoría de acusaciones

FASE 7 — Monitorización, Ajuste y Aprendizaje

Propósito: Verificar que la solución funciona y corregir el rumbo. Los problemas complejos NUNCA se resuelven en un solo movimiento.

Principio de la matrioshka (Nardone)

Los problemas complejos son como matrioshkas: al resolver una capa, aparece la siguiente. Esto no es un fracaso; es la naturaleza de la complejidad. Resolver lo más accesible primero, luego REDEFINIR el problema desde la nueva situación y repetir el ciclo.

Ciclos adaptativos (Cynefin)

En el dominio complejo: Probar → Percibir → Responder.

  • Diseñar experimentos "safe-to-fail" (que enseñan incluso si fallan)
  • Monitorizar señales débiles de cambio
  • Amplificar lo que funciona, amortiguar lo que no

Feedback sistémico (Meadows)

  • ¿La intervención está produciendo los efectos esperados?
  • ¿Hay efectos secundarios no previstos?
  • ¿Los bucles de retroalimentación están respondiendo como esperábamos?
  • ¿Necesitamos ajustar el punto de intervención?

Formato de salida según nivel

Nivel 1 (Rápido) — en chat

## Clasificación: [dominio Cynefin]
## Diagnóstico: [definición del problema + soluciones intentadas]
## Causas principales: [2-3 causas clave]
## Recomendación inicial: [dirección a seguir + próximos pasos]

Nivel 2 (Estándar) — en chat o documento breve

## 0. Clasificación del problema
## 1. Diagnóstico
### 1.1 Definición del problema
### 1.2 Soluciones intentadas (Nardone)
## 2. Análisis de causas
## 3. Sesgos detectados
## 4. Opciones generadas
## 5. Evaluación estratégica (Kernel de Rumelt)
## Próximos pasos

Nivel 3 (Completo) — documento

Documento completo con las 7 fases, herramientas detalladas, diagramas donde aporten valor, plan de implementación con responsables y fechas, y mecanismos de monitorización.


Principios transversales

Estos principios aplican durante todo el proceso:

  1. Primero entender, después actuar. La urgencia es enemiga del buen diagnóstico.
  2. Los problemas complejos tienen múltiples causas raíz. No simplificar prematuramente.
  3. Las soluciones intentadas son información, no fracasos. El patrón de intentos revela la estructura.
  4. Separar creatividad de crítica. Nunca evaluar y generar al mismo tiempo.
  5. Estrategia = renunciar. Si no renuncias a nada, no tienes estrategia.
  6. Experimentar antes que planificar en exceso. Pequeños pasos > grandes planes en dominios complejos.
  7. Cuestionar los propios sesgos. El análisis más brillante es inútil si está contaminado cognitivamente.
  8. La solución perfecta no existe. Buscar la mejor opción disponible con la información disponible.

Archivos de referencia

Leer estos archivos SOLO cuando una fase específica requiera profundizar en una herramienta concreta. No leerlos todos al inicio — eso sería ineficiente y cargaría contexto innecesariamente.

ArchivoCuándo leerlo
references/01_clasificacion_cynefin.mdFase 0, si hay dudas sobre el dominio
references/02_diagnostico_herramientas.mdFase 1, cuando se necesite CATWOE, IS/IS NOT, etc.
references/03_analisis_causal.mdFase 2, para herramientas de causa raíz
references/04_sesgos_pensamiento.mdFase 3, para checklist completo de sesgos y falacias
references/05_generacion_soluciones.mdFase 4, para técnicas creativas detalladas
references/06_evaluacion_estrategica.mdFase 5, para filtros de evaluación avanzados
references/07_comunicacion_consenso.mdFase 6, para gestión del cambio y stakeholders
references/08_metodologia_8d.mdFase 6, para implementación estructurada tipo 8D
references/09_jtbd_wardley.mdFases 1, 2, 4, 5 — cuando el problema tenga componente de producto/mercado o tecnología

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.