|
| 1 | +// SPDX-License-Identifier: CC-BY-SA-4.0 |
| 2 | +// SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> |
| 3 | += Canonical Names — Anti-Normalisation Register |
| 4 | +Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> |
| 5 | +:toc: macro |
| 6 | +:icons: font |
| 7 | + |
| 8 | +Names in this estate are deliberately non-standard. Language models and |
| 9 | +metadata bots tend to *normalise* them — silently rewriting a coined name to |
| 10 | +the statistically commoner expansion its letters happen to suggest. That is a |
| 11 | +defect, not a correction. |
| 12 | + |
| 13 | +The rule is the estate rule: **flag, don't fix.** If a name on this page looks |
| 14 | +"wrong" to you, it is not wrong — it is *ours*. Do not expand, rename, |
| 15 | +translate, or "correct" it to another form. If you believe a genuine error |
| 16 | +exists, raise it with the owner; never silently rewrite it. This is the same |
| 17 | +anti-normalisation principle the `MUST.contractile` files apply to licences, |
| 18 | +applied here to names. |
| 19 | + |
| 20 | +toc::[] |
| 21 | + |
| 22 | +== Directive for agents (paste this block into system / custom instructions) |
| 23 | + |
| 24 | +Put this in the *system* or *custom-instruction* slot of any assistant — not a |
| 25 | +chat message, which decays out of context and lets the prior reassert itself. |
| 26 | + |
| 27 | +---- |
| 28 | +CANONICAL NAMES — DO NOT NORMALISE. |
| 29 | +These names are FIXED. Do not expand, rename, or "correct" them to any other |
| 30 | +form, even when their letters suggest a more common expansion. Use ONLY the |
| 31 | +canonical form. Treat any expansion as a fact to verify against this list, not |
| 32 | +one to generate. If unsure, ask — never guess an expansion. |
| 33 | +
|
| 34 | +- "A2ML" = "Attested Markup Language". NOT "AI to Machine Language" / "AI-to-Machine Language". |
| 35 | +- "BoJ" = "Bundle of Joy". NOT "Bureau of Justice", NOT "Bank of Japan". |
| 36 | +
|
| 37 | +DEPRECATED NAMES — DO NOT REINTRODUCE (estate mandate 2026-06-30): |
| 38 | +- "descriptiles" is the machine-readable metadata family (dir |
| 39 | + `.machine_readable/descriptiles/`). The old name "6a2" is DEPRECATED — never |
| 40 | + write "6a2", migrate it to "descriptiles" on sight. |
| 41 | +- "contractiles" is the normative verb family (Must/Trust/Adjust/Dust/Bust/Intend). |
| 42 | +- "bot_directives" replaces the old "agent_instructions". |
| 43 | +---- |
| 44 | + |
| 45 | +== Register |
| 46 | + |
| 47 | +[cols="1,2,2,3",options="header"] |
| 48 | +|=== |
| 49 | +| Name | Canonical expansion | Reject these (wrong) | What it is |
| 50 | + |
| 51 | +| **A2ML** |
| 52 | +| Attested Markup Language |
| 53 | +| "AI to Machine Language", "AI-to-Machine Language", "A2 Markup Language" |
| 54 | +| The estate's attested markup language. The letters *read* as "A-to-M-L", |
| 55 | + which is exactly why models mis-expand it — override that reflex; the |
| 56 | + expansion is *Attested Markup Language*. |
| 57 | + |
| 58 | +| **BoJ** |
| 59 | +| Bundle of Joy |
| 60 | +| "Bureau of Justice", "Bank of Japan", "Board of Justice" |
| 61 | +| Named for the design goal made concrete: a coherent, joyful whole, not a |
| 62 | + mismatch of broken parts adding to the pain of the agentic experience. It is |
| 63 | + not an institution. |
| 64 | + |
| 65 | +|=== |
| 66 | + |
| 67 | +== Deprecated names — do not reintroduce (MANDATE, 2026-06-30) |
| 68 | + |
| 69 | +Distinct from the mis-expansion register above: these are estate names that |
| 70 | +have been *renamed*. The old form is **deprecated** and must not be |
| 71 | +reintroduced anywhere (paths, prose, tooling, config). This is the owner's |
| 72 | +mandate of 2026-06-30 — the opportunistic upgrade + refinement layered on top |
| 73 | +of the larger reconciliation of the machine-readable substrate. It applies |
| 74 | +estate-wide, `standards` included. |
| 75 | + |
| 76 | +[cols="1,1,3",options="header"] |
| 77 | +|=== |
| 78 | +| Deprecated (do not use) | Canonical (use this) | Notes |
| 79 | + |
| 80 | +| **`6a2`** |
| 81 | +| **`descriptiles`** |
| 82 | +| The descriptive machine-readable metadata family: `STATE`, `META`, |
| 83 | + `ECOSYSTEM`, `AGENTIC`, `NEUROSYM`, `PLAYBOOK`, plus `CLADE` and |
| 84 | + `anchors/ANCHOR`. Canonical directory `.machine_readable/descriptiles/`. |
| 85 | + `rsr-template-repo` leads (rename merged); `standards` still carries `6a2` |
| 86 | + in ~81 files and is being migrated. The `.machine_readable/6a2/` path is a |
| 87 | + 404 on repos that have migrated — repoint links to `descriptiles/`. |
| 88 | + |
| 89 | +| **`agent_instructions`** |
| 90 | +| **`bot_directives`** |
| 91 | +| The per-bot directive set (`coverage`, `debt`, `methodology`). |
| 92 | + |
| 93 | +| _(pair)_ |
| 94 | +| **`contractiles`** |
| 95 | +| The normative verb family (Must/Trust/Adjust/Dust/Bust/Intend). Not a rename |
| 96 | + — named here as the established companion of `descriptiles`, so the |
| 97 | + `descriptiles`/`contractiles` pair is stated together as canonical. |
| 98 | +|=== |
| 99 | + |
| 100 | +== Adding a name |
| 101 | + |
| 102 | +Add a row to the *Register* whenever a name is mis-expanded more than once. |
| 103 | +Populate the *Reject* column with the *exact* wrong forms you have actually |
| 104 | +seen — that specific in-context list is what lets a model suppress the |
| 105 | +mis-expansion. Add a row to *Deprecated names* whenever a name is renamed and |
| 106 | +the old form must not return. Keep the directive block above in sync so it |
| 107 | +stays copy-pasteable. |
| 108 | + |
| 109 | +This file (`standards/CANONICAL-NAMES.adoc`) is the canonical source. Any copy |
| 110 | +elsewhere (e.g. `dev-notes/glossary/CANONICAL-NAMES.adoc`) mirrors it; if they |
| 111 | +disagree, this one wins. |
0 commit comments