---
id: "0003"
date: 2026-05-20
status: Accepted
supersedes: "0002"
superseded-by:
affected-paths: [config/]
affected-components: [config-export]
---

# 0003 — Use YAML for config exports

## Context

Support staff annotate exported configs; JSON's lack of comments caused a workaround mess of sidecar files.

## Decision

Config exports are serialized as YAML with inline comments preserved.

## Consequences

Human-annotatable exports; YAML parser pinned to avoid the inconsistencies that motivated ADR-0002.

## Alternatives rejected

Staying on JSON rejected: sidecar-file workaround was error-prone. TOML rejected: unfamiliar to support staff.
