refactor: migrate Markdown to AsciiDoc

.migration/PYTHON_TO_RUST_RESCRIPT.adoc

@@ -0,0 +1,29 @@
+== Python → Rust/AffineScript Migration Guide
+
+=== Policy
+
+This repo contains Python code that should be migrated to: - *Rust* for
+systems/ML/backend code - *ReScript* for web/frontend/scripting
+
+=== Why
+
+* Python has dynamic typing and runtime errors
+* Rust provides memory safety and performance
+* ReScript provides type safety and JS interop
+
+=== Migration Steps
+
+[arabic]
+. Identify Python files by purpose (systems vs web)
+. Create equivalent Rust modules in `+src/+` or ReScript in
+`+src/*.res+`
+. Use `+cargo+` or `+rescript+` build systems
+. Remove Python files after migration
+. Update CI/CD
+
+=== Exceptions
+
+* SaltStack configurations (exempt)
+* One-time scripts (convert to shell/Rust)
+
+=== Status: PENDING MIGRATION