"Why did we do it this way?" is the most expensive question in software. Statefulai captures the decision, links it to the code, and surfaces it automatically — six weeks later, six months later, for whoever asks.
One Tuesday afternoon. One question on a Monday morning, weeks later. The lineage is automatic.
@idempotent-writes, and updates the architectural graph.
BillingService.flush(). ADR-014's original constraint was correct — the implementation drifted from it.
▸ episodic · incident-2026-05-11 · linked to ADR-014
Whitelisted channels are scanned for architectural decisions. The bot proposes capture; you confirm with a 👍. False positives are throwaway-cheap.
Drop ADR markdown files into docs/adr/ and Statefulai picks them up as episodic memory, parses front-matter, and links to referenced symbols.
Type /statefulai remember in any channel — or use the agent tool call memory.store({type:"adr"}) — to make a decision official.