fix(docs): GitHub README precedence; descriptiles not 6a2

.clinerules

@@ -2,7 +2,7 @@
 # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 # Authoritative source: docs/AI-CONVENTIONS.md
 
-# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed.
+# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed.
 
 # LICENSE
 # All original code: MPL-2.0.

.github/DIRECTORY.adoc

@@ -1,3 +1,10 @@
 // SPDX-License-Identifier: CC-BY-SA-4.0
 // Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
-= .github Pillar
+= .github
+
+Workflows, community-health files, CODEOWNERS.
+
+**No `README.adoc` in this directory on purpose.** GitHub's repository
+front page prefers a README in `.github/` over the repository root
+(then `docs/`). A layer README here stole the homepage from
+`/README.adoc`. Layer notes live in this `DIRECTORY.adoc` instead.

.github/GOVERNANCE.md

@@ -46,7 +46,7 @@ release schedules, contributor access, and community standards.
 - ADR statuses: `proposed`, `accepted`, `deprecated`, `superseded`, `rejected`.
 - ADRs provide a historical record of why decisions were made and what alternatives
   were considered.
-- See `.machine_readable/6a2/META.deed` for the machine-readable ADR index.
+- See `.machine_readable/descriptiles/META.deed` for the machine-readable ADR index.
 
 ---
 

.github/pull_request_template.md

@@ -29,9 +29,9 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 
 ### As Applicable
 
-- [ ] `.machine_readable/6a2/STATE.deed` updated (if project state changed)
-- [ ] `.machine_readable/6a2/ECOSYSTEM.deed` updated (if integrations changed)
-- [ ] `.machine_readable/6a2/META.deed` updated (if architectural decisions changed)
+- [ ] `.machine_readable/descriptiles/STATE.deed` updated (if project state changed)
+- [ ] `.machine_readable/descriptiles/ECOSYSTEM.deed` updated (if integrations changed)
+- [ ] `.machine_readable/descriptiles/META.deed` updated (if architectural decisions changed)
 - [ ] Documentation updated for user-facing changes
 - [ ] `TOPOLOGY.md` updated (if architecture changed)
 - [ ] `CHANGELOG` or release notes updated

.github/workflows/openssf-compliance.yml

@@ -69,11 +69,11 @@ jobs:
             exit 1
           fi
 
-          if [ ! -f ".machine_readable/6a2/STATE.deed" ]; then
-            echo "::error::.machine_readable/6a2/STATE.deed is required"
+          if [ ! -f ".machine_readable/descriptiles/STATE.deed" ]; then
+            echo "::error::.machine_readable/descriptiles/STATE.deed is required"
             exit 1
           fi
-          echo ".machine_readable/6a2/STATE.deed: OK"
+          echo ".machine_readable/descriptiles/STATE.deed: OK"
       - name: Check CHANGELOG exists
         run: |
           if [ ! -f "CHANGELOG.md" ] && [ ! -f "CHANGELOG.adoc" ] && [ ! -f "CHANGES.md" ]; then
@@ -89,8 +89,8 @@ jobs:
           # Collect all required files that exist
           for f in SECURITY.md SECURITY.adoc .github/SECURITY.md LICENSE LICENSE.txt \
                    CONTRIBUTING.md CONTRIBUTING.adoc README.md README.adoc \
-                   .machine_readable/6a2/STATE.deed .machine_readable/6a2/META.deed \
-                   .machine_readable/6a2/ECOSYSTEM.deed CHANGELOG.md CHANGELOG.adoc; do
+                   .machine_readable/descriptiles/STATE.deed .machine_readable/descriptiles/META.deed \
+                   .machine_readable/descriptiles/ECOSYSTEM.deed CHANGELOG.md CHANGELOG.adoc; do
             [ -f "$f" ] && REQUIRED_FILES="$REQUIRED_FILES $f"
           done
 

.machine_readable/0.1-AI-MANIFEST.deed

@@ -12,14 +12,14 @@ description: |
   automation scripts.
 
 canonical_locations:
-  state: "6a2/STATE.deed"
-  meta: "6a2/META.deed"
-  ecosystem: "6a2/ECOSYSTEM.deed"
-  agentic: "6a2/AGENTIC.deed"
-  neurosym: "6a2/NEUROSYM.deed"
-  playbook: "6a2/PLAYBOOK.deed"
-  clade: "6a2/CLADE.deed"
-  anchors: "6a2/anchors/"
+  state: "descriptiles/STATE.deed"
+  meta: "descriptiles/META.deed"
+  ecosystem: "descriptiles/ECOSYSTEM.deed"
+  agentic: "descriptiles/AGENTIC.deed"
+  neurosym: "descriptiles/NEUROSYM.deed"
+  playbook: "descriptiles/PLAYBOOK.deed"
+  clade: "descriptiles/CLADE.deed"
+  anchors: "descriptiles/anchors/"
   policies: "policies/"
   ai_configs: "ai/"
   compliance: "compliance/"

