Skip to content

Commit e794955

Browse files
refactor(descriptiles): migrate .machine_readable/6a2 → descriptiles (naming canon) (#676)
## What Estate naming mandate (2026-06-30): the machine-readable metadata family is **`descriptiles`**; **`6a2` is fully deprecated** and must never be reintroduced. `rsr-template-repo` already led this rename (PR #128). This brings AffineScript into line. ## Changes (38 files, mechanical + verified) - `git mv .machine_readable/6a2 .machine_readable/descriptiles` (6 `.a2ml` files) - Updated the **one** code dependency: `tools/check-doc-truthing.sh` `STATE_FILE` path - Updated `.machine_readable/TRUST.contractile` deny-rule path - Updated ~30 doc/metadata references (paths + `6a2 metadata` family-name prose) Replacement was **word-boundaried** (`\b6a2\b` → `descriptiles`) so checksum substrings are untouched; `Cargo.lock` hash coincidences (`…846a2afffd…`) were excluded. ## Verification (real toolchain) Built off system OCaml 4.14.1 + opam (dune 3.24.0): - `dune build` = **exit 0** (zero build impact — metadata/doc only) - **zero `\b6a2\b` references remain** anywhere (excl. Cargo.lock checksums) - `check-doc-truthing.sh` reads the renamed `.machine_readable/descriptiles/STATE.a2ml` correctly ## Pre-existing red gates (NOT caused by this PR) README fails two back-link gates **on `main` independently** of this change (README is untouched here — verified against pristine `origin/main`): 1. README → `SOUNDNESS.adoc` (soundness-ledger gate) — fixed by **#675** 2. README → `CAPABILITY-MATRIX.adoc` (doc-truthing gate) — third README defect, being fixed alongside #675 Once those README fixes land, this PR's CI clears. 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 2a3da6c commit e794955

38 files changed

Lines changed: 61 additions & 61 deletions

.claude/CLAUDE.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,12 @@ https://github.com/hyperpolymath/nextgen-languages/blob/main/docs/disambiguation
2929

3030
The following files in `.machine_readable/` contain structured project metadata:
3131

32-
- `.machine_readable/6a2/STATE.a2ml` - Current project state and progress
33-
- `.machine_readable/6a2/META.a2ml` - Architecture decisions and development practices
34-
- `.machine_readable/6a2/ECOSYSTEM.a2ml` - Position in the ecosystem and related projects
35-
- `.machine_readable/6a2/AGENTIC.a2ml` - AI agent interaction patterns
36-
- `.machine_readable/6a2/NEUROSYM.a2ml` - Neurosymbolic integration config
37-
- `.machine_readable/6a2/PLAYBOOK.a2ml` - Operational runbook
32+
- `.machine_readable/descriptiles/STATE.a2ml` - Current project state and progress
33+
- `.machine_readable/descriptiles/META.a2ml` - Architecture decisions and development practices
34+
- `.machine_readable/descriptiles/ECOSYSTEM.a2ml` - Position in the ecosystem and related projects
35+
- `.machine_readable/descriptiles/AGENTIC.a2ml` - AI agent interaction patterns
36+
- `.machine_readable/descriptiles/NEUROSYM.a2ml` - Neurosymbolic integration config
37+
- `.machine_readable/descriptiles/PLAYBOOK.a2ml` - Operational runbook
3838

3939
---
4040

@@ -57,7 +57,7 @@ The following files in `.machine_readable/` contain structured project metadata:
5757
| **Bash/POSIX Shell** | Scripts, automation | Keep minimal |
5858
| **Python** | SaltStack only | No other Python permitted |
5959
| **Nickel** | Configuration language | For complex configs |
60-
| **A2ML** | State/meta files | .machine_readable/6a2/STATE.a2ml, .machine_readable/6a2/META.a2ml, .machine_readable/6a2/ECOSYSTEM.a2ml |
60+
| **A2ML** | State/meta files | .machine_readable/descriptiles/STATE.a2ml, .machine_readable/descriptiles/META.a2ml, .machine_readable/descriptiles/ECOSYSTEM.a2ml |
6161
| **Julia** | Batch scripts, data processing | Per RSR |
6262
| **OCaml** | AffineScript compiler | Language-specific (compiler-host tooling lives here) |
6363
| **Ada** | Safety-critical systems | Where required |

.machine_readable/TRUST.contractile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
(deny "push without confirmation in the same session")
2727
(deny "add a language feature not in ANCHOR.a2ml thesis")
2828
(deny "reverse any ADR (ADR-001 through ADR-010) without a new ADR")
29-
(deny "delete or overwrite the 6a2/ core files (STATE/META/ECOSYSTEM/AGENTIC/NEUROSYM/PLAYBOOK)")
29+
(deny "delete or overwrite the descriptiles/ core files (STATE/META/ECOSYSTEM/AGENTIC/NEUROSYM/PLAYBOOK)")
3030
(deny "modify IDApTIK without explicit instruction (AGPL — separate repo, separate session)")
3131
)
3232

