architecture-decision

name	architecture-decision
description	Conducts and records a verifiable GPT-RAG UI architectural decision. Use when a choice alters boundaries, contracts, identity, sessions, persistence, accessibility, deployment, or operation with meaningful reversal cost.

GPT-RAG UI architectural decision

1. Load the relevant engineering-principles references.
2. Define context, constraints, affected users and systems, and up to five prioritized characteristics with measures.
3. Compare at least two viable alternatives and the option of not changing.
4. Evaluate identity, authorization, session isolation, accessibility, backend compatibility, persistence, cost, operation, migration, and reversibility.
5. Record the decision under docs/adr/ using the ADR template.
6. Define fitness functions, adoption order, rollback or roll-forward, and a review trigger.

Do not turn a tool or framework preference into an architectural requirement. When evidence is missing, record a time-bounded investigation and its decision criterion instead of guessing.