.machine_readable/ai/.clinerules

@@ -2,7 +2,7 @@
 # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 # Authoritative source: docs/AI-CONVENTIONS.md
 
-# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed.
+# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed.
 
 # LICENSE
 # All original code: MPL-2.0.

.machine_readable/ai/.windsurfrules

@@ -2,7 +2,7 @@
 # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 # Authoritative source: docs/AI-CONVENTIONS.md
 
-# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed.
+# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed.
 
 # LICENSE
 # All original code: MPL-2.0.

.machine_readable/ai/AI.deed

@@ -7,8 +7,8 @@
 - Prefer to keep generated files out of source control, and regenerate them with the documented commands before committing.
 
 ## Workflow
-1. Inspect `.machine_readable/6a2/STATE.deed` for blockers and next actions.
-2. Respect any constraints listed inside `.machine_readable/6a2/AGENTIC.deed` when tooling changes are requested.
+1. Inspect `.machine_readable/descriptiles/STATE.deed` for blockers and next actions.
+2. Respect any constraints listed inside `.machine_readable/descriptiles/AGENTIC.deed` when tooling changes are requested.
 3. After finishing edits, update STATE with your outcomes and commit with a concise, imperative message.
 
 ## Delivery Promises

.machine_readable/ai/README.adoc

@@ -16,9 +16,9 @@ Avoid scattering agent instruction files around the repo root.
 
 Recommended machine read order:
 
-* `.machine_readable/6a2/anchors/ANCHOR.deed`
+* `.machine_readable/descriptiles/anchors/ANCHOR.deed`
 * `.machine_readable/policies/MAINTENANCE-AXES.deed`
 * `.machine_readable/policies/MAINTENANCE-CHECKLIST.deed`
 * `.machine_readable/policies/SOFTWARE-DEVELOPMENT-APPROACH.deed`
-* `.machine_readable/6a2/STATE.deed`
-* `.machine_readable/6a2/META.deed`
+* `.machine_readable/descriptiles/STATE.deed`
+* `.machine_readable/descriptiles/META.deed`

.machine_readable/contractiles/Intentfile.deed

@@ -31,7 +31,7 @@ Panoply is an envelope-first language discipline: every safety claim
 explicit, scoped, inspectable, and mechanically accountable. It is defined
 by three artefacts — a checked Core, explicit evidence, and a
 safety-envelope manifest (see docs/architecture/DESIGN-DISCIPLINE.adoc and
-.machine_readable/6a2/STATE.deed for current status).
+.machine_readable/descriptiles/STATE.deed for current status).
 
 This repository follows the Rhodium Standard Repository governance model
 (contractile files, machine-readable specifications, session bindings)
@@ -44,7 +44,7 @@ This repository is NOT:
   FROM rsr-template-repo; see hyperpolymath/rsr-template-repo for the
   master scaffold
 - Feature-complete — Core, Evidence, and Manifest are design-phase only
-  (see .machine_readable/6a2/STATE.deed)
+  (see .machine_readable/descriptiles/STATE.deed)
 - A runtime library or framework by itself — it is a language-discipline
   specification with an Idris2 ABI (abi.ipkg) and a Zig FFI surface
   (src/interface/ffi/)
@@ -62,7 +62,7 @@ If you are unsure whether a change is in scope, ask. Sensitive areas:
 ### core-language-spec
 - description: Specify the Core — abstract syntax, typing/checking judgements, projection target
 - status: declared
-- notes: See .machine_readable/6a2/STATE.deed [route-to-mvp]
+- notes: See .machine_readable/descriptiles/STATE.deed [route-to-mvp]
 
 ### evidence-model-spec
 - description: Specify the evidence model — what counts as a witness for each guarantee class

.machine_readable/contractiles/Justfile

@@ -52,7 +52,7 @@ info:
     @echo "Version: {{version}}"
     @echo "RSR Tier: {{tier}}"
     @echo "Recipes: $(just --summary | wc -w)"
