Update AGENTS.md: debby repo layout + Hermes identity + FreeBSD 15 (Sam & Claude)
- 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
This commit is contained in:
123kupola
Operator & Claude Code
parent
eb65a32227
commit
203d9faea7
1 changed files with 24 additions and 20 deletions
44
AGENTS.md
44
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
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue