chore: condense all docs and markdown files

docs/adr/README.md

@@ -1,5 +1,13 @@
-# Architecture Decision Records
+# ADR Index
 
-ADRs capture cross-cutting or hard-to-reverse decisions. Add a new ADR when changing providers, async strategy, data model boundaries, or other architectural choices.
+Use ADRs for cross-cutting, hard-to-reverse decisions.
 
-Use the template in `docs/templates/adr.md` and increment the numeric prefix (`0002`, `0003`, ...).
+## Existing ADRs
+- `0001-synchronous-external-calls-mvp.md`
+- `0002-moyasar-payment-gateway.md`
+- `0003-authentica-otp-provider.md`
+
+## Add New ADR
+- Copy `docs/templates/adr.md`
+- Use next numeric prefix (`0004`, `0005`, ...)
+- Keep status updated (`Proposed`, `Accepted`, `Deprecated`, `Superseded`)