layered-soul/AGENTS.md

# 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: load as profile context (SOUL.md + USER.md + IDENTITY.md). Hermes-native config and cron stay in `hermes-soul`.
- 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

## Private sources

- `hermes-soul`: git@code.smilepowered.org:clawdie/hermes-soul.git (private, operator access only)
- `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
```
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`.
			- When adapting for Hermes: load as profile context (SOUL.md + USER.md + IDENTITY.md). Hermes-native config and cron stay in `hermes-soul`.
			- 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

			`## Private sources`

			- `hermes-soul`: git@code.smilepowered.org:clawdie/hermes-soul.git (private, operator access only)
			- `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`
			```