Skip to content

Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) for QualCoder v2.

ADRs capture significant technical decisions: what was decided, why, and what the consequences are. They are immutable once accepted — superseded decisions get a new ADR rather than editing the old one.

Format

Each ADR follows the Michael Nygard format: - Context — the situation forcing a decision - Decision — what was decided - Consequences — trade-offs, positive and negative

Index

ADR Title Status
ADR-001 UUIDv7 as Primary Keys for All Entities Accepted
ADR-002 Transactional Outbox + Cursor Pull + LWW as Sync Engine Pattern Accepted