docs(a2ml): mark the "TOML-like key-value" characterisation superseded by DEED

.machine_readable/REGISTRY.a2ml

@@ -63,7 +63,7 @@ name = "META.a2ml spec"
 stream = "foundation"
 home = "meta-a2ml/"
 canonical_doc = "meta-a2ml/README.adoc"
-source_hash = "sha256:bcea50c47c391c6ade37696e34ce31145dfcab3fc8960a362d1d15bcf324306a"
+source_hash = "sha256:1c5337a9782e37cf24d869109d798d0bf82c67fe62c24f94314b235ea8f173b4"
 route = "architecture decisions / governance metadata format"
 
 [[spec]]
@@ -72,7 +72,7 @@ name = "STATE.a2ml spec"
 stream = "foundation"
 home = "state-a2ml/"
 canonical_doc = "state-a2ml/README.adoc"
-source_hash = "sha256:8ec140f16e80e96a53c8365df6c06fea50bf2625f84e4ddaa306e5d10721af18"
+source_hash = "sha256:a67908e04098d40d957fe067042410bf195ef48dd2d18e7426b66b3ed1a01f33"
 route = "project-state metadata format (drives this registry's topology)"
 
 [[spec]]
@@ -81,7 +81,7 @@ name = "ECOSYSTEM.a2ml spec"
 stream = "foundation"
 home = "ecosystem-a2ml/"
 canonical_doc = "ecosystem-a2ml/README.adoc"
-source_hash = "sha256:7fbd11721e97bd85f8200db8a75267be4d7347f82ad0226e9b1296c92d47f9f2"
+source_hash = "sha256:fd8d8eae614d7a6c89dee84a874e4a5ba6f94db4b5e3f675154252632b01788d"
 route = "ecosystem-positioning metadata format"
 
 [[spec]]
@@ -108,7 +108,7 @@ name = "PLAYBOOK.a2ml spec"
 stream = "foundation"
 home = "playbook-a2ml/"
 canonical_doc = "playbook-a2ml/README.adoc"
-source_hash = "sha256:fa6ca3574c64d2c03851fee9a0b5ab28b16eb81ce605690f95571640a577b218"
+source_hash = "sha256:ae559e69331afa37ddf14d71d92bddb41613964765420a2fe930234c13e71074"
 route = "executable operational runbooks"
 
 [[spec]]
@@ -279,7 +279,7 @@ name = "A2ML Templates"
 stream = "integration"
 home = "a2ml-templates/"
 canonical_doc = "a2ml-templates/STATE.a2ml.v2.spec.adoc"
-source_hash = "sha256:ff30b8e1e7c5d4dcf12d17789e40064b632c92bca3d8c2f891f109dc9157dc4a"
+source_hash = "sha256:16fc9e6b38b1bf06a3fdc1069127af42985562381f3ef126d0dcd0370f774783"
 route = "copy-in templates for the 7 A2ML files"
 
 [[spec]]

a2ml-templates/STATE.a2ml.template

@@ -5,6 +5,12 @@
 # This file tracks the current state of the project using A2ML key-value format.
 # It is machine-readable and used by RSR tooling for validation.
 #
+# SUPERSEDED SURFACE: the key-value surface below is v1. The normative grammar
+# for this family is now DEED -- see deed/spec/DEED-GRAMMAR-SPEC.adoc in
+# hyperpolymath/standards. DEED is an s-expression format: it has no
+# "key = value" production. This template is retained until the conversion
+# campaign regenerates it; do not treat its surface as the specification.
+#
 # HUMAN SUMMARY: This is your project's "status dashboard". It tells anyone
 # (human or AI) where the project is right now — what phase it's in, what's
 # been built, and what's next. Update it as work progresses.

ecosystem-a2ml/README.adoc

@@ -12,6 +12,22 @@ image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,
 :icons: font
 :source-highlighter: rouge
 
+[WARNING]
+====
+*Superseded characterisation.* The normative grammar for this format family is
+the DEED grammar specification -- `deed/spec/DEED-GRAMMAR-SPEC.adoc` in this
+repository. DEED is an *s-expression* format: there is no `key = value`
+production and no `[section]` production; the only bracket is `(`.
+
+The "TOML-like key-value" wording below is v1 text, and it is the measured cause
+of a format speciation: among the 5,424 TOML-shaped legacy `.a2ml` files the
+descriptile family had reached *0.2%* conformance to the actual grammar -- 10
+correct.
+
+The body is left unaltered as the record of what was published. Do not implement
+from it.
+====
+
 == Overview
 
 == Handover (2026-01-18)

