Architecture decision records
Each record states one decision, the context that forced it, and its consequences. A record is not rewritten once accepted: a later decision that changes it says so in its own header, and this index shows the relation in both directions.
New records take the next number, use the same headings (Context, Decision,
Consequences), and are added to this table in the same pull request as the behavior
they describe.
| ADR | Decision | Status | Date | Relations |
|---|---|---|---|---|
| 0001 | Shared-schema tenant isolation | Accepted | 2026-09-09 | |
| 0002 | Per-integration webhook credentials | Accepted | 2026-09-10 | Amended by 0042 (rotation and replacement) |
| 0003 | Tailwind, DaisyUI, and Alpine for server-rendered pages | Accepted | 2026-09-10 | Amended by 0028 (browser tests) |
| 0004 | OpenAI classification as a reviewed suggestion | Superseded | 2026-09-11 | Superseded by 0009 |
| 0005 | Immutable Release Note snapshots | Accepted | 2026-09-11 | Amended by 0046 (a correction is a new revision) |
| 0006 | Organization roles and invitations | Accepted | 2026-09-14 | Amended by 0043 (role changes and removal) |
| 0007 | CI gates and container supply chain | Accepted | 2026-09-14 | Amended by 0026 (health check on the management port) |
| 0008 | Durable change processing and changed-file review triggers | Accepted | 2026-09-14 | |
| 0009 | Automatic AI classification and neutral summaries | Accepted | 2026-09-14 | Supersedes 0004; amended by 0035 (Project context, migration kind, limitations) |
| 0010 | Release review lifecycle | Accepted | 2026-09-14 | |
| 0011 | Audiences and a release note per audience | Accepted | 2026-09-15 | Amended by 0035 (a selection and headline per audience), 0037 (security and release-wide note structure), and 0044 (retired audiences); amended by 0046 (revisions of a published note) |
| 0012 | Category catalog per Organization | Accepted | 2026-09-15 | |
| 0013 | Context sufficiency and possible duplicates | Accepted | 2026-09-15 | |
| 0014 | Sensitive paths per Project | Accepted | 2026-09-15 | |
| 0015 | Release notes in several languages | Accepted | 2026-09-15 | Amended by 0036 (a glossary for translations) |
| 0016 | Integration sources and history import | Accepted | 2026-09-15 | Amended by 0042 (a key held per Project, imports of a disconnected source) |
| 0017 | GitLab sources and provider seams | Accepted | 2026-09-16 | Amended by 0042 (rotating a GitLab secret) |
| 0018 | Linear sources | Accepted | 2026-09-16 | Amended by 0042 (rotating a Linear secret); amended on 2026-11-19 by its own amendment (fresh by webhookTimestamp, a refusal's proof in the log) |
| 0019 | Jira sources and linked context | Accepted | 2026-09-17 | Amended by 0041 (branch and Linear keys, status at review); amended by 0042 (polls of a disconnected source, a Jira account change) |
| 0020 | Automation rules and runs | Accepted | 2026-09-19 | Amended by 0025 (Teams on scheduled triggers); amended by 0046 (correction runs) |
| 0021 | Scheduled and signed automation triggers | Accepted | 2026-09-20 | |
| 0022 | A public changelog | Accepted | 2026-09-20 | Amended by 0025 (Teams on scheduled triggers); amended by 0046 (revisions of an entry) |
| 0023 | CSRF exemptions are scoped, never switched off | Accepted | 2026-09-20 | |
| 0024 | Notion and Confluence actions | Accepted | 2026-09-21 | Amended by 0046 (corrections edit the page in place) |
| 0025 | Microsoft Teams and Zendesk actions | Accepted | 2026-09-21 | Amends 0020 and 0022; amended by 0046 (corrections to Teams and Zendesk) |
| 0026 | Deployment observability | Accepted | 2026-09-21 | Amends 0007 |
| 0027 | UI localization | Accepted | 2026-09-22 | Amended by 0034 (the account's language read on each request) |
| 0028 | A dashboard, error pages, and a browser test suite | Accepted | 2026-09-22 | Amends 0003 |
| 0029 | One module, and the Apache licence | Accepted | 2026-09-22 | |
| 0030 | Release automation | Accepted | 2026-10-10 | Amends CONTRIBUTING.md |
| 0031 | Quickstart bundle | Accepted | 2026-10-02 | Builds on 0030 |
| 0032 | Documentation site | Accepted | 2026-10-12 | Builds on 0007 and 0030 |
| 0033 | Excluding a change from releases | Accepted | 2026-10-17 | Builds on 0010 |
| 0034 | The account's interface language is read on each request | Accepted | 2026-10-23 | Amends 0027 |
| 0035 | Notes bound to their evidence, and a selection per audience | Accepted | 2026-10-26 | Amends 0009 and 0011; amended by 0038 (a configurable temperature); amended on 2026-11-19 by its own amendment (an action whose note has nothing for its audience is skipped) |
| 0036 | An Organization glossary for translated notes | Accepted | 2026-10-27 | Amends 0015; refers to 0035; amended by 0040 (placeholders and identifiers restored in answers) |
| 0037 | Security changes and release-wide note structure | Accepted | 2026-10-29 | Amends 0011; refers to 0009, 0010, 0035, and 0036 |
| 0038 | A configurable AI temperature | Accepted | 2026-10-31 | Amends 0035; amended by 0039 (a fallback when a model refuses the temperature) and 0045 (no temperature for Anthropic) |
| 0039 | Falling back when a model refuses the temperature | Accepted | 2026-11-01 | Amends 0038; refers to 0009; amended by 0045 (no longer for Anthropic) |
| 0040 | Restoring placeholders and identifiers in translated answers | Accepted | 2026-11-02 | Amends 0036; refers to 0015; amended on 2026-11-19 by its own amendment (code spans restored) |
| 0041 | One piece of work once: branch and Linear keys, folding suggestions, and issue status at review | Accepted | 2026-11-02 | Amends 0019; builds on 0013 and 0033 |
| 0042 | Disconnecting, reconnecting, and rotating a source, and showing its health | Accepted | 2026-11-11 | Amends 0002, 0016, 0017, 0018, and 0019; refers to 0020 |
| 0043 | Changing a member's role and removing a member | Accepted | 2026-11-12 | Amends 0006; refers to 0034 |
| 0044 | Retiring an audience without deleting it | Accepted | 2026-11-12 | Amends 0011; refers to 0009, 0015, 0020, 0035, and 0036; amended on 2026-11-19 by its own amendment (nothing_for_audience, a second reason to skip) |
| 0045 | Anthropic API version 2026-10-21, with no temperature | Accepted | 2026-11-15 | Amends 0038 and 0039; refers to 0009 and 0035 |
| 0046 | Correcting a published note with a new revision | Accepted | 2026-11-15 | Amends 0005, 0011, 0020, 0022, 0024, and 0025; refers to 0015, 0036, 0040, 0043, and 0044 |
Dates are as each record states them; 0031 carries an earlier date than 0030, which it
builds on. Records 0029 and 0030 mention a slice plan (feature-parity-slice-plan.md, slice S24)
that was a working document and is not part of this repository.