ADR-00xx:

December 22, 2025 · View on GitHub

  • Status: Proposed | Accepted | Superseded by ADR-00yy
  • Date: YYYY-MM-DD
  • Related features/specs: Feature 00x (docs/specs/4-architecture/features/00x/spec.md), …
  • Related open questions: OQ-00x-01, …

Context

Describe the problem and why this decision is needed. Call out:

  • Architectural/non-functional constraints.
  • Affected modules (core/application/infra-persistence/cli/rest-api/ui).
  • Any prior behaviour or decisions being revisited.

Decision

State the chosen option clearly and concisely. Include:

  • What is being changed or introduced.
  • How this applies across modules/facades where relevant.

Consequences

Positive

  • …

Negative

  • …

Alternatives Considered

List the main options (A, B, C…) that were considered, with very short pros/cons for each.

Security / Privacy Impact

Summarise how this decision affects:

  • Secret handling and redaction.
  • Attack surface, isolation, or trust boundaries.

Operational Impact

Summarise how this decision affects:

  • Operability (monitoring, maintenance, runbooks).
  • Performance or resource usage, if relevant.
  • Related spec sections: docs/specs/4-architecture/features/00x/spec.md#…
  • Related ADRs: ADR-000y, …
  • Related issues / PRs: …