refactor: migrate Markdown to AsciiDoc

.claude/PROJECT.adoc

@@ -0,0 +1,34 @@
+== NextGen Language Evangeliser - Claude Code Instructions
+
+This repository contains the Next Generation Language Evangeliser
+project.
+
+=== Project Structure
+
+....
+nextgen-language-evangeliser/
+├── .claude/         # AI assistant instructions
+├── .git/           # Version control
+├── .gitignore      # Git ignore rules
+├── .editorconfig   # Editor configuration
+└── ...             # Evangelism files
+....
+
+=== Build Commands
+
+Refer to project-specific documentation.
+
+=== Coding Conventions
+
+* Follow hyperpolymath standards
+* All code must have SPDX license headers
+* Use approved languages only (see CLAUDE.md)
+* Document all non-obvious decisions
+
+=== Security
+
+* No hardcoded secrets
+* All secrets through environment variables or secret management
+* SHA-pinned dependencies where applicable
+* HTTPS only, no HTTP URLs
+* No MD5/SHA1 for security purposes

ARCHITECTURE.adoc

@@ -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_