Architecture Decision Records

Key technical decisions that shape LocusFlow's architecture. Each ADR captures the context, decision, and consequences — so future contributors understand why, not just what.

58 decisions13 Data Architecture9 Domain Logic3 UI & Navigation3 LLM Integration20 Infrastructure6 Onboarding & Features4 Reflection & Synthesis
001
InboxItem Data Model and Capture Flow
Domain Logicprocessing-flowitem-lifecycledata-model
002
Local-first, offline-only architecture
Infrastructurepersistence-localprivacy-security
003
MVVM + Repository + Use Case layering
Data Architecturedata-modelstate-management
004
Room as persistence mechanism
Data Architecturedatabase-schemapersistence-local
005
Exclude network stack from initial scope (No network)
Infrastructureprivacy-securitypersistence-local
006
UI State Modeling Strategy
UI & Navigationstate-managementcompose-ui
007
Error Handling Philosophy (Fail Silently vs Explicit)
Domain Logicstate-management
008
Processing Decision Taxonomy
Domain Logicprocessing-flowitem-lifecycle
009
One-to-one Transformation Model
Data Architecturedata-modelitem-lifecycle
010
Deletion vs Archival of InboxItem
Data Architectureitem-lifecyclepersistence-local
1 / 6