Back to list
vjrivmon

poka-yoke

by vjrivmon

Sistema de orquestación de agentes para Claude Code - Transforma ideas en MVPs funcionales

1🍴 0📅 Jan 24, 2026

SKILL.md


name: poka-yoke description: Diseño a prueba de errores que hace imposible el uso incorrecto. Use cuando diseñe flujos críticos, formularios, o sistemas donde los errores tienen consecuencias. metadata: author: ux-ui-skills version: "1.0" category: design-principles

Poka-Yoke (A Prueba de Errores)

Resumen

Diseñar sistemas de manera que sea imposible o muy difícil cometer errores. Prevenir errores por diseño, no por instrucciones o entrenamiento.

Origen

  • Autor: Shigeo Shingo (Toyota Production System)
  • Año: 1960s
  • Contexto: Manufactura lean
  • Significado: "Evitar errores inadvertidos" en japonés

Tipos de Poka-Yoke

Prevention (Prevención)

  • Hace imposible el error
  • USB-C que entra de cualquier lado
  • Forms que no aceptan formato inválido
  • Botones disabled hasta que sea válido

Detection (Detección)

  • Alerta antes de que el error cause daño
  • Spell check mientras escribes
  • "¿Olvidaste el adjunto?"
  • Validación antes de submit

Facilitation (Facilitación)

  • Hace más fácil lo correcto que lo incorrecto
  • Defaults sensibles
  • Autocompletado
  • Sugerencias contextuales

Aplicación en Diseño

Formularios

  • Input masks para formatos específicos
  • Dropdowns en lugar de texto libre
  • Validación en tiempo real
  • Required fields claramente marcados

Acciones Destructivas

  • Confirmación con typing del nombre
  • Delays antes de ejecutar
  • Undo disponible
  • Soft deletes antes de permanent

Datos

  • Formato automático (teléfonos, tarjetas)
  • Límites de caracteres
  • Validación de checksums
  • Detección de duplicados

Flujos

  • Steps que no se pueden saltar
  • Prerrequisitos enforced
  • State machine que previene estados inválidos
  • Guards en navegación

Ejemplos

  • GitHub: "Type repository name to confirm delete"
  • Gmail: "You mentioned attachment but didn't attach"
  • ATMs: Card returns before cash
  • Microwave: Door switch prevents operation when open
  • Stripe: Luhn validation en tiempo real

Anti-patterns

  • ❌ Depender de instrucciones para prevenir errores
  • ❌ Warnings que se pueden ignorar
  • ❌ Validación solo al final del proceso
  • ❌ Errores que solo se detectan después
  • ❌ Poka-yoke tan restrictivo que frustra

Métricas

  • Error Prevention Rate: Errores evitados
  • Error Recovery Time: Tiempo para corregir
  • Support Tickets: Por errores de usuario
  • Data Quality Score: Datos válidos ingresados

Principios Relacionados

  • [[constraints-principle]] - Restringir acciones inválidas
  • [[nielsen-error-prevention]] - Prevenir antes de curar
  • [[postels-law]] - Flexibilidad con validación

Referencias

Score

Total Score

65/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon