adf-codec/corpus/README.md

The corpus

One directory per contract kind, each landing with its milestone:

• round-trip/ — <name>.json + <name>.md: the markdown adfToMarkdown must emit for that document, byte for byte, and that markdownToAdf must read back to it (AGENTS.md §2). Grouped by node family, combinations/ holding what crosses them.
• normalization/ — <name>.md + <name>.json: markdown input, and the document markdownToAdf must build from it. One-way; the markdown is not canonical.
• errors/ — <name>.md: markdown input that must not convert. A <name>.error beside it pins which error.
• unspellable/ — <name>.json: ADF adfToMarkdown must refuse, the ConvertErrorCode in the <name>.error beside it. Two populations live here: refusals that stay contract, and documents a maintainer decision (todo.md) moves to round-trip/.
• real-payloads/ — <name>.json: sanitized live ADF, round-tripped ADF→markdown→ADF. No expected markdown.

JSON is editor-normal (AGENTS.md §2), two-space indent, keys sorted.