Skip to content

Decision records

Architecturally significant decisions are recorded as MADR Architecture Decision Records under adrs/ in the repository. This page is the index of that log. Decisions that apply to every xberg-io repository are recorded once, in the org log.

  • One decision per file, named NNNN-kebab-title.md and numbered from 0000.
  • Front matter carries status, the date the decision was made and its decision-makers. A changed decision is a new ADR that supersedes or amends the old one; an accepted ADR is never edited.
  • adrlint lint and adrlint format --check check the log, configured by .adrlint.toml. Add the row to this page in the same change as the ADR.
ADR Title Status Date
0000 Record architecture decisions Accepted 2026-10-30
0001 Fixture-driven e2e suites against a mock HTTP server Accepted 2026-03-09
0002 HTTP first, with a feature-gated browser fallback Accepted 2026-03-23
0003 Crawl infrastructure as traits with working defaults Accepted 2026-04-01
0004 Markdown conversion is always on Accepted 2026-04-01
0005 SSRF policy on by default in the HTTP layer Accepted 2026-06-14
0006 One robots.txt parser crate for the engine and the browser Accepted 2026-09-29
0007 Use a protected ZIP extractor for optional browser downloads Proposed 2026-10-31