meta-a2ml/README.adoc

@@ -8,6 +8,22 @@ image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,
 :toclevels: 2
 :icons: font
 
+[WARNING]
+====
+*Superseded characterisation.* The normative grammar for this format family is
+the DEED grammar specification -- `deed/spec/DEED-GRAMMAR-SPEC.adoc` in this
+repository. DEED is an *s-expression* format: there is no `key = value`
+production and no `[section]` production; the only bracket is `(`.
+
+The "TOML-like key-value" wording below is v1 text, and it is the measured cause
+of a format speciation: among the 5,424 TOML-shaped legacy `.a2ml` files the
+descriptile family had reached *0.2%* conformance to the actual grammar -- 10
+correct.
+
+The body is left unaltered as the record of what was published. Do not implement
+from it.
+====
+
 Machine-readable Engineering and Technical Architecture files.
 
 Part of the **A2ML Format Family** -- A2ML (Annotated Markup Language) TOML-like key-value

playbook-a2ml/README.adoc

@@ -9,6 +9,23 @@ image:https://img.shields.io/badge/A2ML_Family-execution-green.svg[A2ML Family]
 :toclevels: 2
 :icons: font
 
+[WARNING]
+====
+*Superseded characterisation.* The normative grammar for this format family is
+the DEED grammar specification -- `deed/spec/DEED-GRAMMAR-SPEC.adoc` in this
+repository. DEED is an *s-expression* format: there is no `key = value`
+production and no `[section]` production; DEED uses matching opening and
+closing parentheses.
+
+The "TOML-like key-value" wording below is v1 text, and it is the measured cause
+of a format speciation: across all 35,884 legacy `.a2ml` files the descriptile
+family had reached *0.2%* conformance to the actual grammar -- 10 correct
+against 5,424 TOML-shaped.
+
+The body is left unaltered as the record of what was published. Do not implement
+from it.
+====
+
 Machine-readable executable plans and operational runbooks.
 
 Part of the **A2ML Format Family** -- A2ML (Annotated Markup Language) TOML-like key-value
@@ -252,4 +269,3 @@ If PLAYBOOK execution fails:
 == License
 
 MPL-2.0.
-

state-a2ml/README.adoc

@@ -5,6 +5,23 @@ image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,
 :toclevels: 3
 :source-highlighter: highlight.js
 
+[WARNING]
+====
+*Superseded characterisation.* The normative grammar for this format family is
+the DEED grammar specification -- `deed/spec/DEED-GRAMMAR-SPEC.adoc` in this
+repository. DEED is an *s-expression* format: there is no `key = value`
+production and no `[section]` production; DEED uses matching opening and
+closing parentheses.
+
+The "TOML-like key-value" wording below is v1 text, and it is the measured cause
+of a format speciation: across all 35,884 legacy `.a2ml` files the descriptile
+family had reached *0.2%* conformance to the actual grammar -- 10 correct
+against 5,424 TOML-shaped.
+
+The body is left unaltered as the record of what was published. Do not implement
+from it.
+====
+
 *Stateful Context Tracking Engine for AI Conversation Continuity*
 
 == Overview

state-a2ml/spec/STATE-FORMAT-SPEC.adoc

@@ -6,6 +6,23 @@
 :source-highlighter: highlight.js
 :icons: font
 
+[WARNING]
+====
+*Superseded characterisation.* The normative grammar for this format family is
+the DEED grammar specification -- `deed/spec/DEED-GRAMMAR-SPEC.adoc` in this
+repository. DEED is an *s-expression* format: there is no `key = value`
+production and no `[section]` production; DEED uses matching opening and
+closing parentheses.
+
+The "TOML-like key-value" wording below is v1 text, and it is the measured cause
+of a format speciation: across all 35,884 legacy `.a2ml` files the descriptile
+family had reached *0.2%* conformance to the actual grammar -- 10 correct
+against 5,424 TOML-shaped.
+
+The body is left unaltered as the record of what was published. Do not implement
+from it.
+====
+
 [.text-center]
 *Internet-Draft Style Specification* +
 *Version 1.0.0-draft.1* +