ADR-0003: Event-sourced ADR index (test scaffold)

Context

This record exists only for automated and manual testing of ADR ingestion, graph generation, and repository workflows. It describes a fictional architectural shift so tooling can validate parsing, linking, and visualization without touching production behavior.

Decision

Fictional change (not implemented): treat the ADR directory as an append-only event log. Each ADR file is an immutable event; a derived ADR index (e.g. adr-index.json) would be rebuilt from the log on every change. Readers would use the index for fast lookups; the Markdown files remain the source of truth.

In this test scenario, Unfold Engine would emit both architecture.json (graph) and adr-index.json (ordered ADR metadata) on webhook-triggered runs.

Consequences

• Test-only: no code or deployment changes are implied by this document
• If this pattern were real: stronger audit trail and reproducible index builds; more storage and build steps
• Safe to delete or replace this ADR when tests no longer need a sample architecture change