Name		Name	Last commit message	Last commit date
parent directory ..
0001-cloudflare-pages-over-workers.md		0001-cloudflare-pages-over-workers.md
0002-flutter-libbox-for-custom-app.md		0002-flutter-libbox-for-custom-app.md
0003-multi-cdn-strategy.md		0003-multi-cdn-strategy.md
0004-protocol-priority-order.md		0004-protocol-priority-order.md
0005-open-vs-closed-source.md		0005-open-vs-closed-source.md
0006-sops-age-secrets-management.md		0006-sops-age-secrets-management.md
0007-config-as-data.md		0007-config-as-data.md
0008-esbuild-typescript-worker.md		0008-esbuild-typescript-worker.md
0009-ansible-over-shell-scripts.md		0009-ansible-over-shell-scripts.md
0010-opentofu-cloud-iac.md		0010-opentofu-cloud-iac.md
0011-packer-immutable-images.md		0011-packer-immutable-images.md
README.md		README.md

README.md

Architecture Decision Records (ADRs)

We use ADRs to document significant architectural decisions. Each ADR follows the MADR format.

Index

#	Decision	Status	Date
0001	CF Pages over Workers for smart-sub	Accepted	2026-01-15
0002	Flutter + libbox for custom app	Proposed	2026-03-09
0003	Multi-CDN strategy to eliminate CF SPOF	Proposed	2026-03-09
0004	Protocol priority order for Iran	Accepted	2026-02-01
0005	Open vs closed source strategy	Accepted	2026-02-15
0006	sops + age for secrets management	Accepted	2026-03-26

Creating a New ADR

Copy an existing ADR as a template
Use the next sequential number: NNNN-short-title.md
Set status to Proposed
Fill in Context, Decision, Rationale, Consequences
Open a PR with the ADR for team review
Update status to Accepted when merged

Statuses

Proposed: Under discussion, not yet decided
Accepted: Decision made and in effect
Deprecated: No longer applies (superseded by another ADR)
Superseded: Replaced by a newer ADR (link to replacement)