Architecture Decision Records

Records of the significant, hard-to-reverse decisions for this repository. Each ADR states the context, the decision, and its consequences. ADRs are immutable once accepted; a later ADR supersedes an earlier one rather than editing it.

ADR

Title

Status

0001

Repository purpose and boundary

Purpose/boundary superseded by 0009

0002

Distribute as an installable Python package bundling schemas and template

Accepted

0003

Build and release model

Accepted

0004

SBOM and supply-chain provenance

Accepted

0005

Automatic release on merge to main (amends 0003)

Superseded by 0006

0006

Conventional-commit-driven automatic releases (reusable blueprint)

Versioning superseded by 0007

0007

Changelog-driven versioning (reusable blueprint)

Superseded by 0008

0008

Adopt release-please (reusable blueprint)

Accepted

0009

Scenario packs are strictly subordinate to ACES (zero extensions)

Accepted

0010

Consume ACES reusable-asset trust policy for pack provenance

Accepted

0011

Require pinned ACES SDL validation for scenario packs

Accepted

0012

Pack content identity consumes ACES associated-artifact manifests

Accepted

0013

Separate consumer static validation from author CI

Accepted

0014

Keep governed concept references in ACES concept-authority

Accepted

0015

Attest Python distribution build provenance

Accepted

0016

Automate dependency updates and ship ACES bumps as releases

Accepted

0017

Sign release tags with keyless Sigstore

Accepted

0018

OpenSSF Scorecard posture

Accepted

0019

Preserve history in dev-to-main promotions

Accepted