# State machine — <entity> (/docs/maintain/_templates/state)

- **Status:** Draft
- **Last updated:** YYYY-MM-DD
- **Related ADRs:** ADR-NNNN

> Snapshot of the system as it stands today. Edit in place; never record what changed.

## Diagram [#diagram]

Draw this diagram with Archify too. In a copy, wrap the fence in
`<Diagram src="/diagrams/<project-slug>/<slug>.html" title="…">` … `</Diagram>`, with nothing else
inside: the page shows the Archify view and its Markdown the Mermaid. Outside the templates, a
bare Mermaid fence fails the build (ADR-0022).

```mermaid
stateDiagram-v2
  [*] --> Draft
  Draft --> Published: publish
  Published --> Deprecated: deprecate
  Deprecated --> [*]
```

## States [#states]

| State | Meaning | Who can see it |
|---|---|---|

## Transitions [#transitions]

| From | To | Trigger | Guard | Side effects |
|---|---|---|---|---|

## Terminal states [#terminal-states]

Which states are final, and what remains possible from them (read, redirect, archive).