From b2f9f03e9ec2a67c4a49990e8cf541695670572e Mon Sep 17 00:00:00 2001 From: Sam & Claude Date: Sun, 21 Jun 2026 14:16:33 +0200 Subject: [PATCH] docs: define clawdie-iso as USB dev surface + Clawdie service installer 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. --- AGENTS.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) 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 -- 2.45.3