---
title: Decisions and ADRs
description: Where architectural choices are recorded and how to navigate them.
---

Linear owns delivery status. Durable _why_ lives in the repo:

| Location | Use |
| --- | --- |
| [`docs/decisions/README.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/decisions/README.md) | Decision register (small decisions as rows) |
| `docs/decisions/accepted/` | Accepted ADRs |
| `docs/decisions/proposed/` | Proposed ADRs |
| `docs/decisions/superseded/` | Historical ADRs |
| [`docs/PROGRESS.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/PROGRESS.md) | Append-only build log |
| [`docs/GLOSSARY.md`](https://github.com/blinqx-hq/basenet-rebuild-poc/blob/main/docs/GLOSSARY.md) | Domain terms (Wwft, BSN, …) |

## Relevant to the docs stack

- **ADR-0012** — Linear as source of truth
- **ADR-0018** — API contract and offline OpenAPI generation

When something is unspecified, pick the option most consistent with `AGENTS.md`, record it in the register (or an ADR), and continue — do not block.

Partner guides: [/partner](/partner) · Architecture: [/developers/architecture](/developers/architecture)