clawdie/layered-soul
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
layered-soul/AGENTS.md
Hermes & Sam 9c332b1b78 docs: expand agent matrix — 5 agents across 3 hosts, Hermes-FreeBSD integration plan 
- Agent roster: add Autolycus (Hermes fork on FreeBSD 15/OSA)
- AGENTS.md: full 5-agent matrix with harness/OS/role
- New doc: CLAIRE-FREEBSD-HERMES-INTEGRATION.md — phased plan
- Added hermes-freebsd to private sources list
2026-06-14 03:09:17 +02:00

2.7 KiB
Raw Blame History

Layered Soul Agent Rules

  • Do not commit secrets, API keys, auth tokens, browser profiles, or raw credential files.
  • Do not import raw sessions into another harness by default.
  • Curate memories before adding them under memories/curated/.
  • Keep Hermes-native runtime configuration in hermes-soul; this repository is the cross-harness contract.
  • Public examples may reference private source repositories by URL/name, but must not quote or copy their private contents.
  • Use scripts/layered_soul.py validate . before committing structural changes.
  • When adapting for Colibri: reviewed skills map to system_skills, curated memory maps to system_brain, converted task manifests map to system_ops.
  • When adapting for Hermes (upstream, Linux): load as profile context (SOUL.md + USER.md + IDENTITY.md). Hermes-native config and cron stay in hermes-soul.
  • When adapting for Autolycus (Hermes fork, FreeBSD): same profile-context load; FreeBSD-specific gaps (voice, clipboard) are known and tracked in docs/CLAIRE-FREEBSD-HERMES-INTEGRATION.md.
  • When adapting for Pi/Codex/Claude Code/Zot: render the prompt bundle (render-prompt) and inject as task-scoped context. Durable findings flow back through reviewed commits.

Active infrastructure

  • Forgejo: code.smilepowered.org (SSH port 2222)
  • Vaultwarden: vault.smilepowered.org (SSL)
  • Tailscale: debby=100.66.193.10, domedog=100.103.255.41, osa=100.72.229.63
  • Commit identity: hello@clawdie.si for all project commits

Agent matrix (5 agents across 3 hosts)

Agent Host Harness OS Role
Hermes debby Hermes Agent (upstream) Debian 13 Orchestrator, soul backup
Zot debby Zot RPC Debian 13 Coding, media workflows
Claude domedog Claude Code Linux Verification, review
Codex osa Codex CLI FreeBSD 15 ISO builds, validation
Autolycus osa Hermes Agent (fork) FreeBSD 15 Native FreeBSD Hermes

Private sources

  • hermes-soul: git@code.smilepowered.org:clawdie/hermes-soul.git (private, operator access only)
  • hermes-freebsd: git@code.smilepowered.org:clawdie/hermes-freebsd.git (private, Hermes fork for FreeBSD)
  • clawdie-ai: git@code.smilepowered.org:clawdie/clawdie-ai.git (private)
  • clawdie-iso: git@code.smilepowered.org:clawdie/clawdie-iso.git (private)

Quick reference

# Validate
python3 scripts/layered_soul.py validate .

# See what's available from hermes-soul
python3 scripts/layered_soul.py plan-private-source \
  examples/private-sources/hermes-soul.example.json \
  --source-root ~/hermes-soul

# Render for a harness
python3 scripts/layered_soul.py render-prompt . --output /tmp/soul-prompt.md