Architecture decision records

An ADR records one significant design decision: the context, the choice, the alternatives weighed, and the consequences. ADRs explain why PostProject behaves as it does. Current behavior is defined by the concept pages and the API reference; when an ADR and those pages disagree about the present, the present-tense pages win and the ADR is amended.

Read the relevant ADR before changing an invariant, a boundary, or a public contract. A change that alters a decision amends that record or adds a new one.

Identity and the media model

• ADR 0001 — Project naming

• ADR 0002 — Internal and external identity

• ADR 0003 — Compound media model

• ADR 0011 — Host-object binding

• ADR 0012 — Root container naming

• ADR 0015 — Availability semantics and collection fingerprints

• ADR 0017 — Portable root identity

• ADR 0028 — Comparable and foreign fingerprint domains in resolution

• ADR 0030 — Canonical locator spelling for hosts

• ADR 0037 — Media sources for import and representations

• ADR 0038 — Image-sequence file names belong to the locator

Knowledge, history, and change

• ADR 0004 — Standards-aware metadata

• ADR 0005 — Activity-based provenance

• ADR 0006 — Rational time

• ADR 0007 — Revision and event model

• ADR 0013 — Namespace policy

• ADR 0021 — Fingerprint observations and activity snapshots

• ADR 0029 — Content fingerprints and observation for hosts

• ADR 0035 — Reporting the outcome of a content observation

• ADR 0022 — Managed-artifact state and staleness

• ADR 0024 — Dependency relationships

• ADR 0027 — Change delivery

Media services and work

• ADR 0018 — Discovery index location

• ADR 0019 — Media inspection boundary

• ADR 0031 — Resolution scope, budgets, batches, and cancellation

• ADR 0023 — Job model and execution boundary

• ADR 0025 — Reference local executor

Public surfaces, persistence, and compatibility

• ADR 0075 — CLI scoped decisions

• ADR 0076 — C++ target metadata

• ADR 0077 — Known-media lookup inputs

• ADR 0078 — Jobless output registration

• ADR 0079 — Imported representation identity

• ADR 0080 — Edit construction and attribution

• ADR 0084 — Advanced Python modules

• ADR 0083 — Python metadata read values

• ADR 0082 — Verified relink selection

• ADR 0081 — Produced output registration

• ADR 0074 — Canonical commit receipts

• ADR 0073 — Direct file inputs

• ADR 0072 — Atomic native resolution options

• ADR 0071 — Native Python metadata inputs

• ADR 0070 — Unified Python edits

• ADR 0068 — Python coherent asset scans

• ADR 0069 — Atomic C++ resolution configuration

• ADR 0008 — Python binding over the C ABI

• ADR 0009 — Explicit SQL without an ORM

• ADR 0010 — OpenAssetIO boundary

• ADR 0014 — Native concurrency contract

• ADR 0032 — C++ error reporting without exceptions

• ADR 0033 — Propagating C++ results

• ADR 0034 — A warning-free C++ header in host builds

• ADR 0036 — Readable C++ metadata values

• ADR 0039 — Platform wheels carrying the native library

• ADR 0016 — Documentation site generator

• ADR 0020 — Integration-preview compatibility tier

• ADR 0026 — Domain query cursors

• ADR 0040 — ABI usage evidence and compatibility families

• ADR 0041 — Known-media adoption

• ADR 0042 — Semantic optimistic write conflicts

• ADR 0043 — Local shared productions

• ADR 0044 — Closed transaction guard ownership

• ADR 0045 — Coherent reads and commit receipts

• ADR 0046 — Python UUID hints and explicit references

• ADR 0047 — Local cursor scope and lifetime

• ADR 0048 — Immediate option validation

• ADR 0049 — Native semantic identities

• ADR 0050 — Bounded revision events

• ADR 0051 — Closed job-state projections

• ADR 0052 — Mergeable metadata and destructive decisions

• ADR 0053 — Fresh bounded media-root reads

• ADR 0054 — C++ dynamic reference values

• ADR 0055 — CLI dependency submission outcomes

• ADR 0056 — Decision-bound content observations

• ADR 0057 — Authority-controlled job leases

• ADR 0058 — Job input decisions

• ADR 0059 — CLI output and errors

• ADR 0060 — Bounded convenience reads

• ADR 0061 — Representation content values

• ADR 0062 — Artifact result alternatives

• ADR 0063 — Resolution outcome values

• ADR 0064 — Binding boundary errors

• ADR 0065 — Portable knowledge exchange

• ADR 0066 — Development history resynchronization

• ADR 0067 — Native portable exchange projection