Task — engineering-spec@1

"ADR backfill for irreversible decisions"

doneTASK-IMP-058
module improvement · class product · priority p1 · created 2026-07-08 · shipped null
depends on none · blocks none

TASK-IMP-058: ADR backfill for irreversible decisions

Summary

Backfill ADRs for irreversible calls agents keep re-litigating: own-chat, AGE removal, payload vs platform, rules_sha cone, HITL gates (R50 + batch/12d).

Problem

Strategy docs bury decisions; future agents re-propose rejected paths.

Proposed Solution

Five accepted ADRs under docs/adrs/ plus an index README; thin docs/adr/ alias pointer. Cross-link DEC rows when present; do not invent a fake ledger.

Alternatives Considered

Success Metrics

Scope

In scope: ADR bodies + index + docs/adr/ pointer. Out of scope: full DEC ledger migration.

AI Authorship Disclosure

1. Description (normative)

2. Acceptance criteria

3. Edge cases