---
title: mattpocock-adr-structure-invalid
description: Reports a Matt Pocock Profile Architecture Decision Record without its required title and decision paragraph.
---

[← All Rules](/rules/)

## What it does

Reports an Architecture Decision Record that does not contain exactly one H1 followed immediately by an authored paragraph of one to three sentences before any later heading.

## Why it matters

Each record begins with a title and a concise statement of the decision before optional detail.

## Examples

### Non-passing

```md title="docs/adr/0001-use-postgres.md"
# Use Postgres

- Store durable application data in Postgres.

## Consequences
```

### Passing

```md title="docs/adr/0001-use-postgres.md"
# Use Postgres

We will use Postgres for durable application data.

## Consequences
```

## When it applies

This is a declarative requirement of the `mattpocock@1` Profile. Selecting that Profile applies the requirement to candidate `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 structural evaluation.