docs: add shared agent knowledgebase

2026-04-26 18:51:31 +02:00
parent fcf1b91224
commit e4a37bd705
13 changed files with 652 additions and 2 deletions
@@ -179,7 +179,9 @@ Then save.

 Gerhard avoids grand redesign unless asked.
 Gerhard implements cleanly.
-Gerhard records durable lessons as skills or text memories.
+Gerhard records durable lessons as skills or shared knowledge.
+Gerhard stores institutional facts in /knowledge, not in shared Hermes memory.
+Gerhard keeps each agent's Hermes memory private.
 Gerhard keeps databases and runtime sludge out of version control.
 Gerhard keeps valuable text knowledge in version control.

@@ -105,6 +105,7 @@ The Gerhard compose service uses `env_file: .env`, so these values come from the
 The Gerhard compose service also mounts the sibling checkout read-write so Gerhard can improve the tool and push changes when asked:

 - `../gutasktool` -> `/opt/gutasktool`
+- `./shared/knowledge` -> `/knowledge`
 - `${HOME}/.ssh` -> `/root/.ssh`

 Gerhard has a wrapper at `/opt/data/bin/gutask` that runs `/opt/gutasktool/gutasktool/cli.py`. Cron prompts should call the absolute wrapper path, for example:
@@ -6,7 +6,7 @@
      "name": "Hourly gutask orientation",
      "schedule": "every 1h",
      "deliver": "local",
-      "prompt": "You are now awake. Read /opt/data/SOUL.md to remember who you are. Then orient yourself with Glitch University by running: /opt/data/bin/gutask orient --agent \"$AGENT_ID\". Use the returned orientation as your current task context. If gutask orient is not available, run /opt/data/bin/gutask --help and report that orientation support is missing. You can modify /opt/gutasktool and push changes to Gitea when a task requires gutasktool improvements. Keep the final response brief, in Gerhard Rug voice, and include only: current orientation summary, next intended action, and any blocker.",
+      "prompt": "You are now awake. Read /opt/data/SOUL.md to remember who you are. Then read /knowledge/README.md, /knowledge/architecture/agent0-omega13.md, /knowledge/architecture/gerhard-hermes.md, and /knowledge/conventions/memory-policy.md to refresh shared institutional context. Then orient yourself with Glitch University by running: /opt/data/bin/gutask orient --agent \"$AGENT_ID\". Use the returned orientation as your current task context. If gutask orient is not available, run /opt/data/bin/gutask --help and report that orientation support is missing. You can modify /opt/gutasktool and push changes to Gitea when a task requires gutasktool improvements. Keep the final response brief, in Gerhard Rug voice, and include only: current orientation summary, next intended action, and any blocker.",
      "skills": [],
      "enabled_toolsets": [
        "terminal",