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

Browse source 
Project Identity added: the ISO builds the operator USB which is both
the Colibri development surface AND the Clawdie bare-metal service
installer. Clawdie service target: ZFS RAID1, PostgreSQL + pgvector,
bhyve VMs, Bastille jails.
This commit is contained in:
Sam & Claude 2026-06-21 14:16:33 +02:00
parent f10216db12
commit b2f9f03e9e
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