Flujo de documentación
La documentación empieza con la primera acción y termina cuando el cliente puede entender, reproducir y priorizar el resultado. El informe no reconstruye semanas de trabajo a partir de memoria. Selecciona y explica evidencia que ya estaba organizada.
Tres capas
Sección titulada «Tres capas»| Capa | Para qué sirve | Audiencia principal |
|---|---|---|
| Registro de actividad | Reconstruir qué se hizo, cuándo y con qué resultado | Equipo de pruebas y control operativo |
| Hallazgo técnico | Reproducir una condición, entender su impacto y corregirla | Personal técnico y responsables del control |
| Resumen ejecutivo | Explicar exposición, temas comunes y prioridades de negocio | Dirección, riesgo y propietarios del servicio |
Copiar el hallazgo técnico en el resumen no lo convierte en ejecutivo. Del mismo modo, una afirmación de impacto sin evidencia no sustituye el detalle técnico.
Durante la evaluación
Sección titulada «Durante la evaluación»Cada observación se relaciona con una hipótesis, una acción y un resultado. Las salidas completas se conservan como artefactos y las notas extraen el fragmento que justifica la decisión. Gestión de evidencias define cómo proteger originales, sanear copias y registrar cambios.
Una lista viva de posibles hallazgos evita descubrir al final que faltan el activo afectado, la cuenta utilizada o una captura reproducible. También separa una pista pendiente de una condición validada.
Del hallazgo al informe
Sección titulada «Del hallazgo al informe»Cada hallazgo debe responder:
- qué condición existe
- dónde y bajo qué prerrequisitos
- cómo se verificó
- qué impacto técnico permite sostener
- qué riesgo representa en el contexto del cliente
- cuál es la causa que debe corregirse
- cómo puede comprobarse la remediación
La recomendación debe ser suficientemente concreta para orientar el control, pero no inventar detalles de arquitectura que el equipo no conoce. Si existen varias opciones, explica el resultado de seguridad esperado y los condicionantes relevantes.
Cadena de ataque
Sección titulada «Cadena de ataque»Una cadena muestra cómo varios hallazgos o decisiones permitieron avanzar. No reemplaza los hallazgos individuales. Corregir un enlace puede bloquear la ruta observada mientras otras debilidades siguen presentes.
La narración identifica activos, identidades, capacidades obtenidas y controles que habrían detenido cada transición. Pruebas de concepto explica cómo construir esa evidencia sin convertirla en una demostración destructiva.
Revisión de calidad
Sección titulada «Revisión de calidad»Antes de entregar, otra persona debe comprobar:
- coherencia entre evidencia, impacto y severidad
- pasos reproducibles y variables identificadas
- ausencia de secretos y datos personales innecesarios
- términos definidos antes de aparecer en comparaciones
- recomendaciones vinculadas a la causa
- alcance y limitaciones visibles
- diferencias entre borrador, final y retest
- enlaces y referencias vigentes
Una revisión editorial importa tanto como la técnica. Un resultado correcto puede perder utilidad si el lector no entiende qué ocurrió o qué debe hacer.
Práctica
Sección titulada «Práctica»Los laboratorios permiten entrenar ambos niveles. Primero se conserva el razonamiento técnico siguiendo Trabajo en laboratorio. Después se redacta un hallazgo para el equipo que lo corregiría y un resumen breve para quien decide prioridad y presupuesto. Comparar ambos textos revela qué detalles pertenecen a cada audiencia.