Define la compatibilidad real
¿Qué es? La compatibilidad con el navegador, la API experimental, el fallback, el provider y la versión del catálogo forman una matriz comprobable.
Por qué aprender: Una afirmación genérica de compatibilidad no representa las combinaciones que realmente ejecuta el usuario.
Antes de modelar
Escribe la solicitud de la persona, el estado actual y la evidencia que demostrará la finalización.
Error de partida
Empezar por el nombre de una función o por un botón produce una tool sin un objetivo humano claro.
Anticípate antes de abrir el código
¿Qué información cambia la decisión? ¿Qué efecto debe aparecer en la interfaz? Responde antes de implementar.
matrix: browser × webmcp_surface × agent_provider × journey
status: tested_at + evidenceProfundiza: evidencia que vale la pena guardar
Registra la entrada, el estado anterior, la decisión tomada, el resultado y el cambio visible en la página.
Incluye también una falla provocada y el comportamiento observado sin soporte de WebMCP.
Conceptos clave
browser channel
feature detect
fallback
catalog version
Versiona los contratos con intención
¿Qué es? Los cambios en nombres, schemas, efectos o errores siguen una política de compatibilidad y obsolescencia.
Por qué aprender: El agente puede mantener contexto antiguo durante un rollout, lo que exige una transición predecible.
| Pregunta | Contrato sólido | Contrato débil |
|---|---|---|
| ¿Cuándo usarlo? | La descripción especifica la intención y el contexto. | “Hace cosas” o “gestiona”. |
| ¿Qué recibe? | Solo los datos necesarios. | Objeto genérico e ilimitado. |
| ¿Qué devuelve? | Estado y siguiente acción verificables. | Texto sin protocolo. |
| ¿Cómo falla? | Código, motivo y recuperación. | Excepción opaca. |
Haz
- ✓ Usa verbos específicos.
- ✓ Delimita las entradas.
- ✓ Declara la evidencia.
Evita
- ✗ Mezclar intenciones.
- ✗ Aceptar cualquier objeto.
- ✗ Ocultar efectos.
buscar_cursos_v1 -> deprecatedAt
buscar_cursos_v2 -> preferred
remove only after telemetry windowProfundiza: evidencia que vale la pena guardar
Registra la entrada, el estado anterior, la decisión tomada, el resultado y el cambio visible en la página.
Incluye también una falla provocada y el comportamiento observado sin soporte de WebMCP.
Conceptos clave
cambio semántico
deprecation
dual publish
migration
Haz un rollout progresivo
¿Qué es? Las feature flags y los canaries limitan la exposición por recorrido, tenant, riesgo y canal.
Por qué aprender: Los lotes pequeños generan evidencia antes de ampliar el radio de impacto.
Observa
Captura el estado, la entrada y el contexto antes de la acción.
Decide
Valida las precondiciones y elige la transición permitida.
Ejecuta
Aplica la regla compartida y respeta la cancelación.
Demuestra
Actualiza la interfaz y devuelve un resultado estructurado.
Punto de control
Si la etapa 2 falla, la tool no intenta “arreglárselas”: devuelve una recuperación explícita.
rollout: 1% read-only -> 5% low-risk -> 25% -> 100%
rollback: disable catalog registrationProfundiza: evidencia que vale la pena guardar
Registra la entrada, el estado anterior, la decisión tomada, el resultado y el cambio visible en la página.
Incluye también una falla provocada y el comportamiento observado sin soporte de WebMCP.
Conceptos clave
feature flag
canary
blast radius
reversión
Opera según el SLO y el presupuesto de errores
¿Qué es? La disponibilidad, el éxito de las tareas, la latencia y los efectos no autorizados tienen objetivos claros.
Por qué aprender: El SLO conecta la experiencia agéntica con la capacidad operativa del equipo.
CÓDIGO DE REFERENCIA
SLO task_success >= 99.0%
SLO unauthorized_effects = 0
p95 tool_latency < 3sEs pequeña, está descrita y se puede validar.
Reutiliza la regla real de la aplicación.
Permite verificar el efecto y continuar.
Lee el código como un contrato
Subraya dónde se valida la entrada, dónde ocurre el efecto, dónde llega la cancelación y dónde se actualiza la UI.
Profundiza: evidencia que vale la pena guardar
Registra la entrada, el estado anterior, la decisión tomada, el resultado y el cambio visible en la página.
Incluye también una falla provocada y el comportamiento observado sin soporte de WebMCP.
Conceptos clave
SLI
SLO
error budget
alert
Prepárate para los incidentes y el kill switch
¿Qué es? Los runbooks cubren la tool incorrecta, los bucles, la indisponibilidad, las filtraciones y los cambios inesperados del draft.
Por qué aprender: La respuesta debe desactivar capacidades rápidamente sin interrumpir la experiencia humana.
Falla provocada
Ejecuta el escenario con estado ausente, entrada no válida o capacidad no disponible.
Recuperación esperada
La respuesta informa qué falló, qué sigue siendo seguro y qué acción puede continuar.
Matriz mínima de pruebas
✓ recorrido feliz reproducible
✓ entrada inválida que permite actuar
✓ la cancelación termina el trabajo
✓ el fallback preserva el recorrido
✓ la interfaz refleja el estado
✓ el backend mantiene la autorización
if (incident.severity >= 1) flags.disable("webmcp_mutations");
preserveManualJourney();Profundiza: evidencia que vale la pena guardar
Registra la entrada, el estado anterior, la decisión tomada, el resultado y el cambio visible en la página.
Incluye también una falla provocada y el comportamiento observado sin soporte de WebMCP.
Conceptos clave
guía operativa
kill switch
containment
postmortem
Establece ownership y gobernanza
¿Qué es? Producto, ingeniería, seguridad y operaciones comparten decisiones con responsables y evidencias definidos.
Por qué aprender: La plataforma sigue siendo sostenible cuando cambien el catálogo y las políticas.
Ejercicio de síntesis
- 1. Explica el problema sin usar el nombre de la tecnología.
- 2. Diseña el estado anterior y posterior.
- 3. Implementa la prueba funcional más pequeña.
- 4. Provoca una falla y registra la recuperación.
- 5. Entrega código, evidencia y una limitación conocida.
Desafío del módulo
Entrega una revisión de preparación para producción con SLOs, rollout, rollback, runbook, ownership y política de cambios.
Criterio de experto responsable
La entrega debe funcionar, explicar sus límites y preservar la ruta humana cuando la capacidad experimental no exista.
owner: Agent Platform
approvers: [Product, Security]
reviewEvery: 90d
evidence: evalReport + threatModel + runbookProfundiza: evidencia que vale la pena guardar
Registra la entrada, el estado anterior, la decisión tomada, el resultado y el cambio visible en la página.
Incluye también una falla provocada y el comportamiento observado sin soporte de WebMCP.
Conceptos clave
RACI
cadencia de revisión
exception
audit trail
📦 Entrega del módulo
Entrega una revisión de preparación para producción con SLOs, rollout, rollback, runbook, ownership y política de cambios.
Criterio de aceptación
La entrega funciona con soporte para WebMCP y mantiene la ruta manual cuando la API no existe.
Evidencia
Incluye el código, el escenario probado, el resultado observado y una limitación conocida.
Fuentes técnicas
- Borrador y repositorio oficial de WebMCP
- Especificación renderizada
- Snapshot oficial: 26/08/2026 · commit 41d12f0. La API declarativa sigue siendo experimental; valida el draft antes de producción.