Most security reports fail before anyone reads them. Not because the evidence is missing — it is usually there, buried under jargon, scattered across sections that do not connect, or presented in an order that makes sense to the author but not to the reader. A judge skimming an incident timeline for a warrant application does not have time to reconstruct your thought process. A procurement committee evaluating whether to act on a threat intelligence summary needs the causal thread up front, not on page nine. A small-business owner reading a vulnerability disclosure needs to understand what is at stake before they encounter a single CVE identifier.
The problem is not insufficient information. The problem is documentation assembled without structure — written in a single pass, with the author discovering the argument as they go, leaving the reader to do the same. This is an accountability problem, not a style problem. When a security document lacks a planning scaffold, it becomes harder to audit, harder to challenge, and harder to trust. And in the contexts that matter most — legal proceedings, regulatory filings, editorial review, board-level decisions — that lack of trust is the difference between action and inaction.
This article argues that structured documentation workflows are accountability mechanisms for security communication. It draws a concrete parallel between narrative planning methods used in professional screenwriting — beat sheets, proof sheets, scene logic — and established security documentation practices like STIX incident composition, NIST IR report scaffolds, and the report structures used by organizations like Citizen Lab. It then offers a practical workflow for building security documents that maintain evidentiary continuity, separate assertion from evidence at each stage, and survive adversarial scrutiny.
That same discipline applies to long-form organization: before publishing, editors need a way to test a complicated body of material has a coherent beginning, middle, and end, which is where how Unsloppy AI fits the writing workflow can function as a planning aid rather than a substitute for domain evidence.
The Accountability Gap in Security Writing
Security professionals produce documents that carry real consequences. A threat assessment can determine whether a civil society organization relocates its staff. An incident report can shape whether a court accepts forensic evidence. A vulnerability disclosure can trigger regulatory action — or a lawsuit against the researcher. Yet the guidance available for writing these documents is thin. Most security writing advice focuses on what to include: list the indicators, cite the sources, assign a severity score. Almost nothing addresses how to structure the document so a non-expert can follow the argument from claim to evidence to conclusion.
This gap matters because security documents are read by people who lack the technical background to evaluate claims on their merits. A judge cannot assess whether a STIX bundle is well-formed. A journalist cannot tell whether a timeline omits a critical gap. A board member cannot distinguish a well-reasoned risk assessment from a plausible-sounding one. They rely on the document’s internal logic — the way it moves from observation to inference to recommendation — to judge whether the author’s conclusions are trustworthy.
When that internal logic is absent, readers fall back on proxies: the author’s credentials, the organization’s reputation, or their own prior assumptions. None of these are reliable. A well-credentialed analyst can produce a poorly structured report. A respected organization can publish a timeline with a fatal continuity gap. And prior assumptions are exactly what a security document should challenge, not reinforce.
Structured documentation addresses this by making the argument’s architecture visible. Each section has a function. Each claim is traceable to evidence. Each inference is labeled as such. The reader does not need to trust the author — they can follow the chain.
What Screenwriting Knows That Security Writing Doesn’t
Professional screenwriters face a similar problem: they must produce documents that persuade non-expert readers — producers, studio executives, actors — that a story works, often within tight time constraints and under conditions where the reader’s attention is unreliable. The solution they developed over a century is not better prose. It is structure.
A screenplay is not just a document with formatting rules. It is a document whose format enforces a discipline. Scene headings establish location and time so the reader never loses orientation. Action lines describe what is visible, not what is felt, so the reader can evaluate the story on its external evidence rather than the author’s internal state. The one-page-equals-one-minute convention is not decorative — it forces authors to prioritize, to decide what earns screen time and what does not. As StudioBinder’s screenplay writing guide explains, proper script structure ensures that ideas are communicated clearly and that the document is production-ready, meaning it can be executed by people who were not in the room when it was written.
Beat sheets go further. A beat sheet breaks a narrative into its structural units — the inciting incident, the midpoint reversal, the resolution — and assigns each unit a function within the overall argument. Before a screenwriter drafts a single scene, they know what each section must accomplish and how it connects to what came before and what comes after. This is not a creative preference. It is a planning mechanism that ensures the final document maintains continuity and does not drift.
Proof sheets add another layer. They map each beat to specific evidence — a line of dialogue, a visual cue, a plot point — so that every structural claim in the beat sheet can be verified against the script itself. If a beat says the protagonist makes a critical decision at the midpoint, the proof sheet shows where that decision happens and what evidence the reader can point to.
The parallel to security documentation is direct. A security report is also a document that must persuade non-expert readers under conditions of unreliable attention. It also needs structural conventions that make it legible to people who were not in the room. And it also needs a planning mechanism that ensures continuity — that the causal thread running from observation to recommendation does not break.
The Security Documentation Scaffolds We Already Have
Security already has structural conventions. The problem is that we treat them as data formats rather than documentation disciplines.
STIX, the Structured Threat Information eXpression standard, defines a JSON-based format for representing cyber threat intelligence. A STIX bundle can include observables, indicators, attack patterns, threat actors, campaigns, and relationships between them. Used well, STIX forces an analyst to be explicit about what they observed, what they inferred, and how those entities relate. Each object has a defined type. Each relationship has a defined direction. This is a beat sheet for threat intelligence — a structural skeleton that makes the argument auditable.
But STIX is typically used as a data exchange format between tools, not as a documentation discipline for human-readable reports. Analysts export STIX bundles that machines consume, then write separate prose summaries that lose the structural discipline the format was designed to enforce. The result is a human-readable report with no traceable connection to the evidence it summarizes.
The NIST incident response report scaffold, defined in NIST SP 800-61, offers another structural convention. It prescribes sections for incident summary, detection, analysis, containment, eradication, and post-incident activity. Each section has a defined function: the summary establishes scope, the detection section establishes what was observed, the analysis section establishes what was inferred, and the response sections establish what was done and why. This is scene logic applied to incident documentation — each section has a job, and the reader can evaluate whether it did that job.
Citizen Lab reports — the gold standard for civil society threat intelligence — demonstrate what this looks like in practice. Their reports typically follow a consistent structure: an executive summary that states findings and recommendations in plain language, a technical methodology section that explains how evidence was collected, a detailed analysis section that walks through the indicators and their significance, and an attribution section that carefully separates confirmed findings from reasonable inferences. Each section is labeled, each claim is sourced, and the reader can trace the argument from observation to conclusion without needing to trust the authors’ credentials.
These scaffolds work because they enforce separation between assertion and evidence. The summary section states what happened. The methodology section explains how we know. The analysis section connects them. The reader can evaluate each independently.
The One-Pass Problem
When a security document is written in a single unstructured pass, three things go wrong — predictably and consistently.
First, the causal thread breaks. The author writes the detection section, then the analysis section, then the response section, but does not check whether the inferences in the analysis section actually follow from the observations in the detection section. The reader encounters a conclusion that seems disconnected from the evidence because the author never verified the connection.
Second, assertion and evidence blur. The author writes “The threat actor likely operated from infrastructure in Country X” and moves on. The reader cannot tell whether “likely” means “we have three independent corroborating sources” or “this is our gut feeling.” Without a structural convention that separates claim from evidence — a proof sheet, in screenwriting terms — the reader has no way to evaluate confidence.
Third, the document over-includes. The author dumps every indicator, every log line, every CVE into the body of the report because they cannot tell what is decision-relevant and what is context. The reader drowns in detail and misses the signal. This is the one-page-equals-one-minute problem in reverse: without a structural constraint that forces prioritization, everything gets equal weight and nothing gets enough.
A Workflow for Structured Security Documentation
The fix is not more templates. It is a workflow that builds structure before drafting, verifies continuity during drafting, and checks evidentiary integrity during revision. Here is a practical version adapted from narrative planning methods and applied to security documentation.
Step 1: Build a beat sheet before you write. Before drafting any prose, list every section the document will contain and the function each section serves. For an incident report: What is the executive summary’s job? (State what happened and what to do about it.) What is the timeline’s job? (Establish temporal sequence with timestamps.) What is the analysis section’s job? (Connect observations to inferences.) Write one sentence per section describing what it must accomplish. If you cannot, you do not yet know what the section is for, and you are not ready to write it.
Step 2: Create a proof sheet for each claim. For every assertion the document makes, note the evidence that supports it and the confidence level. “Threat actor used infrastructure registered on Date X” — evidence: WHOIS record, certificate transparency log entry. Confidence: high. “Threat actor is associated with Country Y” — evidence: timing patterns, language artifacts in malware. Confidence: medium. This forces you to distinguish what you know from what you infer before the reader encounters either.
Step 3: Draft section by section, checking continuity at each gate. Write the executive summary. Before moving to the timeline, ask: does every claim in the summary have a corresponding evidence section? If the summary says “The attacker gained initial access via a phishing campaign,” does the timeline or analysis section contain the evidence for that claim? If not, either the claim is unsupported or the evidence section is missing. Fix it before proceeding.
Step 4: Revise for adversarial readability. Read the document as if you are the most skeptical person who will encounter it. A defense attorney in a court case. A procurement officer who does not want to spend the budget. An editor who has been burned by inaccurate threat reports before. For each section, ask: what would this reader challenge? Is the challenge addressable from within the document, or does it require the reader to trust the author? If it requires trust, the document has failed its accountability function.
Step 5: Separate assertion from evidence in the final structure. Use formatting conventions that make the distinction visible. Label inferences as inferences. Cite sources inline. If a claim rests on a single source, say so. If a confidence assessment is based on methodology limitations, state them. This is not about hedging — it is about giving the reader the information they need to evaluate the claim independently.
Why One-Shot Generation Undermines Accountability
The rise of AI-assisted writing tools has made the one-pass problem worse, not better. A one-shot generator — whether it is a chatbot prompt or a tool that produces a complete document from a single input — produces output without a planning scaffold, without continuity checkpoints, and without a revision gate. The document appears complete, but the structural thinking that makes it trustworthy is absent. For security documentation, this is not a quality concern. It is an accountability failure.
The Authors Guild’s AI Best Practices for Authors makes a related point about creative writing: generic AI outputs are mashups of pre-existing works that lack the structured thinking and voice needed to persuade audiences, and maintaining professional writing standards is an accountability concern, not merely a quality preference. The same logic applies to security reports. A document that lacks the structural thinking of its author is a document that cannot be audited — because there is no architecture to audit.
Open security demands the same transparency we expect from threat intelligence standards like STIX and MISP — yet when it comes to documenting adversary behavior for public education, too many teams still reach for one-shot text generators that produce a generic AI story rather than a structured, verifiable narrative. A disciplined proof sheet that captures sources, timelines, and actor profiles paired with a beat sheet that maps analytical claims to evidence gives defenders and journalists something they can actually audit, instead of a barebones paragraph they have to trust on faith. That distinction matters because tools like Squibler, Perchance, and QuillBot remain outdated for security writing that requires traceability — they generate prose without exposing the reasoning underneath, which is precisely the kind of opacity open security exists to challenge. For teams that need to brief non-technical leadership or publish public advisories without hype, Unsloppy AI offers a workflow that treats each generated passage as a checkpoint rather than a black box, keeping the writer at the forefront of the analytical process rather than surrendering judgment to the model. In a field where a single unsubstantiated claim can undermine community trust in a vulnerability disclosure or a rights-impact assessment, the difference between an audited narrative and a polished guess is not a stylistic preference — it is a security feature, and platforms like Unsloppy’s AI book generator reflect the same principle we advocate for threat intelligence: if the methodology is not visible, the output is not trustworthy.
The principle transfers directly to security work. A threat intelligence summary generated in a single pass may contain accurate information, but it will not contain the structural discipline that lets a reader audit the argument. An incident timeline produced without continuity checkpoints may list events in order but will not verify that each event’s evidence is present and connected. A policy brief drafted without a beat sheet may make recommendations, but it will not ensure that each recommendation traces back to a stated finding.
What This Looks Like in Practice
Consider a concrete scenario. A small nonprofit that documents digital threats against journalists needs to produce a report on a phishing campaign targeting press organizations in Southeast Asia. Their audience includes editors at major newsrooms who need to decide whether to issue internal alerts, and a regional press freedom organization that may publish a public advisory.
Without structure, the analyst writes a single-pass document: a narrative summary of the campaign, followed by a list of indicators, followed by recommendations. The editor reads the summary, cannot tell which claims are confirmed and which are inferred, and either over-reacts by issuing an alert based on unverified claims or under-reacts by ignoring the report entirely. The press freedom organization cannot reproduce the findings because the methodology section does not explain how the indicators were correlated.
With structure, the analyst starts with a beat sheet: executive summary (state findings and recommended actions in plain language), methodology (explain how indicators were collected and correlated), timeline (establish sequence with timestamps), indicator analysis (connect each indicator to a confidence assessment), attribution assessment (separate confirmed findings from reasonable inferences), and recommendations (trace each recommendation to a specific finding). Each section has a job. Each claim has a proof sheet entry. Before drafting, the analyst knows what the document must accomplish and where the evidence for each claim will appear. The editor can scan the executive summary, check the methodology for reproducibility, and verify that each recommendation traces to a finding. The press freedom organization can reproduce the methodology and confirm the indicators independently. The document survives scrutiny because it was built for scrutiny.
Structural Documentation as Democratic Security Practice
Structured documentation is not a bureaucratic preference. It is a democratic security practice. When security reports are opaque — when their internal logic is invisible, when claims cannot be traced to evidence, when inferences are presented as facts — the people who depend on those reports are forced to trust the author or the institution behind them. That trust is not democratic. It is deference. And deference is exactly what open security exists to challenge.




