Architecture Decisions

CryptoDesk AI uses Architecture Decision Records to keep important technical tradeoffs visible over time.

Documented Decisions

Current published ADRs include:

• ADR 001: Electron for desktop delivery
• ADR 003: OS keychain strategy
• ADR 004: IPC channel design with Zod validation
• ADR 005: Security-sensitive IPC channel handling
• ADR 006: CCXT integration strategy
• ADR 007: Market store integration strategy
• ADR 008: Portfolio fetch strategy for read-only connectivity
• ADR 009: Simulation mode strategy
• ADR 010: Explainable AI integration strategy

Together, these decisions explain how the product stayed aligned with its non-custodial, simulation-first, and explainable-AI principles as the codebase grew.

Why ADRs Matter

ADRs help in three ways:

• they preserve the reasoning behind a choice, not just the outcome
• they reduce architectural drift across phases
• they make reviews easier because assumptions are written down