Skip to content
Specification › Coverage map

AI Contributor Specification — Coverage map

Coverage

Coverage map

Every rule in the spec, aggregated by weight, pillar, and minimum level. Numbers are derived from the rule catalog at build time — they cannot drift.

Rules 240
MUST 54
MUST·when 68
SHOULD 78
MAY 40

By pillar

Pillar Clauses Rules MUSTMUST·whenSHOULDMAY
Engineering Foundation §1–4 4 33 190104
Security §5–9 5 38 711128
Quality & Reliability §10–14 5 33 58146
Release §15–16 2 17 4463
AI Agents §17–20 4 47 518159
AI Risk §21–22 2 28 21673
Oversight §23–29 7 44 1211147

By level (cumulative)

Level Rules at this level Cumulative Closure
L0 27 27
11%
L1 114 141
59%
L2 81 222
93%
L3 18 240
100%
L4 0 240
100%

This generated projection is rendered from tools/spec-authoring/templates/AI-CONTRIBUTOR-COVERAGE.md.template plus AI-CONTRIBUTOR-RULE-CATALOG.json. The template owns explanatory prose and placement; the catalog owns row grouping, scope, level, pillar, and display metadata. Regenerate it with tools/spec-authoring/generate-coverage.ts; do not edit the generated output by hand.

How to read the numbers

Use this file for planning, not for scoring. It tells you how many checklist rows exist at each level and pillar so you can estimate effort before an audit.

For a conformance claim, use AI-CONTRIBUTOR-CHECKLIST.md. If this file and the checklist disagree, rerun the catalog-backed generators; both files are projections of AI-CONTRIBUTOR-RULE-CATALOG.json.

At a glance

  • 207 total rows
  • 34 unconditional MUST + 57 MUST when applicable + 76 SHOULD + 40 MAY
  • 6 rows at L0 — Baseline Hygiene; 40 rows at L1 — Hardened; 28 rows at L2 — AI Assisted; 14 rows at L3 — AI Authored; 79 rows at L4 — AI Autonomous
  • 40 optional MAY rows

By scope

ScopeRows
MUST34
MUST when applicable57
SHOULD76
MAY40
Total207

By pillar

PillarTotalMUSTMwASHOULDMAY
1 · 🏗️ Engineering Foundation26111104
2 · 🛡️ Security3459128
3 · 🎯 Quality & Reliability2936146
4 · 🚀 Release132353
5 · 🤖 AI Agents39313149
6 · ⚠️ AI Risk2621473
7 · 🧭 Oversight40811147

By minimum conformance level

LevelRowsMUSTMwASHOULD
L0 — Baseline Hygiene6510
L1 — Hardened4022180
L2 — AI Assisted287210
L3 — AI Authored140140
L4 — AI Autonomous790376
— (MAY — never required)40

Cumulative closure bar

This table shows how many MUST and MUST when applicable rows a repository must close, or mark Not relevant with evidence, to claim each level. The “worst case” column assumes every MUST when applicable trigger applies. Many repositories will trigger fewer rows.

Claiming levelCumulative MUST + MwA (worst case)New rows over previous level
L06
L146+40
L274+28
L388+14
L491 (plus 76 SHOULD rows resolved)+3 MUST/MwA, +76 SHOULD