refactor: migrate repository documentation from Markdown to AsciiDoc

Author: hyperpolymath

.migration/RUBY_TO_RUST.adoc

@@ -0,0 +1,16 @@
+== Ruby → Rust Migration Guide
+
+=== Policy
+
+Ruby code should be migrated to Rust for: - Better memory safety -
+Performance improvements - Static typing
+
+=== Migration Steps
+
+[arabic]
+. Create `+Cargo.toml+` and `+src/main.rs+`
+. Convert Ruby classes to Rust structs
+. Use `+serde+` for serialization
+. Remove Gemfile and *.rb files after migration
+
+=== Status: PENDING MIGRATION

.migration/RUBY_TO_RUST.md

@@ -0,0 +1,48 @@
+== Architecture
+
+=== Overview
+
+This repository follows a modular, maintainable architecture designed
+for clarity, scalability, and long-term sustainability.
+
+=== Directory Structure
+
+....
+.
+├── src/           # Source code
+├── tests/        # Test suites
+├── docs/         # Documentation
+├── scripts/      # Utility scripts
+├── config/       # Configuration files
+├── LICENSE       # License file
+├── LICENSES/     # Full license texts
+└── README.adoc   # Project documentation
+....
+
+=== Design Principles
+
+* *Separation of Concerns*: Each module has a single responsibility
+* *Testability*: Code is written to be easily testable
+* *Documentation*: All public APIs are documented
+* *Configuration*: Environment-specific settings are externalized
+
+=== Dependencies
+
+* External dependencies are minimized and clearly declared
+* Version pinning is used for reproducibility
+
+=== Security Considerations
+
+* Sensitive data is never committed to the repository
+* Secrets are managed through environment variables or secure vaults
+* Regular dependency audits are performed
+
+=== Maintainability
+
+* Code follows consistent style guidelines
+* Pull requests require review and CI checks
+* Issues and discussions are tracked transparently
+
+'''''
+
+_Last updated: 2026-07-18_

ARCHITECTURE.adoc

@@ -0,0 +1,83 @@
+== Changelog
+
+All notable changes to `+absolute-zero+` will be documented in this
+file.
+
+This file is generated from conventional commits by the
+https://github.com/hyperpolymath/standards/blob/main/.github/workflows/changelog-reusable.yml[`+changelog-reusable.yml+`]
+workflow (`+hyperpolymath/standards#206+`). Adopt the workflow in this
+repo’s CI to keep this file in sync automatically — see
+https://github.com/hyperpolymath/standards/blob/main/templates/cliff.toml[`+templates/cliff.toml+`]
+for the canonical config.
+
+The format follows https://keepachangelog.com/en/1.1.0/[Keep a
+Changelog]; this project aims to follow
+https://semver.org/spec/v2.0.0.html[Semantic Versioning].
+
+=== [Unreleased]
+
+==== Added
+
+* feat(proofs): complete CNO + OND pillars, verified across six provers
+(#100) — OND pillar authored (OND-1..5, zero axioms) in
+Coq/Lean/Agda/Z3; single gate `+proofs/verify-all-provers.sh+` →
+`+ALL-PROVERS-GREEN+`; Isabelle CNO repaired + OND added; Mizar
+`+CNO.miz+` rewritten and verifying; Idris ABI builds
+* feat(ci): add `+.github/workflows/proofs.yml+` (Coq + Z3 proof
+verification)
+* feat(absolute-zero): complete loadStore_preserves_memory proof — no
+sorry
+
+==== Fixed
+
+* fix(proofs): remove/correct three latent-unsound Coq axioms
+(`+no_cloning+`, `+Cconj_Cexp+`, `+eta_equivalence+`); discharge CNO
+axiom base 98 → small classified remainder (#100)
+* fix(abi): repair Idris packaging + 6 latent type errors — ABI builds
+clean (#100)
+* fix(baseline): repair main + estate-policy sweep (unblocks #41) (#42)
+* fix(governance): enumerate banned-language demos in .hypatia-ignore
+(#44)
+* fix(coq/cno): drop cno_decidable axiom (Rice’s theorem territory)
+(#36)
+* fix(licence): canonicalise to PMPL-1.0-or-later per authorship check
+(#133) (#34)
+* fix(lean4/cno): finish loadStore_preserves_memory cons-case build
+(#28)
+* fix(lean4/cno): finish loadStore_preserves_memory cons-case build
+(#23)
+* fix(licence): canonicalise to PMPL-1.0-or-later per authorship check
+(#133) (#22)
+* fix(licence): clear scaffold-placeholder leak (isolated; dirty repo)
+(#20)
+* fix(ci): sync hypatia-scan.yml to canonical (413:
+env.HOME+Phase-2+SARIF) (#18)
+* fix(ci): adopt canonical hypatia-scan.yml (env.HOME/scanner-layout +
+Comment-step gate) (#16)
+
+==== Documentation
+
+* docs: Phase 1 per-axiom triage of 72 Coq Axioms (#58)
+* docs: seed docs/proof-debt.md per trusted-base policy (#52)
+* docs: record tech-debt audit findings (2026-05-26) (#47)
+
+==== CI
+
+* ci(rust): convert rust-ci.yml to thin wrapper (standards#174 refile)
+(#53)
+* ci: bump actions/upload-artifact SHA to current v4 (#12)
+* ci(secret-scanner): drop duplicate –fail from trufflehog extra_args
+(#11)
+* ci: fix workflow-linter YAML parse error + self-flag bug
+* ci(antipattern): fix top-level dir matching + benchmarks/lsp/bench
+filename allowlists (#9)
+
+=== Pre-history
+
+Prior commits to this file’s introduction are recorded in git history
+but not formally classified into Keep-a-Changelog sections. To backfill,
+run `+git cliff -o CHANGELOG.md+` locally using the canonical
+https://github.com/hyperpolymath/standards/blob/main/templates/cliff.toml[`+cliff.toml+`]
+— this is one-shot mechanical work.
+
+'''''

ARCHITECTURE.md

@@ -0,0 +1,24 @@
+== Contributor Covenant Code of Conduct
+
+=== Our Pledge
+
+We pledge to make participation a harassment-free experience for
+everyone.
+
+=== Our Standards
+
+*Positive behavior:* * Using welcoming language * Being respectful of
+differing viewpoints * Accepting constructive criticism * Focusing on
+what is best for the community
+
+*Unacceptable behavior:* * Harassment, trolling, or personal attacks *
+Publishing private information without permission
+
+=== Enforcement
+
+Report issues to the maintainers. All complaints will be reviewed.
+
+=== Attribution
+
+Adapted from https://www.contributor-covenant.org/[Contributor Covenant]
+v2.1.