refactor: migrate Markdown to AsciiDoc

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_

CHANGELOG.adoc

@@ -0,0 +1,38 @@
+== Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on https://keepachangelog.com/en/1.1.0/[Keep a
+Changelog], and this project adheres to
+https://semver.org/spec/v2.0.0.html[Semantic Versioning].
+
+=== [Unreleased]
+
+==== Changed
+
+* *Renamed EveryType → anytype.* The old name over-claimed a universal
+"`every type`" relation (exactly the System-Fc trap this design
+refuses). The honest claim is the opposite: pick _any_ L2 resource
+algebra, get _that_ discipline.
+* Re-scoped this repository to the *kernel/engine* only. The theory it
+implements was split out into the *systemet* repo (Equality Theory),
+which is now the semantic authority; anytype pins it upstream and
+extends-not-redefines it.
+* Rewrote `+README.adoc+` and `+EXPLAINME.adoc+` for the kernel, with an
+explicit honesty notice that no working checker exists yet (the
+`+src/+`/`+tests/+`/`+verification/+` trees are RSR scaffolding).
+
+==== Added
+
+* Instantiated identity descriptiles (CLADE/ECOSYSTEM/ANCHOR/STATE/META)
+and the AFFIRMATION honesty snapshot with the anytype identity and an
+honest early-stage status; ANCHOR pins systemet upstream.
+
+==== Notes
+
+* `+uuid+` is a PROVISIONAL deterministic UUIDv5 of the forge URL;
+`+clade+` is PROVISIONAL. Both must be confirmed/registered in
+`+gv-clade-index+`.
+* `+CLAUDE.md+` is generated from the descriptiles — run
+`+just claude-md+` to refresh it where `+nickel+`/`+just+` are
+available.

CONTRIBUTING.adoc

@@ -0,0 +1,75 @@
+== Contributing to anytype
+
+Thanks for your interest. This repository follows the Hyperpolymath
+estate standards defined in
+https://github.com/hyperpolymath/standards[hyperpolymath/standards].
+
+=== Licence
+
+This project is licensed under *MPL-2.0*. By contributing you agree that
+your contributions are licensed under the same terms. Every source file
+carries an `+SPDX-License-Identifier+` header; keep it when editing, and
+add one to any new file.
+
+=== Development environment
+
+A pinned dev shell is provided:
+
+[source,sh]
+----
+guix develop        # toolchain: just
+----
+
+Estate policy is Guix primary / Guix fallback; this repo currently ships
+the Guix fallback. A `+guix.scm+` is welcome if you prefer the primary
+tier.
+
+=== Build and test
+
+This repo uses https://just.systems[`+just+`] (the estate uses
+Justfiles, never Makefiles). Recipes available here:
+
+[source,sh]
+----
+just            # list recipes
+just fmt        # format
+just fmt-check  # check formatting
+just lint       # lint
+just test-all   # run the full suite
+just doctor     # environment diagnostics
+----
+
+=== Machine-readable artefacts
+
+This repo carries `+.machine_readable/+` A2ML files (`+STATE.a2ml+`,
+`+META.a2ml+`, `+ECOSYSTEM.a2ml+`, `+AGENTIC.a2ml+`, `+NEUROSYM.a2ml+`,
+`+PLAYBOOK.a2ml+`). If your change alters project state, architecture,
+or operational steps, update the corresponding file in the same PR — CI
+validates them.
+
+=== Language policy
+
+The estate restricts which languages may be used. In particular Python,
+Go, TypeScript, AffineScript, V-lang, Java/Kotlin, Swift and Makefiles
+are *not* accepted in new code; AffineScript, Rust/SPARK, Zig, Deno,
+Gleam, Elixir, Haskell, Idris2, Agda, Julia and OCaml are. CI enforces
+this, so check the policy in `+hyperpolymath/standards+` before
+introducing a new language.
+
+=== Documentation format
+
+Docs are AsciiDoc (`+.adoc+`) by default, including `+README.adoc+`. The
+GitHub-required community-health files stay Markdown: `+SECURITY.md+`,
+`+CONTRIBUTING.md+`, `+CODE_OF_CONDUCT.md+`, `+CHANGELOG.md+`. Do not
+add a `+.md+` duplicate of a doc that already exists as `+.adoc+`.
+
+=== Pull requests
+
+[arabic]
+. Branch from `+main+` — do not push to `+main+` directly; branch
+protection requires review and passing checks.
+. Keep the change focused, and explain _why_ in the PR body.
+. Make sure governance CI is green. It checks documentation presence,
+packaging policy, secrets, licence consistency and workflow security.
+. Security issues: follow `+SECURITY.md+` — report privately, never in a
+public issue.