ADR-XXX: [Short Title]

• Status: Proposed | Accepted | Deprecated | Superseded by ADR-YYY
• Date: YYYY-MM-DD
• Deciders: [Names or "Core Team"]
• Tags: [e.g., ingestion, retrieval, cost, observability]

Context

What is the issue we are trying to solve? What forces are at play (technical, business, organizational)?

Include relevant background, constraints, and links to issues or discussions.

Decision

What is the change we are proposing or have implemented?

Be specific. Use clear language.

Consequences

Positive

• ...
• ...

Negative

• ...
• ...

Neutral / Trade-offs

• ...

Alternatives Considered

1. Alternative A
   Pros: ... Cons: ...

2. Alternative B
   Pros: ... Cons: ...

References

• Related issues: #xx, #yy
• External links or papers

---

Notes: This template is based on a lightweight version of Michael Nygard’s ADR format, adapted for fast iteration in a high-velocity AI engineering project.