---
title: mattpocock-adr-number-gap
description: Reports a missing number in the canonical Architecture Decision Record sequence from 0001.
---

[← All Rules](/rules/)

## What it does

Reports each absent four-digit number between `0001` and the highest canonical Architecture Decision Record number.

## Why it matters

A contiguous sequence makes missing or misnumbered decision records visible.

## Examples

### Non-passing

```text title="Repository tree"
docs/adr/
├── 0001-first-choice.md
└── 0003-third-choice.md
```

### Passing

```text title="Repository tree"
docs/adr/
├── 0001-first-choice.md
├── 0002-second-choice.md
└── 0003-third-choice.md
```

## When it applies

This is a declarative requirement of the `mattpocock@1` Profile. Selecting that Profile applies the requirement to canonical `adr` documents; it is not selected through the `rules` array.

## References

See [Presswork Configuration](/configuration/#mattpocock1) for the Profile contract and [`src/profile-requirements.ts`](https://github.com/evilkiwi/presswork/blob/main/src/profile-requirements.ts) for numeric-sequence evaluation.
