From 3ae22b2078ba56ed94bc5879b5c651f4735c7ffe Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 23 Jun 2026 15:09:25 +0000 Subject: [PATCH] refactor(machine-readable): rename 6a2/ to descriptiles/ Move the six descriptive A2ML metadata files from .machine_readable/6a2/ to .machine_readable/descriptiles/ (parallel to contractiles/), preserving history via git mv. Update literal references in contractiles/Mustfile.a2ml (descriptiles-present + anchors checks), GOVERNANCE.adoc, descriptiles/PLAYBOOK.a2ml, and .claude/CLAUDE.md (artefacts list now points at descriptiles/*.a2ml). a2ml remains the target format; guix/environment config untouched. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01WN6nPWWe4dvXfoqBG6auWN --- .claude/CLAUDE.md | 17 +++++++++-------- .machine_readable/contractiles/Mustfile.a2ml | 10 +++++----- .../{6a2 => descriptiles}/AGENTIC.a2ml | 0 .../{6a2 => descriptiles}/ECOSYSTEM.a2ml | 0 .../{6a2 => descriptiles}/META.a2ml | 0 .../{6a2 => descriptiles}/NEUROSYM.a2ml | 0 .../{6a2 => descriptiles}/PLAYBOOK.a2ml | 2 +- .../{6a2 => descriptiles}/STATE.a2ml | 0 GOVERNANCE.adoc | 2 +- 9 files changed, 16 insertions(+), 15 deletions(-) rename .machine_readable/{6a2 => descriptiles}/AGENTIC.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/ECOSYSTEM.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/META.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/NEUROSYM.a2ml (100%) rename .machine_readable/{6a2 => descriptiles}/PLAYBOOK.a2ml (98%) rename .machine_readable/{6a2 => descriptiles}/STATE.a2ml (100%) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index d554047..d2a284f 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -4,14 +4,15 @@ Copyright (c) Jonathan D.A. Jewell --> ## Machine-Readable Artefacts -The following files in `.machine_readable/` contain structured project metadata: - -- `STATE.scm` - Current project state and progress -- `META.scm` - Architecture decisions and development practices -- `ECOSYSTEM.scm` - Position in the ecosystem and related projects -- `AGENTIC.scm` - AI agent interaction patterns -- `NEUROSYM.scm` - Neurosymbolic integration config -- `PLAYBOOK.scm` - Operational runbook +The following files in `.machine_readable/descriptiles/` contain structured +project metadata (A2ML — TOML-like format; formerly the `6a2/` set of `.scm` files): + +- `STATE.a2ml` - Current project state and progress +- `META.a2ml` - Architecture decisions and development practices +- `ECOSYSTEM.a2ml` - Position in the ecosystem and related projects +- `AGENTIC.a2ml` - AI agent interaction patterns +- `NEUROSYM.a2ml` - Neurosymbolic integration config +- `PLAYBOOK.a2ml` - Operational runbook --- diff --git a/.machine_readable/contractiles/Mustfile.a2ml b/.machine_readable/contractiles/Mustfile.a2ml index 55f8ab4..2065be9 100644 --- a/.machine_readable/contractiles/Mustfile.a2ml +++ b/.machine_readable/contractiles/Mustfile.a2ml @@ -61,14 +61,14 @@ hooks fail if any check fails. - run: test -f .machine_readable/contractiles/bust/Bustfile.a2ml && test -f .machine_readable/contractiles/dust/Dustfile.a2ml - severity: critical -### six-directory-present -- description: 6a2 directory exists with required files -- run: test -d .machine_readable/6a2 && test -f .machine_readable/6a2/META.a2ml && test -f .machine_readable/6a2/ECOSYSTEM.a2ml && test -f .machine_readable/6a2/STATE.a2ml && test -f .machine_readable/6a2/PLAYBOOK.a2ml && test -f .machine_readable/6a2/AGENTIC.a2ml && test -f .machine_readable/6a2/NEUROSYM.a2ml +### descriptiles-present +- description: descriptiles directory exists with the six required A2ML files +- run: test -d .machine_readable/descriptiles && test -f .machine_readable/descriptiles/META.a2ml && test -f .machine_readable/descriptiles/ECOSYSTEM.a2ml && test -f .machine_readable/descriptiles/STATE.a2ml && test -f .machine_readable/descriptiles/PLAYBOOK.a2ml && test -f .machine_readable/descriptiles/AGENTIC.a2ml && test -f .machine_readable/descriptiles/NEUROSYM.a2ml - severity: critical ### anchors-directory -- description: anchors directory exists in 6a2 -- run: test -d .machine_readable/6a2/anchors +- description: anchors directory exists in descriptiles +- run: test -d .machine_readable/descriptiles/anchors - severity: warning ### self-validating-structure diff --git a/.machine_readable/6a2/AGENTIC.a2ml b/.machine_readable/descriptiles/AGENTIC.a2ml similarity index 100% rename from .machine_readable/6a2/AGENTIC.a2ml rename to .machine_readable/descriptiles/AGENTIC.a2ml diff --git a/.machine_readable/6a2/ECOSYSTEM.a2ml b/.machine_readable/descriptiles/ECOSYSTEM.a2ml similarity index 100% rename from .machine_readable/6a2/ECOSYSTEM.a2ml rename to .machine_readable/descriptiles/ECOSYSTEM.a2ml diff --git a/.machine_readable/6a2/META.a2ml b/.machine_readable/descriptiles/META.a2ml similarity index 100% rename from .machine_readable/6a2/META.a2ml rename to .machine_readable/descriptiles/META.a2ml diff --git a/.machine_readable/6a2/NEUROSYM.a2ml b/.machine_readable/descriptiles/NEUROSYM.a2ml similarity index 100% rename from .machine_readable/6a2/NEUROSYM.a2ml rename to .machine_readable/descriptiles/NEUROSYM.a2ml diff --git a/.machine_readable/6a2/PLAYBOOK.a2ml b/.machine_readable/descriptiles/PLAYBOOK.a2ml similarity index 98% rename from .machine_readable/6a2/PLAYBOOK.a2ml rename to .machine_readable/descriptiles/PLAYBOOK.a2ml index 676ec4c..4c8c931 100644 --- a/.machine_readable/6a2/PLAYBOOK.a2ml +++ b/.machine_readable/descriptiles/PLAYBOOK.a2ml @@ -61,7 +61,7 @@ enforcement-workflow = ".github/workflows/estate-rules.yml" # === Required directories === # .github/ CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, workflows/ -# .machine_readable/ AI manifests (0.1-AI-MANIFEST.a2ml), 6a2/ checkpoints, +# .machine_readable/ AI manifests (0.1-AI-MANIFEST.a2ml), descriptiles/ checkpoints, # contractiles/, configs/, anchors/, policies/, scripts/, svc/ # build/ contractile.just, flake.nix, guix.scm, Containerfile, # just/*.just (Justfile section imports) diff --git a/.machine_readable/6a2/STATE.a2ml b/.machine_readable/descriptiles/STATE.a2ml similarity index 100% rename from .machine_readable/6a2/STATE.a2ml rename to .machine_readable/descriptiles/STATE.a2ml diff --git a/GOVERNANCE.adoc b/GOVERNANCE.adoc index 8bbf167..9cb1b9c 100644 --- a/GOVERNANCE.adoc +++ b/GOVERNANCE.adoc @@ -128,7 +128,7 @@ This repository adheres to hyperpolymath estate-wide policies: | **Contractiles** | Mustfile, Trustfile, Intendfile, Adjustfile in root -| **Machine Readable** | META.a2ml in .machine_readable/6a2/ +| **Machine Readable** | META.a2ml in .machine_readable/descriptiles/ | **CI/CD** | GitHub Actions workflows in .github/workflows/