Skip to content

Architecture Decision Records

All significant design decisions are recorded here. Each ADR captures the context, the options considered, the decision made, and the rationale.

#TitleStatusDate
ADR-001Beachhead segment: agentic commerceAccepted2026-05-21
ADR-002Product shape: supervised operationsAccepted2026-05-21
ADR-003CommerceAdapter + ProductAdapter splitAccepted2026-05-21
ADR-004REST API from day 1 for all adaptersAccepted2026-05-21
ADR-005Adapter interface method contractsAccepted2026-05-21
ADR-006Identity resolution via channel contact profileAccepted2026-05-21
ADR-007Separate webhook controller per channelAccepted2026-05-21
ADR-008Approval request lifecycle and expiryAccepted2026-05-21
ADR-009Google Sheets ProductAdapter via API v4Accepted2026-05-21
ADR-010Laravel 13 as application frameworkAccepted2026-05-21
ADR-011LLM provider: OpenRouter + BYOKAccepted2026-05-21
ADR-012Support agent architectureAccepted2026-05-21