51 lines
1.9 KiB
Markdown
51 lines
1.9 KiB
Markdown
|
# Glitch University shared knowledgebase
|
||
|
|
|
||
|
|
This directory is the shared library for Agent0 agents.
|
||
|
|
|
||
|
|
It is plain text, version-controlled, and mounted into agent containers at:
|
||
|
|
|
||
|
|
```text
|
||
|
|
/knowledge
|
||
|
|
```
|
||
|
|
|
||
|
|
Use this library for durable institutional knowledge that should be available to all agents. Do not use shared Hermes memories for this. Hermes memories are agent-local and should remain private to each agent instance.
|
||
|
|
|
||
|
|
## What belongs here
|
||
|
|
|
||
|
|
- Stable architecture facts about Omega13, Agent0, Gerhard, gutasktool, and Glitch University infrastructure.
|
||
|
|
- Deployment and operation runbooks.
|
||
|
|
- Shared conventions and policies.
|
||
|
|
- Non-secret institutional lore that should survive container rebuilds and be reviewable in Git.
|
||
|
|
|
||
|
|
## What does not belong here
|
||
|
|
|
||
|
|
- Secrets, passwords, tokens, API keys, SSH private keys, cookies, or auth files.
|
||
|
|
- Runtime databases, logs, session transcripts, caches, generated scheduler output, or lock files.
|
||
|
|
- Temporary task progress that belongs in `gutask`.
|
||
|
|
- Agent-local personal memory that belongs in that agent's own Hermes memory.
|
||
|
|
|
||
|
|
## Agent startup convention
|
||
|
|
|
||
|
|
On wake, agents that mount this library should read:
|
||
|
|
|
||
|
|
1. `/knowledge/README.md`
|
||
|
|
2. Relevant files under `/knowledge/architecture/`
|
||
|
|
3. Relevant files under `/knowledge/conventions/`
|
||
|
|
4. Relevant files under `/knowledge/runbooks/` for the task at hand
|
||
|
|
|
||
|
|
Gerhard should especially read:
|
||
|
|
|
||
|
|
- `/knowledge/architecture/agent0-omega13.md`
|
||
|
|
- `/knowledge/architecture/gerhard-hermes.md`
|
||
|
|
- `/knowledge/conventions/memory-policy.md`
|
||
|
|
- `/knowledge/runbooks/gutasktool-development.md`
|
||
|
|
|
||
|
|
## Mental model
|
||
|
|
|
||
|
|
- Hermes memory is the private notebook of one agent.
|
||
|
|
- This knowledgebase is the shared library of the institution.
|
||
|
|
- Skills are reusable tools and procedures.
|
||
|
|
- `gutask` is the work board.
|
||
|
|
- Festinger / Glitch University backend is the living world model and operational database.
|
||
|
|
- Sessions and logs are smoke. Useful for debugging, not canonical memory.
|