.machine_readable/anchors/ANCHOR.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ thesis:
6161

6262
authorities:
6363
scope-statement:
64-
- ".machine_readable/6a2/META.a2ml (ADRs)"
64+
- ".machine_readable/descriptiles/META.a2ml (ADRs)"
6565
- "~/Desktop/Frontier_Programming_Practices_AffineScript/AI.a2ml (v2.0)"
6666

6767
human-guide:
File renamed without changes.
File renamed without changes.
Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -483,10 +483,10 @@ consequences = """
483483
form across format passes.
484484
"""
485485
references = [
486-
".machine_readable/6a2/STATE.a2ml [track-a-manhattan]",
487-
".machine_readable/6a2/STATE.a2ml [[open-bug]] BUG-001",
488-
".machine_readable/6a2/STATE.a2ml [[open-bug]] BUG-002",
489-
".machine_readable/6a2/META.a2ml [[adr]] ADR-002 (scaled Let rule)",
486+
".machine_readable/descriptiles/STATE.a2ml [track-a-manhattan]",
487+
".machine_readable/descriptiles/STATE.a2ml [[open-bug]] BUG-001",
488+
".machine_readable/descriptiles/STATE.a2ml [[open-bug]] BUG-002",
489+
".machine_readable/descriptiles/META.a2ml [[adr]] ADR-002 (scaled Let rule)",
490490
"lib/ast.ml ExprLet (lines 105-111), StmtLet (lines 170-176)",
491491
"lib/lexer.ml (ZERO/ONE never emitted)",
492492
"lib/parser.mly quantity rule (lines 180-183)",
File renamed without changes.
File renamed without changes.
Lines changed: 3 additions & 3 deletions
Large diffs are not rendered by default.

0-AI-MANIFEST.a2ml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
Project metadata and AI agent configuration files live under `.machine_readable/`. All metadata files use the `.a2ml` extension; the `.scm` extension is reserved for Guix (`guix.scm`, `.guix-channel`).
66

7-
## Core 6a2 metadata (`.machine_readable/6a2/`)
7+
## Core descriptiles metadata (`.machine_readable/descriptiles/`)
88

99
- **STATE.a2ml** - Current project state, progress, blockers, next actions, session notes
1010
- **ECOSYSTEM.a2ml** - Position in ecosystem, relationships to sibling projects
@@ -29,7 +29,7 @@ Project metadata and AI agent configuration files live under `.machine_readable/
2929

3030
## Workflow
3131

32-
1. Read `.machine_readable/6a2/*.a2ml` files at session start
32+
1. Read `.machine_readable/descriptiles/*.a2ml` files at session start
3333
2. Check `STATE.a2ml` for current phase, blockers, next actions
3434
3. Follow patterns and constraints from `AGENTIC.a2ml`
3535
4. Follow methodology gates from `agent_instructions/methodology.a2ml`

0 commit comments

Comments
 (0)