Skip to content

Commit 7a90f6d

Browse files
committed
add coverage index README
1 parent f0d0510 commit 7a90f6d

1 file changed

Lines changed: 180 additions & 0 deletions

File tree

coverage/README.md

Lines changed: 180 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,180 @@
1+
\# Coverage
2+
3+
4+
5+
This directory contains coverage-tracking artifacts used to measure, visualize, and prioritize detection engineering progress.
6+
7+
8+
9+
\## Purpose
10+
11+
12+
13+
Coverage tracking helps the program understand:
14+
15+
\- which attacker behaviors are represented in current content
16+
17+
\- where meaningful detection gaps remain
18+
19+
\- which tactics or techniques need additional engineering focus
20+
21+
\- how detection engineering maturity is progressing over time
22+
23+
24+
25+
Coverage is intended to support both engineering decision-making and leadership reporting.
26+
27+
28+
29+
\## Coverage Areas
30+
31+
32+
33+
\### MITRE ATT\&CK
34+
35+
\- \[MITRE Folder](mitre/)
36+
37+
38+
39+
Used for:
40+
41+
\- ATT\&CK coverage matrices
42+
43+
\- coverage summaries
44+
45+
\- documented gaps
46+
47+
\- gap closure tracking
48+
49+
50+
51+
\### Cyber Kill Chain
52+
53+
\- \[Cyber Kill Chain Folder](cyber-kill-chain/)
54+
55+
56+
57+
Used for:
58+
59+
\- CKC-aligned coverage views
60+
61+
\- supporting summaries
62+
63+
\- visual or matrix-based reporting where applicable
64+
65+
66+
67+
\## Typical Artifacts
68+
69+
70+
71+
Examples of artifacts in this directory may include:
72+
73+
\- coverage matrix CSV files
74+
75+
\- coverage summary markdown files
76+
77+
\- gap tracking documents
78+
79+
\- supporting charts or exported visuals
80+
81+
\- tactic and technique mapping support files
82+
83+
84+
85+
\## How Coverage Should Be Used
86+
87+
88+
89+
Coverage artifacts should help answer questions such as:
90+
91+
\- which ATT\&CK tactics have the strongest current support?
92+
93+
\- which tactics or techniques are underrepresented?
94+
95+
\- which gaps are blocked by telemetry rather than engineering effort?
96+
97+
\- which areas should be prioritized in the roadmap?
98+
99+
\- how is coverage changing over time?
100+
101+
102+
103+
\## Coverage Principles
104+
105+
106+
107+
Coverage tracking should be:
108+
109+
110+
111+
\### Useful
112+
113+
It should support decision-making, not just exist as a count of mapped rules.
114+
115+
116+
117+
\### Structured
118+
119+
Artifacts should be maintained in predictable folders and formats.
120+
121+
122+
123+
\### Honest
124+
125+
Coverage should not overstate maturity or depth simply because a tactic has one starter rule.
126+
127+
128+
129+
\### Aligned
130+
131+
Coverage should connect back to roadmap priorities, telemetry reality, and program maturity.
132+
133+
134+
135+
\### Reportable
136+
137+
Artifacts should be usable in quarterly reviews, annual reviews, and executive updates.
138+
139+
140+
141+
\## Related Content
142+
143+
144+
145+
\- \[Detections](../detections/)
146+
147+
\- \[Reporting](../docs/04\_reporting/)
148+
149+
\- \[Strategy](../docs/01\_strategy/)
150+
151+
\- \[Visuals](../docs/03\_visuals/)
152+
153+
\- \[Data Source Catalog](../governance/data-source-catalog.md)
154+
155+
156+
157+
\## Recommended Review Rhythm
158+
159+
160+
161+
Coverage artifacts should be reviewed:
162+
163+
\- periodically during content expansion
164+
165+
\- during quarterly reporting cycles
166+
167+
\- during annual roadmap review
168+
169+
\- whenever significant new detections are added
170+
171+
\- whenever major telemetry changes affect use case feasibility
172+
173+
174+
175+
\## Goal
176+
177+
178+
179+
The goal of this directory is to make detection coverage visible, actionable, and measurable so the program can mature deliberately rather than grow without direction.
180+

0 commit comments

Comments
 (0)