-    @[ -f ".machine_readable/6a2/STATE.deed" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/6a2/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true
+    @[ -f ".machine_readable/descriptiles/STATE.deed" ] && grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/descriptiles/STATE.deed | head -1 | xargs -I{} echo "Phase: {}" || true
 
 # Run Invariant Path overlay tools for this repository
 invariant-path *ARGS:
@@ -549,14 +549,14 @@ import? "build/just/validate.just"
 
 # Update STATE.deed timestamp
 state-touch:
-    @if [ -f ".machine_readable/6a2/STATE.deed" ]; then \
-        sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/6a2/STATE.deed && \
+    @if [ -f ".machine_readable/descriptiles/STATE.deed" ]; then \
+        sed -i 's/last-updated = "[^"]*"/last-updated = "'"$(date +%Y-%m-%d)"'"/' .machine_readable/descriptiles/STATE.deed && \
         echo "STATE.deed timestamp updated"; \
     fi
 
 # Show current phase from STATE.deed
 state-phase:
-    @grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/6a2/STATE.deed 2>/dev/null | head -1 || echo "unknown"
+    @grep -oP 'phase\s*=\s*"\K[^"]+' .machine_readable/descriptiles/STATE.deed 2>/dev/null | head -1 || echo "unknown"
 
 # ═══════════════════════════════════════════════════════════════════════════════
 # GUIX (channels — Nix is deprecated)

.machine_readable/contractiles/Mustfile.deed

@@ -62,13 +62,13 @@ fails.
 - severity: critical
 
 ### six-directory-present
-- description: 6a2 directory exists with required files
-- run: test -d .machine_readable/6a2 && test -f .machine_readable/6a2/META.deed && test -f .machine_readable/6a2/ECOSYSTEM.deed && test -f .machine_readable/6a2/STATE.deed && test -f .machine_readable/6a2/PLAYBOOK.deed && test -f .machine_readable/6a2/AGENTIC.deed && test -f .machine_readable/6a2/NEUROSYM.deed
+- description: descriptiles directory exists with required files
+- run: test -d .machine_readable/descriptiles && test -f .machine_readable/descriptiles/META.deed && test -f .machine_readable/descriptiles/ECOSYSTEM.deed && test -f .machine_readable/descriptiles/STATE.deed && test -f .machine_readable/descriptiles/PLAYBOOK.deed && test -f .machine_readable/descriptiles/AGENTIC.deed && test -f .machine_readable/descriptiles/NEUROSYM.deed
 - 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

.machine_readable/descriptiles/README.adoc

@@ -2,8 +2,20 @@
 // Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 = descriptiles
 
-The RSR template stores STATE/META/ECOSYSTEM here.
-Panoply's live descriptiles are `.machine_readable/6a2/*.deed` (s-expression
-repo-deed form). This directory is a holding pointer so the template path exists.
+Canonical live path for STATE / META / ECOSYSTEM / AGENTIC / NEUROSYM /
+PLAYBOOK / CLADE (s-expression repo-deeds).
 
-See `../6a2/README.adoc`.
+[cols="1,3"]
+|===
+| File | Role
+
+| `STATE.deed` | phase, milestones
+| `META.deed` | ADRs / rationale
+| `ECOSYSTEM.deed` | boundaries
+| `AGENTIC.deed` | agent constraints
+| `NEUROSYM.deed` | composition notes
+| `PLAYBOOK.deed` | runbooks
+| `CLADE.deed` | clade membership
+| `LANGUAGES.deed` | language inventory
+| `anchors/` | authority anchors
+|===

.machine_readable/6a2/STATE.deed → .machine_readable/descriptiles/STATE.deed

@@ -1,7 +1,7 @@
 ;; SPDX-FileCopyrightText: © 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 ;; SPDX-License-Identifier: MPL-2.0
 ;;
-;; Project state as a repo-deed body fragment stored under 6a2 for
+;; Project state as a repo-deed body fragment stored under descriptiles for
 ;; existing Justfile readers. Canonical identity lives in
 ;; ../../panoply_chora.deed. This file is a repo-deed so the ABNF
 ;; applies; do not reintroduce TOML [section] form.

.machine_readable/self-validating/methodology-guard.k9.ncl

@@ -43,7 +43,7 @@ let methodology_guard = {
     state_not_template = {
       description = "STATE.deed must not contain template placeholders",
       severity = "warning",
-      file = ".machine_readable/6a2/STATE.deed",
+      file = ".machine_readable/descriptiles/STATE.deed",
       # NOTE: the PROJECT token below is written as a Nickel concat
       # ("{{" ++ "PROJECT}}") ON PURPOSE. `just init` runs a sed substitution for
       # the brace-PROJECT-brace token over EVERY text file, which would otherwise

.windsurfrules

@@ -2,7 +2,7 @@
 # Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 # Authoritative source: docs/AI-CONVENTIONS.md
 
-# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/6a2/STATE.deed.
+# STARTUP: Read 0-AI-MANIFEST.deed first, then .machine_readable/descriptiles/STATE.deed.
 
 # LICENSE
 # All original code: MPL-2.0.

0-AI-MANIFEST.deed

@@ -5,7 +5,7 @@
 #
 [metadata]
 version = "0.1.0"
-last-updated = "2026-06-21"
+last-updated = "2026-09-20"
 
 [project]
 name = "panoply"
@@ -20,7 +20,7 @@ agents = [
 ]
 
 [startup]
-read-first = ["0-AI-MANIFEST.deed", ".machine_readable/6a2/STATE.deed", "docs/onboarding/SETUP.adoc"]
+read-first = ["0-AI-MANIFEST.deed", ".machine_readable/descriptiles/STATE.deed", "docs/onboarding/SETUP.adoc"]
 estate = "AsciiDoc + .deed; not README.md or .a2ml"
 js-reach = "Bun, Deno, pnpm, npm"
 no-core-checker = true