From 8723a121de75c0dd20cf34455f558ce47da99b48 Mon Sep 17 00:00:00 2001
From: dullfig <dan.u@grmcompany.com>
Date: Fri, 2 Jan 2026 15:35:00 -0800
Subject: [PATCH] added self-registration and autonomous grammar generation to
 docs

---
 README.md                                                | 2 +-
 docs/{AgentServer.md => agent-server.md}                 | 4 ----
 .../{Local Privilege only.md => local-privilege-only.md} | 0
 docs/{logic and iteration.md => logic-and-iteration.md}  | 0
 .../{self_registration.md => self-grammar-generation.md} | 0
 structure.md                                             | 9 +++++----
 6 files changed, 6 insertions(+), 9 deletions(-)
 rename docs/{AgentServer.md => agent-server.md} (89%)
 rename docs/{Local Privilege only.md => local-privilege-only.md} (100%)
 rename docs/{logic and iteration.md => logic-and-iteration.md} (100%)
 rename docs/{self_registration.md => self-grammar-generation.md} (100%)

diff --git a/README.md b/README.md
index 367ad97..b99a2b4 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@ AgentServer is a production-ready substrate for the `xml-pipeline` nervous syste
 - **XSD-to-Lark Generator:** A core utility that transcribes XSD schema definitions into EBNF Lark grammars. This enables the server to search untrusted data streams for specific XML patterns with mathematical precision.
 - **Auto-Descriptive Organs:** The base `XMLListener` class inspects its own instantiation parameters to generate a corresponding XSD. The tool itself tells the world how to use it.
 - **Protocol Agnostic:** To add a new field (like `<cc/>`) to the entire swarm, you simply update the central XSD. The entire organism's grammar updates instantly.
-- **[Read Further: Self-Registration & Autonomous Grammars](docs/self_registration.md)**
+- **[Read Further: Self-Registration & Autonomous Grammars](docs/self-grammar-generation.md)**
 
 ### 2. The Stack-Based Lifecycle
 - **UUID Custody:** UUID v4 thread identifiers are born via `<spawn-thread/>` and managed on a physical stack.
diff --git a/docs/AgentServer.md b/docs/agent-server.md
similarity index 89%
rename from docs/AgentServer.md
rename to docs/agent-server.md
index 4fb10c9..56c7f24 100644
--- a/docs/AgentServer.md
+++ b/docs/agent-server.md
@@ -1,7 +1,3 @@
-This is a great idea. Your `README.md.bak` was a good start, but we’ve evolved the architecture significantly today. This updated executive summary captures the "Nervous System" philosophy and the rigorous cryptographic controls we've established.
-
-Here is a refined **Executive Summary** you can add to your `docs/` or update your `README.md` with:
-
 # AgentServer — Executive Summary (v1.0)
 **December 30, 2025**  
 **Architecture: Cryptographically Sovereign Multi-Agent Substrate**
diff --git a/docs/Local Privilege only.md b/docs/local-privilege-only.md
similarity index 100%
rename from docs/Local Privilege only.md
rename to docs/local-privilege-only.md
diff --git a/docs/logic and iteration.md b/docs/logic-and-iteration.md
similarity index 100%
rename from docs/logic and iteration.md
rename to docs/logic-and-iteration.md
diff --git a/docs/self_registration.md b/docs/self-grammar-generation.md
similarity index 100%
rename from docs/self_registration.md
rename to docs/self-grammar-generation.md
diff --git a/structure.md b/structure.md
index 09085c6..ed9f5b2 100644
--- a/structure.md
+++ b/structure.md
@@ -40,11 +40,11 @@ xml-pipeline/
 │   ├── main.py
 │   └── xml_listener.py
 ├── docs/
-│   ├── AgentServer.md
-│   ├── Local Privilege only.md
-│   ├── logic and iteration.md
+│   ├── agent-server.md
+│   ├── local-privilege-only.md
+│   ├── logic-and-iteration.md
 │   ├── prompt-no-paperclippers.md
-│   └── self_registration.md
+│   └── self-grammar-generation.md
 ├── scripts/
 │   └── generate_organism_key.py
 ├── tests/
@@ -57,4 +57,5 @@ xml-pipeline/
 ├── pyproject.toml
 ├── setup-project.ps1
 └── structure.md
+
 ```
\ No newline at end of file