Standardize repo structure (hyperpolymath/mustfile pattern)

- Add .machine_readable/ with 6 SCM files (STATE, META, ECOSYSTEM, AGENTIC, NEUROSYM, PLAYBOOK)
- Add Mustfile and justfile (replacing any Makefiles)
- Update .claude/CLAUDE.md with .machine_readable reference
- Clean up duplicate documentation files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: Jonathan D.A. Jewell

.claude/CLAUDE.md

@@ -1,3 +1,16 @@
+## 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
+
+---
+
 # CLAUDE.md - AI Assistant Instructions
 
 ## Language Policy (Hyperpolymath Standard)
@@ -68,3 +81,4 @@ Both are FOSS with independent governance (no Big Tech).
 - No hardcoded secrets
 - SHA-pinned dependencies
 - SPDX license headers on all files
+

.machine_readable/AGENTIC.scm

@@ -0,0 +1,16 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; AGENTIC.scm - AI agent interaction patterns for poly-ssg
+
+(define agentic-config
+  `((version . "1.0.0")
+    (claude-code
+      ((model . "claude-opus-4-5-20251101")
+       (tools . ("read" "edit" "bash" "grep" "glob"))
+       (permissions . "read-all")))
+    (patterns
+      ((code-review . "thorough")
+       (refactoring . "conservative")
+       (testing . "comprehensive")))
+    (constraints
+      ((languages . ())
+       (banned . ("typescript" "go" "python" "makefile"))))))

.machine_readable/ECOSYSTEM.scm

@@ -0,0 +1,20 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; ECOSYSTEM.scm - Ecosystem position for poly-ssg
+;; Media-Type: application/vnd.ecosystem+scm
+
+(ecosystem
+  (version "1.0")
+  (name "poly-ssg")
+  (type "")
+  (purpose "")
+
+  (position-in-ecosystem
+    (category "")
+    (subcategory "")
+    (unique-value ()))
+
+  (related-projects ())
+
+  (what-this-is ())
+
+  (what-this-is-not ()))

.machine_readable/META.scm

@@ -0,0 +1,17 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; META.scm - Meta-level information for poly-ssg
+;; Media-Type: application/meta+scheme
+
+(meta
+  (architecture-decisions ())
+
+  (development-practices
+    (code-style ())
+    (security
+      (principle "Defense in depth"))
+    (testing ())
+    (versioning "SemVer")
+    (documentation "AsciiDoc")
+    (branching "main for stable"))
+
+  (design-rationale ()))

.machine_readable/NEUROSYM.scm

@@ -0,0 +1,13 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; NEUROSYM.scm - Neurosymbolic integration config for poly-ssg
+
+(define neurosym-config
+  `((version . "1.0.0")
+    (symbolic-layer
+      ((type . "scheme")
+       (reasoning . "deductive")
+       (verification . "formal")))
+    (neural-layer
+      ((embeddings . false)
+       (fine-tuning . false)))
+    (integration . ())))

.machine_readable/PLAYBOOK.scm

@@ -0,0 +1,13 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; PLAYBOOK.scm - Operational runbook for poly-ssg
+
+(define playbook
+  `((version . "1.0.0")
+    (procedures
+      ((deploy . (("build" . "just build")
+                  ("test" . "just test")
+                  ("release" . "just release")))
+       (rollback . ())
+       (debug . ())))
+    (alerts . ())
+    (contacts . ())))

.machine_readable/STATE.scm

@@ -0,0 +1,39 @@
+;; SPDX-License-Identifier: AGPL-3.0-or-later
+;; STATE.scm - Project state for poly-ssg
+;; Media-Type: application/vnd.state+scm
+
+(state
+  (metadata
+    (version "0.0.1")
+    (schema-version "1.0")
+    (created "2026-01-03")
+    (updated "2026-01-03")
+    (project "poly-ssg")
+    (repo "github.com/hyperpolymath/poly-ssg"))
+
+  (project-context
+    (name "poly-ssg")
+    (tagline "")
+    (tech-stack ()))
+
+  (current-position
+    (phase "initial")
+    (overall-completion 0)
+    (components ())
+    (working-features ()))
+
+  (route-to-mvp
+    (milestones ()))
+
+  (blockers-and-issues
+    (critical)
+    (high)
+    (medium)
+    (low))
+
+  (critical-next-actions
+    (immediate)
+    (this-week)
+    (this-month))
+
+  (session-history ()))

Mustfile

@@ -0,0 +1,13 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Mustfile - hyperpolymath mandatory checks
+# See: https://github.com/hyperpolymath/mustfile
+
+version: 1
+
+checks:
+  - name: security
+    run: just lint
+  - name: tests
+    run: just test
+  - name: format
+    run: just fmt