Chuyển tới nội dung chính

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.

ADRDecisionStatusDateRelations
0001Shared-schema tenant isolationAccepted2026-09-09
0002Per-integration webhook credentialsAccepted2026-09-10Amended by 0042 (rotation and replacement)
0003Tailwind, DaisyUI, and Alpine for server-rendered pagesAccepted2026-09-10Amended by 0028 (browser tests)
0004OpenAI classification as a reviewed suggestionSuperseded2026-09-11Superseded by 0009
0005Immutable Release Note snapshotsAccepted2026-09-11Amended by 0046 (a correction is a new revision)
0006Organization roles and invitationsAccepted2026-09-14Amended by 0043 (role changes and removal)
0007CI gates and container supply chainAccepted2026-09-14Amended by 0026 (health check on the management port)
0008Durable change processing and changed-file review triggersAccepted2026-09-14
0009Automatic AI classification and neutral summariesAccepted2026-09-14Supersedes 0004; amended by 0035 (Project context, migration kind, limitations)
0010Release review lifecycleAccepted2026-09-14
0011Audiences and a release note per audienceAccepted2026-09-15Amended 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)
0012Category catalog per OrganizationAccepted2026-09-15
0013Context sufficiency and possible duplicatesAccepted2026-09-15
0014Sensitive paths per ProjectAccepted2026-09-15
0015Release notes in several languagesAccepted2026-09-15Amended by 0036 (a glossary for translations)
0016Integration sources and history importAccepted2026-09-15Amended by 0042 (a key held per Project, imports of a disconnected source)
0017GitLab sources and provider seamsAccepted2026-09-16Amended by 0042 (rotating a GitLab secret)
0018Linear sourcesAccepted2026-09-16Amended 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)
0019Jira sources and linked contextAccepted2026-09-17Amended by 0041 (branch and Linear keys, status at review); amended by 0042 (polls of a disconnected source, a Jira account change)
0020Automation rules and runsAccepted2026-09-19Amended by 0025 (Teams on scheduled triggers); amended by 0046 (correction runs)
0021Scheduled and signed automation triggersAccepted2026-09-20
0022A public changelogAccepted2026-09-20Amended by 0025 (Teams on scheduled triggers); amended by 0046 (revisions of an entry)
0023CSRF exemptions are scoped, never switched offAccepted2026-09-20
0024Notion and Confluence actionsAccepted2026-09-21Amended by 0046 (corrections edit the page in place)
0025Microsoft Teams and Zendesk actionsAccepted2026-09-21Amends 0020 and 0022; amended by 0046 (corrections to Teams and Zendesk)
0026Deployment observabilityAccepted2026-09-21Amends 0007
0027UI localizationAccepted2026-09-22Amended by 0034 (the account's language read on each request)
0028A dashboard, error pages, and a browser test suiteAccepted2026-09-22Amends 0003
0029One module, and the Apache licenceAccepted2026-09-22
0030Release automationAccepted2026-10-10Amends CONTRIBUTING.md
0031Quickstart bundleAccepted2026-10-02Builds on 0030
0032Documentation siteAccepted2026-10-12Builds on 0007 and 0030
0033Excluding a change from releasesAccepted2026-10-17Builds on 0010
0034The account's interface language is read on each requestAccepted2026-10-23Amends 0027
0035Notes bound to their evidence, and a selection per audienceAccepted2026-10-26Amends 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)
0036An Organization glossary for translated notesAccepted2026-10-27Amends 0015; refers to 0035; amended by 0040 (placeholders and identifiers restored in answers)
0037Security changes and release-wide note structureAccepted2026-10-29Amends 0011; refers to 0009, 0010, 0035, and 0036
0038A configurable AI temperatureAccepted2026-10-31Amends 0035; amended by 0039 (a fallback when a model refuses the temperature) and 0045 (no temperature for Anthropic)
0039Falling back when a model refuses the temperatureAccepted2026-11-01Amends 0038; refers to 0009; amended by 0045 (no longer for Anthropic)
0040Restoring placeholders and identifiers in translated answersAccepted2026-11-02Amends 0036; refers to 0015; amended on 2026-11-19 by its own amendment (code spans restored)
0041One piece of work once: branch and Linear keys, folding suggestions, and issue status at reviewAccepted2026-11-02Amends 0019; builds on 0013 and 0033
0042Disconnecting, reconnecting, and rotating a source, and showing its healthAccepted2026-11-11Amends 0002, 0016, 0017, 0018, and 0019; refers to 0020
0043Changing a member's role and removing a memberAccepted2026-11-12Amends 0006; refers to 0034
0044Retiring an audience without deleting itAccepted2026-11-12Amends 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)
0045Anthropic API version 2026-10-21, with no temperatureAccepted2026-11-15Amends 0038 and 0039; refers to 0009 and 0035
0046Correcting a published note with a new revisionAccepted2026-11-15Amends 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.