DETECT hunt Framework

Overview

The framework

This is the model itself: what a detection program has to do, in what order, and how you can tell a step is done without taking anyone's word for it. If you only read one part of the site, read this one. The rest is detail, and I say that as the person who wrote the detail.

Framework v0.136.0.

On this page

The lifecycle

BacklogBuildLive1Intakelead2Hypothesisengineer3Researchengineer4Buildengineer5Validatereviewer6Deploylead7Tuneengineer + SOC8Retireleadtuning changes are re-validateda retired detection's replacement starts again at intake
Each diamond is a definition of done. A detection moves on only when the count is met, and anyone can check the count. Tuning changes go back through validate, and a retired detection's replacement starts again at intake.
  1. Backlog line1. IntakeDone when: 6 scores, each with an evidence line, and 1 computed score
  2. Backlog line2. HypothesisDone when: 1 hypothesis sentence, 1 named log source, 1 named blind spot
  3. Backlog line3. ResearchDone when: 1 emulation run, fixtures saved, every field checked against a real event, 7 days of baseline counts, lab torn down
  4. Build line4. BuildDone when: lint passes, 1 conversion per target, 1 event it must match, 1 event it must ignore
  5. Build line5. ValidateDone when: fixtures pass on every replay engine, every converted query approved (matching its approved copy on a re-validation), 1 approval by someone other than the author (one-person team: the author after 24 hours)
  6. Live line6. DeployDone when: 7 days live with alerting off, alert volume at or under its threshold, then alerting on
  7. Live line7. TuneDone when: precision checked every 30 days, running query matches the approved copy at each check
  8. Live line8. RetireDone when: status deprecated, alerting off, record kept, retirement note written, replacement linked if one exists
A detection leaves each stage only when the count under it is met. Tuning changes go back through validate, and a retired detection's replacement starts again at intake.

In this part

The practices

Each one works on its own, so take the ones that fix a problem you have and leave the rest on the shelf.

Detection zeroThe scored backlogCountable definitions of doneThe detection recordSecond-engineer reviewRetirement triggers and the precision floorThe metric setDetection as codeThreat-model intake

The other overviews: Build detections · Run and measure · The tools.