layered-soul/README.md

30 lines
1.3 KiB
Markdown
Raw Normal View History

# Layered Soul
Layered Soul is the clean cross-harness soul repository for Clawdie agents.
It carries durable identity, reviewed user context, and approved skills in a format that Pi, Hermes, Colibri, Codex, Claude Code, Zot, and future harnesses can adapt without copying a whole runtime backup.
`hermes-soul` can continue to exist as the Hermes-native backup from Debby Linux. This repo is the shared source contract.
## Core files
- `SOUL.md` — durable agent identity, values, voice, and operating style
- `USER.md` — operator/user context that may be shared with this agent
- `IDENTITY.md` — short runtime identity and boundaries
- `AGENTS.md` — harness-facing operating rules
- `manifest.json` — schema, provenance, privacy, and adapter hints
## Optional layers
- `skills/` — reviewed reusable procedures that can seed `system_skills` or harness-native skill directories
- `memories/curated/` — reviewed memory summaries that can seed `system_brain`
- `adapters/` — notes for materializing the same soul into specific harnesses
## Rules
- No secrets.
- No raw chat logs by default.
- No harness lock files or runtime caches.
- Raw Hermes sessions stay in `hermes-soul` unless the operator requests summarization.
- Durable memory returns to the Layered Memory Fabric.