Plantillas
Siete plantillas en Markdown, listas para usar. Cada una trae los criterios que salieron de la evidencia de este sitio. Al final de cada una, el apartado “Por qué está esto acá” nombra el criterio y su fuente.
Cómo usarlas
Sección titulada «Cómo usarlas»- Abrí la plantilla y copiá el bloque con el botón de la esquina.
- Pegala en tu repositorio o en tu herramienta de documentos.
- Completá los campos entre corchetes. Las instrucciones van entre
<!-- -->. Borralas al terminar.
Los mismos archivos están en la carpeta templates/ del repositorio, en español y en inglés.
Las siete
Sección titulada «Las siete»| Plantilla | Para qué sirve | Cuándo |
|---|---|---|
| ADR: ¿agente, flujo fijo o persona? | Decidir si la tarea necesita un agente y dejar la razón escrita. Un ADR es un registro de una decisión de arquitectura. | Antes de construir. |
| Revisión de diseño | Revisar el diseño en orden, de la tarea a la operación. | Antes de escribir código. |
| Mapa de amenazas | Encontrar dónde se juntan contenido no confiable, datos sensibles y acciones hacia afuera. | Antes de dar acceso a herramientas reales. |
| Plan de evaluación | Medir con tareas reales y pass^k (todos los intentos salen bien), y fijar cuándo sale y cuándo vuelve atrás. | Antes de mostrarlo a usuarios. |
| Política de acciones | Poner cada acción en automático, confirmar o prohibido. | Antes de conectar herramientas que escriben. |
| Runbook de incidente | Cortar el daño, diagnosticar con el registro y comunicar. Un runbook es una guía de pasos para un incidente. | Antes de salir a producción. |
| Ficha de costo | Calcular el costo por tarea exitosa, con reintentos y revisión humana. | Al decidir y cada vez que cambian los precios. |
En qué orden
Sección titulada «En qué orden»Empezá por el ADR, porque puede terminar en “no hace falta un agente”. La revisión de diseño pide las otras seis como requisito. Escribí el runbook antes de salir a producción: en el primer incidente no vas a tener tiempo.