El informe de una página

El lector del comité puede no llegar al final de la página. Por eso se escribe como el periodismo y el mando militar: lo más importante arriba. La primera frase es la conclusión y, junto a ella, lo que se pide decidir. Los antecedentes y el detalle, si caben, van después; si no caben, van al anexo.

Abre plantilla.txt con cat y lee el orden. No es caprichoso: cada bloque responde a una pregunta que el comité se hace en secuencia («¿qué tengo que decidir?», «¿por qué me importa?», «¿qué tan seguro es?», «¿qué opciones hay?»).

En el borrador de la versión 3 la petición al comité existe, pero está en uno de los últimos párrafos, detrás de antecedentes, técnicas y reglas. Es un patrón muy común: el analista narra el camino que recorrió en lugar de empezar por el punto de llegada. Para el lector, una decisión enterrada es una decisión que nadie toma.

Abre borrador.txt y localiza el párrafo que contiene la solicitud al comité. Es el que tendría que subir al principio.

Los párrafos con códigos de técnica, listas de dominios y lógica de reglas son correctos, y son valiosos: para el analista que va a configurar defensas. En el informe del comité estorban, porque el lector no puede usarlos y se pierde entre ellos. No se borran: se mudan a un anexo o al informe técnico, que es otro producto para otro lector.

Separar los dos documentos no es esconder trabajo. Es respetar que el mismo caso se cuenta de dos maneras según quién lo lea.

Una forma de medir qué tan técnico es un borrador es contar la jerga que un directivo no puede traducir. Los identificadores de técnica de ATT&CK son un buen indicador: la letra T seguida de cuatro cifras. Son útiles en un informe técnico, donde cada código remite a una técnica documentada, y son ruido en uno ejecutivo.

Cuéntalos en el borrador. Cada identificador cuenta una vez cada vez que aparece.

La plantilla fija un límite de palabras para el informe, y el borrador declara su extensión actual. La diferencia es lo que hay que quitar, y no se quita con tipografía ni márgenes: se quita decidiendo qué es esencial. La disciplina de una página obliga a decidir qué es lo importante, que es en lo que consiste el oficio.

Compara el límite de la plantilla con la extensión que declara el borrador.