Skip to content

Architecture Decision Records

This directory contains the Architecture Decision Records (ADRs) for Ladon. Each ADR documents a significant technical decision: the context, the options considered, the chosen option, and — crucially — why that option was chosen over the alternatives.

ADR Title Status
ADR-001 Ladon Architecture Accepted
ADR-002 HTTP Result Contract Accepted
ADR-003 Plugin Adapter Interface Accepted
ADR-004 Source / Expander / Sink Protocol Design Accepted
ADR-005 Asset Storage (ladon.storage) Accepted — Phase 3
ADR-006 Persistence Layer (ladon.persistence) Accepted — Phase 3
ADR-007 Per-Host Circuit Breaker Accepted
ADR-008 robots.txt Enforcement Accepted
ADR-009 Observability (metrics, structured logs) Proposed — Phase 3
ADR-010 Dual-License Model (AGPL-3.0-only + Commercial) Accepted

Format

ADRs follow the MADR template. To propose a new decision, copy docs/decisions/adr-template.md, fill in the sections, and open a PR.