Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hyperpolymath wants to merge 5 commits into
base: main
Choose a base branch
from
Open

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
83a7923
docs(a2ml): mark the "TOML-like key-value" characterisation supersede…
hyperpolymath Sep 8, 2026
cf0af73
chore(registry): regenerate REGISTRY.a2ml for the four edited satelli…
hyperpolymath Sep 9, 2026
db5c90a
Merge branch 'main' into docs/deed-supersedes-toml-claim
hyperpolymath Sep 9, 2026
9766128
Clarify DEED syntax and legacy A2ML conformance statistics
coderabbitai[bot] Sep 9, 2026
704d27e
Merge branch 'main' into docs/deed-supersedes-toml-claim
hyperpolymath Sep 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions .machine_readable/REGISTRY.a2ml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:4860fda70c0f1596d79fdec9292cf117c6434e9b2959030c6c4e142d9c28b5b0"
route = "architecture decisions / governance metadata format"

[[spec]]
Expand All @@ -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:266223c162d56092c2344a39c64c19af1770db12924157e1fe879c05c4af447f"
route = "project-state metadata format (drives this registry's topology)"

[[spec]]
Expand All @@ -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:cd4a8c7229a3eef8008eda3c5b45f5a4cc39eec0868fe47e4f8b6f786a4aa509"
route = "ecosystem-positioning metadata format"

[[spec]]
Expand All @@ -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:2857777ff8b27bae380ef345117c260d8805aae03331a04170b169d79ff09f4a"
route = "executable operational runbooks"

[[spec]]
Expand Down Expand Up @@ -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]]
Expand Down
6 changes: 6 additions & 0 deletions a2ml-templates/STATE.a2ml.template
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
16 changes: 16 additions & 0 deletions ecosystem-a2ml/README.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
16 changes: 16 additions & 0 deletions meta-a2ml/README.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
18 changes: 17 additions & 1 deletion playbook-a2ml/README.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -252,4 +269,3 @@ If PLAYBOOK execution fails:
== License

MPL-2.0.

17 changes: 17 additions & 0 deletions state-a2ml/README.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
17 changes: 17 additions & 0 deletions state-a2ml/spec/STATE-FORMAT-SPEC.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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* +
Expand Down
Loading