clawdie/clawdie-iso
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: define clawdie-iso as USB dev surface + Clawdie service installer #89

Merged
clawdie merged 1 commit from docs/clawdie-bare-metal-identity into main 2026-06-21 14:20:40 +02:00
Conversation 0 Commits 1 Files changed 1 +13
1 changed files with 13 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
AGENTS.md
View file

@ -1,5 +1,18 @@
# Clawdie ISO Agent Guidelines
## Project Identity
**clawdie-iso** builds the operator USB image — a live FreeBSD 15 XFCE
environment that serves two roles:
- **Development surface** for Colibri: build, validate, and iterate on the
control plane from a bootable USB without touching the host OS.
- **Installer** for the **Clawdie service**: deploys Colibri as an rc.d
service on bare FreeBSD hardware (ZFS RAID1 mirror, PostgreSQL + pgvector,
bhyve VMs, Bastille jails).
The USB is the swiss-army knife — the bare-metal install is the production
target.
## Agent Identity and Current Role Split
The XFCE operator USB work now uses a git-coordinated split. Agents may review