diff --git a/formats/investigation-report.md b/formats/investigation-report.md index ef7409d..cdfc557 100644 --- a/formats/investigation-report.md +++ b/formats/investigation-report.md @@ -12,8 +12,88 @@ produces: investigation-report # Format: Investigation Report -The output MUST be a structured investigation report with the following -sections in this exact order. +The output MUST be a structured investigation report. Use the **full +format** by default. Use the **abbreviated format** when the conditions +below are met. + +## Format Selection + +Before writing the report, **enumerate and classify all findings first** +(count and highest severity). Then choose the format: + +- **Abbreviated**: finding count is 5 or fewer AND no Critical/High severity +- **Full**: more than 5 findings, or any Critical/High, or incident + response / security audit context + +If the invoking template or workflow explicitly requires the full +9-section structure, use the full format regardless of finding count. + +## Abbreviated Format + +Use the abbreviated format when **both** conditions are true: + +1. Total finding count is **5 or fewer**, AND +2. **No** findings are Critical or High severity + +The abbreviated format includes only these sections: + +```markdown +# — Investigation Report + +## 1. Executive Summary +<2–4 sentences: what was investigated, the key finding(s), +severity, and recommended action.> + +## 2. Findings + +### Finding F-: +- **Severity**: Medium / Low / Informational +- **Category**: +- **Location**: +- **Description**: +- **Evidence**: +- **Remediation**: +- **Confidence**: High / Medium / Low + +## 3. Remediation Plan + + +## 4. Coverage +- **Examined**: +- **Excluded**: +``` + +All formatting rules and the confidence framework from the full format +still apply. The abbreviated format omits Problem Statement, +Investigation Scope, Root Cause Analysis, Prevention, Open Questions, +and Revision History — these add overhead without analytical value for +routine, low-severity audits. + +If there are **zero findings**, state "None identified" in the Findings +section and "No remediation required" in the Remediation Plan. The +Coverage section must still document what was examined. + +If any finding is later upgraded to Critical or High during the +investigation, switch to the full format. + +## Full Format + +Use the full format when the abbreviated conditions are **not** met +(more than 5 findings, or any Critical/High severity finding), or when +the investigation is an incident response, security audit, or other +context where narrative and prevention matter. + +The full format MUST include the following sections in this exact order. +Sections **1–8** are required. Section **9 (Revision History)** is +included only when the report is maintained across revisions; if +present, it MUST appear last. Omit §9 for single-pass automated audits +unless the invoking template or workflow explicitly requires the full +9-section structure — in that case, include §9 and state +"Single-pass report; no prior revisions." when there is no history. ## Document Structure @@ -72,7 +152,9 @@ symptoms → hypotheses → evidence → confirmed cause → causal chain.> For each: what is unknown, why it matters, and what would resolve it.> ## 9. Revision History - + ``` ## Formatting Rules