Skip to content

Architectural decision records

ADR-001 through ADR-010 were authored as part of the solution design pack and live in docs/design/RepoWrangler-Solution-Design.md:

  1. ADR-001 — Cloudflare Workers as the full-stack runtime
  2. ADR-002 — Public product code, optional private ops notes
  3. ADR-003 — Read-only GitHub App
  4. ADR-004 — Provider-neutral domain with adapters
  5. ADR-005 — Cloudflare D1 as the initial primary store
  6. ADR-006 — Webhooks + checkpointed reconciliation
  7. ADR-007 — Apache-2.0 license
  8. ADR-008 — No provider write actions in the MVP
  9. ADR-009 — Queues optional until benchmarked
  10. ADR-010 — Single-tenant first

Standalone ADRs in this directory:

  1. ADR-011 — Host-agnostic frontend and two deployment topologies
  2. ADR-012 — Drop-in theming (Hugo/Jekyll-style)
  3. ADR-013 — Platform-neutral architecture (Cloudflare = reference, not required)
  4. ADR-014 — Node server host for zero-Cloudflare deployment
  5. ADR-015 — PostgreSQL storage adapter
  6. ADR-016 — Microsoft Entra ID sign-in
  7. ADR-017 — Secret provider seam (env / file / Key Vault)
  8. ADR-018 — Scheduler drivers (external-tick)
  9. ADR-019 — Authentication provider registry (GitHub/GitLab/Entra/Google/local)

New ADRs get their own numbered Markdown file in this directory (ADR-011-<slug>.md onward) using the same Context / Decision / Consequences format.

Apache-2.0 licensed. Read-only by design.