Skip to content

Commit 1c22352

Browse files
refactor(machine-readable): rename 6a2/ → descriptiles/ (#35)
## What Starts the estate move from the `6a2/` naming to **`descriptiles/`** (parallel to the existing `contractiles/`). casket-ssg is the pilot. - `git mv .machine_readable/6a2/ → .machine_readable/descriptiles/` (history preserved) — the six descriptive A2ML files: STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK. - Updated the four literal `6a2` references: - `contractiles/Mustfile.a2ml` — `descriptiles-present` + `anchors` checks now point at `descriptiles/` - `GOVERNANCE.adoc` — Machine-Readable convention row - `descriptiles/PLAYBOOK.a2ml` — layout comment - `.claude/CLAUDE.md` — artefacts list now points at `descriptiles/*.a2ml` (A2ML), replacing the stale `.scm` list `a2ml` remains the target format; **Guix/environment config is untouched** per the standing carve-out. ## Not in this PR (flagged follow-ons) - **Estate-canonical definition still says `6a2/`** — `standards` (`meta-a2ml/.claude/CLAUDE.md`, `QUICKSTART-DEV.adoc`, `ai-instruction/*`, `0-AI-MANIFEST.a2ml`) and estate tooling (`hypatia`, `gitbot-fleet`, `coordination.k9`) read `6a2/`. casket is intentionally piloting ahead; the canonical flip + tooling update should follow. - **The Gnosis loader (`src/Gnosis/SixSCM.hs`) still reads `.machine_readable/STATE.scm`** (the old flat `.scm` layout) — it does not yet read `descriptiles/*.a2ml`. Wiring it (needs an A2ML reader) is the next slice that makes the self-rendering demo actually work. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01WN6nPWWe4dvXfoqBG6auWN --- _Generated by [Claude Code](https://claude.ai/code/session_01WN6nPWWe4dvXfoqBG6auWN)_ Co-authored-by: Claude <noreply@anthropic.com>
1 parent f651c10 commit 1c22352

9 files changed

Lines changed: 16 additions & 15 deletions

File tree

.claude/CLAUDE.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,15 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
44
-->
55
## Machine-Readable Artefacts
66

7-
The following files in `.machine_readable/` contain structured project metadata:
8-
9-
- `STATE.scm` - Current project state and progress
10-
- `META.scm` - Architecture decisions and development practices
11-
- `ECOSYSTEM.scm` - Position in the ecosystem and related projects
12-
- `AGENTIC.scm` - AI agent interaction patterns
13-
- `NEUROSYM.scm` - Neurosymbolic integration config
14-
- `PLAYBOOK.scm` - Operational runbook
7+
The following files in `.machine_readable/descriptiles/` contain structured
8+
project metadata (A2ML — TOML-like format; formerly the `6a2/` set of `.scm` files):
9+
10+
- `STATE.a2ml` - Current project state and progress
11+
- `META.a2ml` - Architecture decisions and development practices
12+
- `ECOSYSTEM.a2ml` - Position in the ecosystem and related projects
13+
- `AGENTIC.a2ml` - AI agent interaction patterns
14+
- `NEUROSYM.a2ml` - Neurosymbolic integration config
15+
- `PLAYBOOK.a2ml` - Operational runbook
1516

1617
---
1718

.machine_readable/contractiles/Mustfile.a2ml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -61,14 +61,14 @@ hooks fail if any check fails.
6161
- run: test -f .machine_readable/contractiles/bust/Bustfile.a2ml && test -f .machine_readable/contractiles/dust/Dustfile.a2ml
6262
- severity: critical
6363

64-
### six-directory-present
65-
- description: 6a2 directory exists with required files
66-
- 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
64+
### descriptiles-present
65+
- description: descriptiles directory exists with the six required A2ML files
66+
- 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
6767
- severity: critical
6868

6969
### anchors-directory
70-
- description: anchors directory exists in 6a2
71-
- run: test -d .machine_readable/6a2/anchors
70+
- description: anchors directory exists in descriptiles
71+
- run: test -d .machine_readable/descriptiles/anchors
7272
- severity: warning
7373

7474
### self-validating-structure
File renamed without changes.
File renamed without changes.
File renamed without changes.

.machine_readable/6a2/PLAYBOOK.a2ml renamed to .machine_readable/descriptiles/PLAYBOOK.a2ml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ enforcement-workflow = ".github/workflows/estate-rules.yml"
6161

6262
# === Required directories ===
6363
# .github/ CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, workflows/
64-
# .machine_readable/ AI manifests (0.1-AI-MANIFEST.a2ml), 6a2/ checkpoints,
64+
# .machine_readable/ AI manifests (0.1-AI-MANIFEST.a2ml), descriptiles/ checkpoints,
6565
# contractiles/, configs/, anchors/, policies/, scripts/, svc/
6666
# build/ contractile.just, flake.nix, guix.scm, Containerfile,
6767
# just/*.just (Justfile section imports)

GOVERNANCE.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,7 +128,7 @@ This repository adheres to hyperpolymath estate-wide policies:
128128

129129
| **Contractiles** | Mustfile, Trustfile, Intendfile, Adjustfile in root
130130

131-
| **Machine Readable** | META.a2ml in .machine_readable/6a2/
131+
| **Machine Readable** | META.a2ml in .machine_readable/descriptiles/
132132

133133
| **CI/CD** | GitHub Actions workflows in .github/workflows/
134134

0 commit comments

Comments
 (0)