diff --git a/AGENTS.md b/AGENTS.md index ac757a96..db8dacd9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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