Product-shaping decisions (contracts, data model, architecture, security posture) that a bare clone / CI / future maintainer must understand — recorded as plain numbered Markdown files in the Nygard ADR format (Context → Decision → Options → Consequences).
These are the tracked, product-level companion to the on-disk deliberation notes under
docs/superpowers/ (gitignored). An ADR records the DECISION and its trade-offs; the design
note records the deliberation. docs/ROADMAP.md rows link their governing ADR here.
ADRs are authored when a slice's stakes warrant one (a contract/data-model/architecture/ security-posture decision), not retroactively for pre-existing history.
| ADR | Title | Feature |
|---|---|---|
| 0001 | Logical-decoding message delivery guarantees (transactional vs non-transactional) | A2 |
| 0002 | Multi-publication per pipeline (discovery union + fail-closed existence check) | A3 |
| 0003 | The value-free error, log, and telemetry boundary (Critical Rule 1) | D8 |
| 0004 | The commit-LSN transaction-granularity watermark (Critical Rule 3) | D8 |
| 0005 | Spill is ephemeral non-fsync'd scratch, not a durable WAL | D8 |
| 0006 | Fail-closed supervision — :one_for_all Pipeline + :temporary child | D8 |
| 0007 | Actual replication-session identity precedes checkpoint lookup | D2 |