Architectural decisions are captured with provenance — who, when, from which conversation — and cited back automatically the next time they're relevant: in a spec, on a PR, or in a question asked in Teams.
Direct provider calls are forbidden from client apps. Decided after the March incident review; supersedes the 2024 direct-integration pattern.
@Foixar why can't the portal call the payments provider directly? Would save us a hop.
Because your team decided against it in March — after the incident review, all payment traffic goes through the gateway. The direct pattern was retired. Two examples already follow it: invoice-pay and refunds.
cited: ADR-014 · decided 14 Mar 2026Nobody maintains a decision log by hand. So Foixar captures decisions where they actually happen.
Decisions land from Feature Studio Q&A, document imports, and Ask Foixar conversations — a by-product of work, not a separate chore that dies in week three.
zero "update the wiki" ticketsWhen a spec, a PR check, or a Teams question touches a past decision, Foixar cites it — with the who and the when — instead of letting the debate restart from zero.
provenance on every citationThe architect who decided it changes teams; the context stays. New joiners inherit the "why" on day one instead of doing archaeology in month three.
the team member who never leavesImport your existing ADRs in the demo and ask Foixar why.