From 203d9faea7a6a9dd895cdff23f61ec8eaca42221 Mon Sep 17 00:00:00 2001 From: 123kupola <123kupola@gmail.com> Date: Wed, 27 May 2026 00:25:10 +0200 Subject: [PATCH] Update AGENTS.md: debby repo layout + Hermes identity + FreeBSD 15 (Sam & Claude) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Colibri moved to ~/ai/colibri (standalone), ~/ai/clawdie/colibri removed - Add clawdie-iso and herdr to debby repo table - Rename Linux agent identity to Claude / Hermes - FreeBSD host platform updated to FreeBSD 15 throughout --- Build: pass | Tests: FAIL — 18 failed --- AGENTS.md | 44 ++++++++++++++++++++++++-------------------- 1 file changed, 24 insertions(+), 20 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 90e8d5f..77fe97d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -693,11 +693,11 @@ handoff tracking. | Identity | Platform | Capabilities | Restrictions | | ------------------------------- | ------------------------------ | ------------------------------------------------------------- | ----------------------------------------------------------------------- | -| Claude (debby — Debian 13) | debby, 16 cores / 15 GB RAM | Rust builds, cargo test, code editing, git push | Cannot run tests expecting FreeBSD, cannot build ISO, no FreeBSD cmds | -| Claude (Linux) | Generic Linux dev machine | Code search, file editing, git push | Cannot run tests (Linux), cannot build ISO, cannot run FreeBSD commands | -| Codex app (FreeBSD) | FreeBSD host | Runs tests, edits code, validates runtime seams | Receives handoff docs, cannot push without operator review | -| Aider / FreeBSD agent | FreeBSD host | Runs tests, reviews patches, validates on host | Receives handoff docs, cannot push without operator review | -| Operator (Sam) | FreeBSD host + Linux | Final review, merge decisions, ISO builds, deploys | Human — all commits require approval | +| Claude / Hermes (debby — Debian 13) | debby, 16 cores / 15 GB RAM | Rust builds, cargo test, code editing, git push | Cannot run tests expecting FreeBSD, cannot build ISO, no FreeBSD cmds | +| Claude / Hermes (Linux) | Generic Linux dev machine | Code search, file editing, git push | Cannot run tests (Linux), cannot build ISO, cannot run FreeBSD commands | +| Codex app (FreeBSD) | FreeBSD 15 host | Runs tests, edits code, validates runtime seams | Receives handoff docs, cannot push without operator review | +| Aider / FreeBSD agent | FreeBSD 15 host | Runs tests, reviews patches, validates on host | Receives handoff docs, cannot push without operator review | +| Operator (Sam) | FreeBSD 15 host + Linux | Final review, merge decisions, ISO builds, deploys | Human — all commits require approval | ### Debian Build Agent (debby) @@ -708,7 +708,9 @@ Repos checked out on this machine: | Path | Repo | Notes | |------|------|-------| | `~/ai/clawdie` | `Clawdie/Clawdie-AI` | main development repo | -| `~/ai/clawdie/colibri` | `Clawdie/Colibri` | Pi control sub-project | +| `~/ai/clawdie-iso` | `Clawdie/Clawdie-ISO` | ISO builder, firstboot, installer | +| `~/ai/colibri` | `Clawdie/Colibri` | Cross-platform Rust control plane | +| `~/ai/herdr` | `ogulcancelik/herdr` | Rust CLI for LLM agents (exploration) | #### Rust Toolchain — installed ✅ @@ -731,30 +733,31 @@ System build deps (`build-essential`, `pkg-config`, `libssl-dev`) already presen #### Debian Build Agent MUST NOT - Install packages via `apt`, `cargo install`, `rustup`, or any package manager -- Run FreeBSD-specific commands (`bastille`, `service`, `pkg`, `jls`, `zpool`) +- Run FreeBSD 15-specific commands (`bastille`, `service`, `pkg`, `jls`, `zpool`) - Build the ISO (`./build.sh`) -- Assume runtime behaviour matches FreeBSD production +- Assume runtime behaviour matches FreeBSD 15 production #### Debian Build Agent SHOULD - Run `cargo build`, `cargo test`, `cargo clippy` once Rust is confirmed installed -- Push to Codeberg for the FreeBSD agent to validate runtime seams +- Build Colibri from `~/ai/colibri` and Clawdie-AI TypeScript from `~/ai/clawdie` +- Push to Codeberg for the FreeBSD 15 agent to validate runtime seams - Create handoff docs for FreeBSD-specific tasks - Guide the operator with exact commands when a system-level change is needed -### Linux Agent Constraints +### Linux Agent Constraints (Claude / Hermes) -The Linux agent (Claude/Aider on Linux) MUST NOT: +The Linux agent (Claude or Hermes on Linux) MUST NOT: - Attempt to build the ISO (`./build.sh`) - Run `npm test` or `npx vitest` (unreliable on Linux) -- Run any FreeBSD-specific commands (`bastille`, `service`, `pkg`, `jls`) -- Assume packages or runtime behavior matches FreeBSD +- Run any FreeBSD 15-specific commands (`bastille`, `service`, `pkg`, `jls`) +- Assume packages or runtime behavior matches FreeBSD 15 The Linux agent SHOULD: - Write code, tests, and documentation -- Push to Codeberg for the FreeBSD agent to validate +- Push to Codeberg for the FreeBSD 15 agent to validate - Create handoff docs for FreeBSD-specific tasks - Guide the operator with exact commands to run @@ -1027,28 +1030,29 @@ The control plane now pivots to a terminal-first harness (extensions + safety). ## Cross-Repo Coordination -Clawdie spans two repos. Changes often require coordinated updates. +Clawdie spans three repos. Changes often require coordinated updates. | Repo | Purpose | Remote | | ------------- | ---------------------------------------- | ------------------------------------------ | | `Clawdie-AI` | Agent runtime, control plane, channels | `git@codeberg.org:Clawdie/Clawdie-AI.git` | | `clawdie-iso` | ISO builder, firstboot wizard, installer | `git@codeberg.org:Clawdie/Clawdie-ISO.git` | +| `Colibri` | Cross-platform Rust control plane core | `git@codeberg.org:Clawdie/Colibri.git` | -### When Changes Span Both Repos +### When Changes Span Repos 1. Make changes in the repo that owns the primary logic -2. Create a handoff doc in THAT repo listing what needs updating in the other -3. Push both repos +2. Create a handoff doc in THAT repo listing what needs updating in the others +3. Push all affected repos 4. Operator or other agent applies the cross-repo changes ### Example Flow ``` -Linux Claude adds auth fields to clawdie-iso firstboot.sh +Linux Claude/Hermes adds auth fields to clawdie-iso firstboot.sh → Pushes clawdie-iso → Creates handoff in Clawdie-AI: "doc/INSTALLER-AUTH-HANDOFF.md" → Lists: "shell-env.sh needs CLAUDE_CODE_OAUTH_TOKEN added" - → FreeBSD agent reads handoff, applies change, deletes doc + → FreeBSD 15 agent reads handoff, applies change, deletes doc ``` ### Install-Time Boundary