# Architecture Decision Records

Short records of significant technical choices in chat-widget.

## Format

Each ADR includes:

- **Status** — accepted, superseded, etc.
- **Context** — problem or constraint
- **Decision** — what we chose
- **Consequences** — trade-offs

## Index

| ADR | Title |
|-----|-------|
| [001](./001-vanilla-js-no-build.md) | Vanilla JS with no build step |
| [002](./002-iframe-isolation.md) | Iframe isolation for embed safety |
| [003](./003-netlify-functions-proxy.md) | Netlify Functions as OpenAI proxy |
| [004](./004-postmessage-config-protocol.md) | postMessage for config delivery |
| [005](./005-canonical-embed-path.md) | Single canonical embed path |