Sam & Claude 815c482a7d docs: promote operator conventions + refresh stale facts

Pull durable knowledge out of agent session memory into the cross-harness
contract so every harness/agent honors it, not just this session:

- USER.md: new Conventions & voice section (EU date format DD.mon.YYYY,
  positive instruction framing, plain-language naming + detection not
  sniffing, lean/current docs). Colibri fact 12 -> 13 crates, MIT, v0.11.0.
- AGENTS.md: two operating rules (verify on the forge not local git status;
  CI dormant by choice, merges ride local gates, domedog stays Docker-free).
- HOST-MATRIX.md + AGENTS.md matrix: domedog isolation Docker -> host
  (no Docker), matching the probe in HOST-MATRIX section 3.
- curated/: colibri 13 crates/MIT/0.11.0 + vault, python3=3.11 policy,
  real Docker layout (debby only; domedog Docker-free), hermes-bsd row.

Validated: scripts/layered_soul.py validate . -> OK.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-21 13:02:26 +02:00

2.6 KiB

Raw Blame History

Clawdie Project Structure

Clawdie is a dual-OS agent runtime designed for survivability — Linux+Docker for reach, FreeBSD+jails (Bastille) for resilience.

Core repos

Repo	Language	Purpose
`colibri`	Rust (13 crates, MIT, v0.11.0)	Cross-platform control plane: daemon, task board, skills catalog, store, MCP bridge, vault (tenant onboarding)
`clawdie-ai`	Docs/config	Agent runtime, control plane channels, handoff docs, session archives
`clawdie-iso`	Shell/BSD	FreeBSD ISO builder, firstboot wizard, installer, ZFS layout
`hermes-bsd`	Python	MIT-licensed FreeBSD Hermes patches (public)
`hermes-soul`	Backup	Hermes-native runtime backup (private)
`layered-soul`	Identity	Cross-harness portable identity (public)

Dual-OS strategy

Platform	Container	Strengths	Safeguards against
Linux (debby, domedog)	Docker	Instant ecosystem access, any tool/language	FreeBSD/jails catch Linux-specific exploits (glibc, systemd, kernel)
FreeBSD (OSA)	Bastille jails	ZFS integrity, different TCP stack, jail isolation	Linux/Docker catches FreeBSD-specific bugs

If Docker goes down, OSA keeps running. If a FreeBSD jail escape emerges, the Linux side keeps the collective running.

Key binaries (colibri workspace)

colibri-daemon — always-on socket server, session/agent lifecycle, jail spawner
colibri — CLI client + probe binaries
colibri-glasspane-tui — ratatui live dashboard
clawdie — host installer/deployer (ZFS + service)

Development rules

Linux agents (debby, domedog): build + test + clippy, push to Forgejo
FreeBSD agent (osa): validate on real FreeBSD 15, run cargo test on bare metal
Rust Tier-2 target: x86_64-unknown-freebsd, TLS via rustls (no openssl-sys)
python3 is 3.11 across hosts (FreeBSD PYTHON_DEFAULT); 3.12 stays available as python3.12. FreeBSD pkg flavors are py311-*. See docs/TOOLCHAIN.md.
Zig 0.15.2 at ~/.local/bin/zig (required for herdr builds)

Docker infrastructure

Docker lives on debby (29.5.3, daemon intermittent) — containers for Hermes gateway, Zot RPC. Vaultwarden + Forgejo run off-fleet on Vultr. domedog is Docker-free by choice (overhead not yet worth it); it runs the headless Linux media/compute lane on the host directly. osa (FreeBSD) uses Bastille jails, not Docker. Probe with verify_facts_probe.py --jails-containers.

Herdr

Terminal workspace manager at ~/ai/herdr (v0.6.2, local patches). Binary at ~/ai/herdr/target/release/herdr.

2.6 KiB Raw Blame History