Forensic technique
Goal: produce defensible, reproducible findings from heterogeneous evidence.
When this technique applies
- Potential compromise requiring reconstruction of user/system activity.
- Evidence includes one or more of: disk image, ISO media, RAM dump, PCAP.
- Need to correlate endpoint, filesystem, and network timelines.
- Need report-ready output for incident response, legal, or internal review.
Boundary with offensive-tools
This skill explains methodology and decision flow.
Tool-specific syntax belongs to offensive-tools/* skills.
Initial triage
Before extracting deeply, classify the evidence mix and decide what source can answer the objective fastest with the least interpretive risk.
- Starting state: is the case driven by disk, memory, PCAP, ISO/media, logs, or a mixed evidence set?
- First questions: what is the investigation objective, which artifacts are most volatile or most probative, and what timeline window and provenance constraints apply?
- Immediate actions: verify integrity, normalize time and scope, then inspect the highest-value source first instead of carving everything.
- Tool-family direction: use forensic acquisition/timeline families (
sleuth-kit, autopsy, ftk-imager) for disk/media, volatility3 for memory, and zeek/tcpdump/wireshark for network evidence; use yara and capa only after suspicious artifacts are isolated.
- Escalation rule: require corroboration across sources before claiming compromise, execution, persistence, or exfiltration.
Agent operating model
The agent should keep this loop:
- Preserve and scope evidence.
- Prioritize by volatility and investigative value.
- Examine source-specific artifacts.
- Correlate across sources into one timeline.
- Validate claims with independent corroboration.
- Report facts, interpretation boundaries, and recommendations.
Do not move to deep extraction/carving before timeline framing and hypothesis definition.
Core forensic model
- Preserve: isolate evidence, hash, and record provenance needed for reproducibility.
- Collect: acquire additional required artifacts with minimal alteration.
- Examine: parse artifacts by source type (disk, memory, network).
- Correlate: build a unified timeline across sources.
- Conclude: state what is supported by evidence vs assumptions.
- Report: produce concise, reproducible findings and follow-up actions.
Evidence-first prioritization
Use volatility and value to decide acquisition/examination order.
- Live volatile artifacts (RAM, active connections, running processes)
- Network evidence at risk of rotation (live captures, ephemeral logs)
- Endpoint high-value non-volatile artifacts (event logs, browser data, registry)
- Full disk image deep examination
- Enrichment sources (threat intel, external context)
Objective-driven workflows
1. Disk image investigation (E01/DD/RAW)
Use when you need file-system artifacts, deleted-content recovery, execution traces, and persistence evidence.
- Start with integrity + partition mapping.
- Enumerate file systems and prioritize user/profile, startup, logs, scheduled tasks, shell history.
- On Windows evidence, prioritize execution artifacts such as Prefetch, LNK, Jump Lists, AmCache, ShimCache, SRUM, PowerShell logs, services, and scheduled tasks.
- Build an initial timeline before deep carving.
- Recover/decode only artifacts linked to hypotheses (do not carve everything by default).
- Validate notable findings in at least one secondary source (e.g., link file + event log + registry).
Primary tool families:
offensive-tools/forensic/sleuth-kit/
offensive-tools/forensic/autopsy/
offensive-tools/forensic/ftk-imager/
offensive-tools/forensic/yara/
offensive-tools/forensic/capa/ — capability detection on extracted executables (identifies malware families, TTPs, embedded shellcode)
2. ISO media investigation
Use when the evidence is installer-like media, archives, or mounted image content.
- Verify hash and mount read-only.
- Inventory executable/script content and autorun-related metadata.
- Extract Office/PDF/archive payload chains, embedded objects, external template references, shortcut chains, and script launchers before any dynamic handling.
- Compare bundle contents against expected vendor structure and signatures.
- Extract suspicious binaries/configs for static triage and rule scanning.
- Correlate ISO-delivered artifacts with host execution traces from endpoint evidence.
Primary tool families:
offensive-tools/forensic/sleuth-kit/
offensive-tools/rev/binwalk/
offensive-tools/forensic/yara/
3. PCAP/network forensics
Use when reconstructing communication, exfiltration paths, C2 patterns, or lateral movement.
- Build traffic summary first (top talkers, protocols, unusual destinations).
- Pivot by DNS, TLS metadata, HTTP objects, and transfer channels.
- Identify sequencing: initial access indicators, staging, beaconing, bulk transfer.
- Tie network sessions to endpoint process/user context when possible.
Primary tool families:
offensive-tools/forensic/zeek/
offensive-tools/forensic/tcpdump/
offensive-tools/network/wireshark/
4. Memory-centered investigation
Use when malware is fileless/injected, or when disk evidence is incomplete.
- Enumerate processes/parents, command lines, sockets, loaded modules.
- Hunt for injected regions and anomalous memory protections.
- Extract process artifacts and correlate with on-disk binaries and PCAP events.
- Treat memory findings as high-confidence for “what was running now,” then confirm persistence on disk.
Primary tool families:
offensive-tools/forensic/volatility3/
offensive-tools/forensic/yara/
offensive-tools/forensic/capa/ — classify extracted process dumps or unpacked binaries against malware capability ruleset
5. Mixed-source incident reconstruction
Use when you have disk + PCAP + memory and need a single chronology.
- Create source-local timelines first.
- Normalize to a single timezone and clock offset model.
- Merge into one chronology with confidence tags:
- Direct evidence (observed in source)
- Corroborated evidence (confirmed by second source)
- Inference (plausible but unconfirmed)
- Explicitly record competing explanations for ambiguous events.
6. Log-centric and objective-driven investigations
Use when evidence is mostly EVTX, registry hives, MFT snapshots, API trace logs, or objective-driven forensic tasks.
- Build an objective-to-artifact map first (which artifact can answer each objective decisively).
- Prefer deterministic extraction over broad hunting (exact key, exact event id, exact stream, exact record).
- For Windows log-heavy cases, prioritize: PowerShell ScriptBlock (4104), process creation (4688/Sysmon 1), service/task creation, Defender/AV alerts, and relevant registry keys. When an ETW trace (
.etl) is provided, treat provider name + event id as the primary pointer (e.g. Microsoft-Windows-PowerShell, Microsoft-Antimalware-Scan-Interface, Microsoft-Windows-Kernel-Process).
- For Linux hosts, prioritize
journalctl output from /var/log/journal/* (auth, sshd, sudo, systemd unit start/stop) and /var/log/audit/audit.log (auditd) for structured process/command evidence.
- For macOS hosts, use the Unified Log system (
log collect, log show --predicate ..., or an .logarchive bundle) for process, network, and security signals; classic /var/log text logs are largely deprecated.
- For API trace cases, reconstruct sequence by API dependency chain (enumeration → allocation/write → execution).
- Mark each conclusion as: direct artifact fact vs inferred interpretation.
Primary tool families:
offensive-tools/forensic/chainsaw/ — fast triage across EVTX, $MFT, ShimCache, SRUM, and registry hives with Sigma and built-in detection rules; produces multi-source execution timelines
Practical quality gates
- Provenance and hash records exist for all primary evidence.
- At least one key claim is corroborated across two independent sources.
- Timeline includes both malicious and benign context to avoid narrative bias.
- Every IOC or behavioral claim has exact source pointer (artifact + timestamp).
- Report distinguishes fact, interpretation, and recommendation.
Anti-patterns
- Starting with deep carving before timeline and hypothesis framing.
- Treating one artifact as conclusive without corroboration.
- Mixing local-time and UTC evidence without explicit normalization.
- Writing conclusion-first reports and backfilling evidence.
Required deliverables from the agent
- Evidence inventory with integrity state.
- Source-specific findings with exact pointers.
- Correlated timeline with confidence labels.
- High-confidence claims vs inference boundary.
- Report-ready conclusions and next actions.
Resources
- references/evidence-preservation.md — Load for provenance, hashing, read-only workflow, and evidence-handling order.
- references/disk-and-iso-analysis.md — Load for filesystem/media triage, startup paths, selective extraction, and validation.
- references/windows-execution-indicators.md — Load for Prefetch, LNK, Jump Lists, AmCache, ShimCache, SRUM, and related execution artifacts.
- references/document-malware-analysis.md — Load for Office, PDF, archive, embedded-object, and external-template payload chains.
- references/pcap-analysis.md — Load for protocol triage, session reconstruction, transfer paths, and network chronology.
- references/memory-analysis.md — Load for process/module/socket triage, injected regions, transient secrets, and disk/network correlation.
- references/timeline-correlation.md — Load for clock normalization and merging source-local timelines with confidence labels.
- references/lessons-learned-patterns.md — Load for mixed-artifact heuristics and fast-answer investigation patterns.
- scripts/forensic_triage.py — Run to classify an evidence file and get the first forensic workflow/tool-family recommendation.
1---2name: forensic-technique3description: Incident forensics: preservation, triage, timelines, artifact correlation, reporting across disk (E01/DD/RAW), memory, PCAP.4license: MIT5---67# Forensic technique89Goal: produce **defensible, reproducible findings** from heterogeneous evidence.1011## When this technique applies1213- Potential compromise requiring reconstruction of user/system activity.14- Evidence includes one or more of: disk image, ISO media, RAM dump, PCAP.15- Need to correlate endpoint, filesystem, and network timelines.16- Need report-ready output for incident response, legal, or internal review.1718## Boundary with offensive-tools1920This skill explains **methodology and decision flow**.21Tool-specific syntax belongs to `offensive-tools/*` skills.2223## Initial triage2425Before extracting deeply, classify the evidence mix and decide what source can answer the objective fastest with the least interpretive risk.2627- **Starting state**: is the case driven by disk, memory, PCAP, ISO/media, logs, or a mixed evidence set?28- **First questions**: what is the investigation objective, which artifacts are most volatile or most probative, and what timeline window and provenance constraints apply?29- **Immediate actions**: verify integrity, normalize time and scope, then inspect the highest-value source first instead of carving everything.30- **Tool-family direction**: use forensic acquisition/timeline families (`sleuth-kit`, `autopsy`, `ftk-imager`) for disk/media, `volatility3` for memory, and `zeek`/`tcpdump`/`wireshark` for network evidence; use `yara` and `capa` only after suspicious artifacts are isolated.31- **Escalation rule**: require corroboration across sources before claiming compromise, execution, persistence, or exfiltration.3233## Agent operating model3435The agent should keep this loop:36371. Preserve and scope evidence.382. Prioritize by volatility and investigative value.393. Examine source-specific artifacts.404. Correlate across sources into one timeline.415. Validate claims with independent corroboration.426. Report facts, interpretation boundaries, and recommendations.4344Do not move to deep extraction/carving before timeline framing and hypothesis definition.4546## Core forensic model47481. **Preserve**: isolate evidence, hash, and record provenance needed for reproducibility.492. **Collect**: acquire additional required artifacts with minimal alteration.503. **Examine**: parse artifacts by source type (disk, memory, network).514. **Correlate**: build a unified timeline across sources.525. **Conclude**: state what is supported by evidence vs assumptions.536. **Report**: produce concise, reproducible findings and follow-up actions.5455## Evidence-first prioritization5657Use volatility and value to decide acquisition/examination order.58591. Live volatile artifacts (RAM, active connections, running processes)602. Network evidence at risk of rotation (live captures, ephemeral logs)613. Endpoint high-value non-volatile artifacts (event logs, browser data, registry)624. Full disk image deep examination635. Enrichment sources (threat intel, external context)6465## Objective-driven workflows6667### 1. Disk image investigation (E01/DD/RAW)6869Use when you need file-system artifacts, deleted-content recovery, execution traces, and persistence evidence.7071- Start with integrity + partition mapping.72- Enumerate file systems and prioritize user/profile, startup, logs, scheduled tasks, shell history.73- On Windows evidence, prioritize execution artifacts such as Prefetch, LNK, Jump Lists, AmCache, ShimCache, SRUM, PowerShell logs, services, and scheduled tasks.74- Build an initial timeline before deep carving.75- Recover/decode only artifacts linked to hypotheses (do not carve everything by default).76- Validate notable findings in at least one secondary source (e.g., link file + event log + registry).7778Primary tool families:79- `offensive-tools/forensic/sleuth-kit/`80- `offensive-tools/forensic/autopsy/`81- `offensive-tools/forensic/ftk-imager/`82- `offensive-tools/forensic/yara/`83- `offensive-tools/forensic/capa/` — capability detection on extracted executables (identifies malware families, TTPs, embedded shellcode)8485### 2. ISO media investigation8687Use when the evidence is installer-like media, archives, or mounted image content.8889- Verify hash and mount read-only.90- Inventory executable/script content and autorun-related metadata.91- Extract Office/PDF/archive payload chains, embedded objects, external template references, shortcut chains, and script launchers before any dynamic handling.92- Compare bundle contents against expected vendor structure and signatures.93- Extract suspicious binaries/configs for static triage and rule scanning.94- Correlate ISO-delivered artifacts with host execution traces from endpoint evidence.9596Primary tool families:97- `offensive-tools/forensic/sleuth-kit/`98- `offensive-tools/rev/binwalk/`99- `offensive-tools/forensic/yara/`100101### 3. PCAP/network forensics102103Use when reconstructing communication, exfiltration paths, C2 patterns, or lateral movement.104105- Build traffic summary first (top talkers, protocols, unusual destinations).106- Pivot by DNS, TLS metadata, HTTP objects, and transfer channels.107- Identify sequencing: initial access indicators, staging, beaconing, bulk transfer.108- Tie network sessions to endpoint process/user context when possible.109110Primary tool families:111- `offensive-tools/forensic/zeek/`112- `offensive-tools/forensic/tcpdump/`113- `offensive-tools/network/wireshark/`114115### 4. Memory-centered investigation116117Use when malware is fileless/injected, or when disk evidence is incomplete.118119- Enumerate processes/parents, command lines, sockets, loaded modules.120- Hunt for injected regions and anomalous memory protections.121- Extract process artifacts and correlate with on-disk binaries and PCAP events.122- Treat memory findings as high-confidence for “what was running now,” then confirm persistence on disk.123124Primary tool families:125- `offensive-tools/forensic/volatility3/`126- `offensive-tools/forensic/yara/`127- `offensive-tools/forensic/capa/` — classify extracted process dumps or unpacked binaries against malware capability ruleset128129### 5. Mixed-source incident reconstruction130131Use when you have disk + PCAP + memory and need a single chronology.132133- Create source-local timelines first.134- Normalize to a single timezone and clock offset model.135- Merge into one chronology with confidence tags:136 - Direct evidence (observed in source)137 - Corroborated evidence (confirmed by second source)138 - Inference (plausible but unconfirmed)139- Explicitly record competing explanations for ambiguous events.140141### 6. Log-centric and objective-driven investigations142143Use when evidence is mostly EVTX, registry hives, MFT snapshots, API trace logs, or objective-driven forensic tasks.144145- Build an objective-to-artifact map first (which artifact can answer each objective decisively).146- Prefer deterministic extraction over broad hunting (exact key, exact event id, exact stream, exact record).147- For Windows log-heavy cases, prioritize: PowerShell ScriptBlock (4104), process creation (4688/Sysmon 1), service/task creation, Defender/AV alerts, and relevant registry keys. When an ETW trace (`.etl`) is provided, treat provider name + event id as the primary pointer (e.g. `Microsoft-Windows-PowerShell`, `Microsoft-Antimalware-Scan-Interface`, `Microsoft-Windows-Kernel-Process`).148- For Linux hosts, prioritize `journalctl` output from `/var/log/journal/*` (auth, sshd, sudo, systemd unit start/stop) and `/var/log/audit/audit.log` (auditd) for structured process/command evidence.149- For macOS hosts, use the Unified Log system (`log collect`, `log show --predicate ...`, or an `.logarchive` bundle) for process, network, and security signals; classic `/var/log` text logs are largely deprecated.150- For API trace cases, reconstruct sequence by API dependency chain (enumeration → allocation/write → execution).151- Mark each conclusion as: direct artifact fact vs inferred interpretation.152153Primary tool families:154- `offensive-tools/forensic/chainsaw/` — fast triage across EVTX, `$MFT`, ShimCache, SRUM, and registry hives with Sigma and built-in detection rules; produces multi-source execution timelines155156## Practical quality gates157158- Provenance and hash records exist for all primary evidence.159- At least one key claim is corroborated across two independent sources.160- Timeline includes both malicious and benign context to avoid narrative bias.161- Every IOC or behavioral claim has exact source pointer (artifact + timestamp).162- Report distinguishes fact, interpretation, and recommendation.163164## Anti-patterns165166- Starting with deep carving before timeline and hypothesis framing.167- Treating one artifact as conclusive without corroboration.168- Mixing local-time and UTC evidence without explicit normalization.169- Writing conclusion-first reports and backfilling evidence.170171## Required deliverables from the agent1721731. Evidence inventory with integrity state.1742. Source-specific findings with exact pointers.1753. Correlated timeline with confidence labels.1764. High-confidence claims vs inference boundary.1775. Report-ready conclusions and next actions.178179## Resources180181- [references/evidence-preservation.md](references/evidence-preservation.md) — Load for provenance, hashing, read-only workflow, and evidence-handling order.182- [references/disk-and-iso-analysis.md](references/disk-and-iso-analysis.md) — Load for filesystem/media triage, startup paths, selective extraction, and validation.183- [references/windows-execution-indicators.md](references/windows-execution-indicators.md) — Load for Prefetch, LNK, Jump Lists, AmCache, ShimCache, SRUM, and related execution artifacts.184- [references/document-malware-analysis.md](references/document-malware-analysis.md) — Load for Office, PDF, archive, embedded-object, and external-template payload chains.185- [references/pcap-analysis.md](references/pcap-analysis.md) — Load for protocol triage, session reconstruction, transfer paths, and network chronology.186- [references/memory-analysis.md](references/memory-analysis.md) — Load for process/module/socket triage, injected regions, transient secrets, and disk/network correlation.187- [references/timeline-correlation.md](references/timeline-correlation.md) — Load for clock normalization and merging source-local timelines with confidence labels.188- [references/lessons-learned-patterns.md](references/lessons-learned-patterns.md) — Load for mixed-artifact heuristics and fast-answer investigation patterns.189- [scripts/forensic_triage.py](scripts/forensic_triage.py) — Run to classify an evidence file and get the first forensic workflow/tool-family recommendation.