planteamiento
Skill0 starsChanged 22 days agoMITView on GitHub
Use BEFORE writing a spec, building, deciding, or starting a fix on any NON-TRIVIAL work — to define the problem and its ROOT CAUSE before solving. Triggers on intent to fix/build/decide on a non-trivial task ("voy a arreglar/construir", "el problema es", "algo no funciona", "hay que resolver", "necesito que X"), on bugs/incidents, and on client problems or decisions with a disyuntiva. The trap it catches: jumping from a SYMPTOM straight to a spec or a solution without verifying it is the RIGHT problem and what its root cause is (the GPS-fleet trap — a 5-phase plan built on an N=1 outlier). NOT for trivial mechanical work (typo/rename/dep-bump/format), pure informational questions, or when the user said "solo hazlo / sin más vueltas". DISTINCT from /refutar (kills a claim/figure), /premortem (future failure of a SOLUTION), and clarifica-una-a-una (requirements of the DELIVERABLE) — planteamiento defines the PROBLEM itself. Operacionaliza CPMAI Fase I (Business Understanding).
In this repository16 other files it gives its agents.
- agotar-antes-de-negarSkill
- anti-hype-acronyms-guardSkill
- clarifica-una-a-unaSkill
- decision-matrixSkill
- document-progressSkill
- donde-estoySkill
- e2eSkill
- iso-42001-aimsSkill
- leanSkill
- orchestration-autonomy-tiersSkill
- pre-flightSkill
- premortemSkill
- prompt-rewriteSkill
- refutarSkill
- specSkill
- sprintSkill
The file
Files
Planteamiento del Problema — gate de entrada
Define el problema y su raíz ANTES de escribir la especificación o de construir. Complemento de la verificación end-to-end, pero al frente del embudo: la verificación E2E confirma que la solución funciona; esto verifica que el problema esté bien definido. Produce un artefacto visible que el usuario aprueba antes de avanzar.
Cuándo aplica
OBLIGATORIO en trabajo no trivial: feature/proyecto nuevo · fix no trivial / incidente · problema o decisión de cliente · "algo no funciona".
Skip-list (EXENTO): edición mecánica / typo / rename / dep-bump / formato · pregunta puramente informativa · el usuario dijo "solo hazlo / sin más vueltas". Si aplica skip, dilo en una línea y procede.
Los 7 campos (llénalos en orden, a la vista)
- Síntoma observado — el hecho, con EVIDENCIA verificada en vivo (comando/dato), NO de memoria.
- Estado actual vs estado deseado — la brecha concreta.
- Causa raíz (5-Whys) — encadena: síntoma → ¿por qué? → … → raíz. Para cuando el "por qué" ya no tiene respuesta verificable.
- Enunciado formal — "El estado es X porque Y; evidencia Z; la raíz es W."
- Hipótesis falsable + métrica — qué predices y cómo se mediría que es falsa.
- Denominador absoluto + baseline del KPI — toda cifra agregada exige su denominador (un share/% sobre universo chico = nada). Nombra el número base actual de la métrica que moverías.
- Delimitación — qué NO es el problema (guard anti-XY: ¿el usuario pide Y porque cree que resuelve X? ¿es X el problema real?).
Después de los 7 campos: refutar el ENUNCIADO
Corre /refutar sobre el enunciado del problema (campo 4), NO sobre cifras sueltas.
¿Sobrevive? ¿O el enunciado sigue siendo un síntoma disfrazado de raíz?
Criterio Go / No-Go
- GO si: el planteamiento nombra palanca movible + denominador absoluto + baseline de KPI
Y el enunciado sobrevive
/refutar. - No-Go si falta cualquiera → reformular antes de especificar. NO se construye sobre un problema mal definido.
- Si N=1 → reformular como caso aislado, NUNCA extrapolar a "el sistema" sin baseline del resto (toda cifra citada de memoria o de un incidente previo se re-valida en vivo antes de extrapolar).
Ejemplo ILUSTRATIVO (caso compuesto de flota — debe dar No-Go)
⚠ Caso compuesto para ilustrar la mecánica del gate, NO cifras verificadas. Al usar el gate de verdad, re-corre tú las cifras en vivo.
- Síntoma: "el agente reporta 2,100 registros sin GPS en el último mes".
- Campo 6 (denominador): ¿2,100 sobre cuántos registros totales? No verificado.
/refutardel enunciado "la flota tiene un problema sistémico de GPS": query directa → 99% GPS OK; un solo vehículo = único outlier (N=1).- Veredicto: No-Go. El "problema sistémico" era un síntoma de un outlier individual. El plan de 5 fases / 12-14h se habría evitado. Reformular: "ese vehículo reporta 100% GPS NULL — ¿por qué SOLO ese?" (caso aislado).
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
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.

