Skip to content

Architecture decisions

html-to-markdown records its architecture decisions as MADR files in adrs/, checked by adrlint. Org-wide decisions live in the agent-conventions log. Add a row here in the same change as a new record.

Number Title Status Date
0000 Record architecture decisions accepted 2026-10-30
0001 Parse with the astral-tl fork of tl accepted 2025-11-20
0002 Repair malformed HTML with html5ever accepted 2025-11-21
0003 One convert entry point returning ConversionResult accepted 2026-03-28
0004 Visitor as a Send field of ConversionOptions accepted 2026-05-13
0005 Tier-1 byte scanner with Tier-2 fallback accepted 2026-06-01
0006 MCP server as a feature-gated core module accepted 2026-06-20
0007 Tracing as the observability surface accepted 2026-07-30
0009 Prepare Swift artifacts before creating immutable release tags proposed 2026-11-04