clawdie/layered-soul
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
layered-soul/AGENTS.md

52 lines
2.7 KiB
Markdown
Raw Normal View History

Initial Layered Soul contract (Sam & Codex) Creates the cross-harness Layered Soul repository skeleton while keeping hermes-soul as the Hermes-native Debby Linux backup.\n\nChecks: npx --yes prettier@3 --write touched docs/manifests
2026-06-13 14:50:54 +02:00
# 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.
Build Layered Soul template and helper tooling (Sam & Codex) Merges the public Forgejo seed repo with the prepared Layered Soul skeleton, expands the README, adds validation/rendering/private-source planning helper tooling, and documents how private hermes-soul connects without copying private runtime state.\n\nChecks: prettier on markdown; python3 -m json.tool manifests; python3 scripts/layered_soul.py validate .; render-prompt smoke; plan-private-source smoke against /home/clawdie/ai/hermes-soul; git diff --check
2026-06-13 21:49:43 +02:00
- 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.
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean
2026-06-14 00:21:26 +02:00
- When adapting for Colibri: reviewed skills map to `system_skills`, curated memory maps to `system_brain`, converted task manifests map to `system_ops`.
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
- 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`.
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean
2026-06-14 00:21:26 +02:00
- 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
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
## 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 |
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean
2026-06-14 00:21:26 +02:00
## Private sources
- `hermes-soul`: git@code.smilepowered.org:clawdie/hermes-soul.git (private, operator access only)
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
- `hermes-freebsd`: git@code.smilepowered.org:clawdie/hermes-freebsd.git (private, Hermes fork for FreeBSD)
Populate layered-soul: identity, memories, skills, plan (Hermes & Sam) - SOUL.md: full agent identity, operating principles, voice - IDENTITY.md: runtime identity, hosts, boundaries - USER.md: operator context imported from hermes-soul - AGENTS.md: actual operating rules, infrastructure, quick reference - memories/curated/: 5 topics (tailscale, forgejo, agents, projects, vaultwarden) - skills/: 9 cross-harness skills imported from hermes-soul after review - docs/PLAN-CONFIGURE-PRIVATE-REPO.md: configuration plan - Validate: passes clean
2026-06-14 00:21:26 +02:00
- `clawdie-ai`: git@code.smilepowered.org:clawdie/clawdie-ai.git (private)
- `clawdie-iso`: git@code.smilepowered.org:clawdie/clawdie-iso.git (private)
## Quick reference
```sh
# 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
```
Reference in a new issue Copy permalink