From thyrox
Use when solving a structured problem with Toyota TBP. pps:clarify — clarify and break down the problem using Go-and-See, define ideal vs actual state, decompose and prioritize sub-problems.
How this skill is triggered — by the user, by Claude, or both
Slash command
/thyrox:pps-clarifyThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
> *"Before you can solve a problem, you must truly see it — not from a desk, but from where the work actually happens."*
"Before you can solve a problem, you must truly see it — not from a desk, but from where the work actually happens." — Toyota TBP philosophy (Go-and-See / Gemba)
Ejecuta los Steps 1 y 2 del Toyota Business Practices (TBP): clarificar el problema real y descomponerlo en sub-problemas priorizables. Produce la Hoja de Clarificación del Problema.
THYROX Stage: Stage 1 DISCOVER.
Tollgate: Problema clarificado con brecha cuantificada, sub-problemas identificados y punto de priorización elegido antes de avanzar a pps:target.
flowchart LR
C12["Steps 1-2\nClarify + Break Down"]:::active --> T["Step 3\nSet Target"]
T --> A["Step 4\nRoot Cause"]
A --> D["Step 5\nCountermeasures"]
D --> I["Step 6\nImplement"]
I --> M["Step 7\nMonitor"]
M --> S["Step 8\nStandardize"]
classDef active fill:#4a9eff,color:#fff
Gemba significa "el lugar real" en japonés — donde el trabajo realmente ocurre. Es el principio fundacional de TBP:
| Principio | Qué significa | Cómo aplicarlo |
|---|---|---|
| Gemba | Ve al lugar real | Observa el proceso donde ocurre el problema, no en salas de juntas |
| Genbutsu | Observa el objeto real | Examina el output defectuoso, el dato real, el artefacto fallido |
| Genjitsu | Entiende los hechos reales | No suposiciones — datos reales, evidencia observable |
Sin Go-and-See, el "problema" que defines en papel puede no ser el problema real que enfrenta el equipo.
Antes de cualquier análisis, ir al Gemba:
| Tarea | Cómo |
|---|---|
| Observar el proceso directamente | Ir donde sucede el trabajo — no confiar solo en reportes |
| Documentar lo observado con datos | Fotos, notas, métricas en el momento — no recuerdos después |
| Hablar con quienes hacen el trabajo | Preguntas abiertas: "¿Qué dificulta su trabajo?", "¿Cuándo falla esto?" |
| Identificar el punto exacto donde aparece el problema | ¿En qué paso del proceso? ¿Con qué frecuencia? ¿Bajo qué condiciones? |
El núcleo de la clarificación TBP: la brecha entre lo que debería ser y lo que es.
| Dimensión | Estado Ideal (should be) | Estado Actual (as is) | Brecha |
|---|---|---|---|
| Calidad | [estándar esperado] | [valor medido] | [diferencia] |
| Tiempo/Velocidad | [estándar esperado] | [valor medido] | [diferencia] |
| Costo | [estándar esperado] | [valor medido] | [diferencia] |
| Seguridad/Riesgo | [estándar esperado] | [valor medido] | [diferencia] |
El estado ideal no es una aspiración vaga — es el estándar definido (SLA, especificación, requisito). Sin estándar, no hay brecha medible.
El Problem Statement describe lo que se puede observar y medir:
| ✅ Buen Problem Statement | ❌ Mal Problem Statement |
|---|---|
| "El 23% de los deploys a producción fallan en la etapa de health check (datos: últimas 8 semanas), causando ~4h de rollback manual por incidente" | "El proceso de deployment es malo" |
| Tiene porcentaje y período | Sin magnitud cuantitativa |
| Identifica el síntoma exacto | Vago y subjetivo |
| No asume causa | "El pipeline CI/CD está mal configurado" — asume causa |
| Tiene impacto medible | Sin consecuencia observable |
Regla TBP: si el Problem Statement menciona una causa o una solución, está mal — reescribir.
| Dimensión | Detalle |
|---|---|
| ¿Quién está afectado? | Clientes, usuarios, equipos, procesos downstream |
| ¿Cuál es el impacto medible? | Costo, tiempo perdido, defectos, riesgo |
| ¿Con qué frecuencia ocurre? | Eventos/semana, % de ocurrencia, tendencia |
| ¿Desde cuándo ocurre? | Inicio del problema, si hubo evento disparador |
| ¿Cuál es la urgencia? | ¿Qué pasa si no se resuelve en 30/60/90 días? |
Un problema grande y vago se hace resoluble al descomponerlo en sub-problemas específicos:
Técnicas de descomposición:
| Técnica | Cuándo usar | Cómo aplicar |
|---|---|---|
| Por proceso | El problema ocurre en múltiples etapas | Mapear el proceso y localizar en qué etapa aparece cada sub-problema |
| Por producto/servicio | El problema varía según el tipo de output | Segmentar por tipo y analizar diferencias |
| Por tiempo | El problema varía según cuándo ocurre | Analizar por turno, día, período del mes |
| Por lugar/área | El problema varía geográficamente | Comparar entre ubicaciones, equipos, sistemas |
| Por persona/equipo | El problema varía según quién lo ejecuta | Analizar diferencias de desempeño — sin culpar, buscando causas sistémicas |
Tabla de descomposición:
| # | Sub-problema | Frecuencia | Impacto | Datos que lo soportan |
|---|---|---|---|---|
| 1 | [descripción específica] | [veces/período] | [alto/medio/bajo] | [fuente] |
| 2 | [descripción específica] | [veces/período] | [alto/medio/bajo] | [fuente] |
No todos los sub-problemas merecen el mismo esfuerzo. Elegir el punto de enfoque:
| Criterio | Pregunta | Puntaje (1-5) |
|---|---|---|
| Impacto | ¿Cuánto mejora si se resuelve este sub-problema? | |
| Frecuencia | ¿Con qué frecuencia ocurre? | |
| Resolubilidad | ¿Es tratable con los recursos disponibles? | |
| Urgencia | ¿Hay consecuencias inmediatas si no se atiende? |
Regla TBP: atacar el sub-problema con mayor impacto primero. Evitar la tentación de empezar por lo más fácil.
Completar el template: problem-clarification-template.md
{wp}/pps-clarify.md — Hoja de Clarificación con estado ideal vs actual, brecha cuantificada, impacto, descomposición y sub-problema priorizado.
| Racionalización | Por qué es trampa | Respuesta correcta |
|---|---|---|
| "Ya sabemos cuál es el problema" | Lo que "sabemos" puede ser el síntoma o la causa asumida, no el problema real | Verificar con datos del Gemba antes de declarar el problema entendido |
| "No tenemos tiempo para ir a observar" | Sin Gemba, hay alta probabilidad de resolver el problema equivocado | 30 minutos de observación directa evitan semanas de análisis incorrecto |
| "El sub-problema más fácil es mejor para ganar momentum" | El sub-problema más fácil raramente es el de mayor impacto | Priorizar por impacto + datos, no por comodidad |
Al INICIAR este step:
methodology_step: pps:clarify
flow: pps
Al COMPLETAR (Hoja de Clarificación aprobada con sub-problema priorizado):
methodology_step: pps:clarify # completado → listo para pps:target
flow: pps
Cuando la Hoja de Clarificación está completa y el sub-problema está priorizado → pps:target
npx claudepluginhub jcg-admin/iact-ui --plugin thyroxGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.