docs(polish): prettier formatting, add missing skill to index, fix broken doc reference
This commit is contained in:
Sam & Claude
parent
5850ee5bf8
commit
a8926d47ba
4 changed files with 66 additions and 64 deletions
14
AGENTS.md
14
AGENTS.md
|
|
@ -20,13 +20,13 @@
|
|||
|
||||
## Agent matrix (5 agents across 3 hosts)
|
||||
|
||||
| Agent | Host | Harness | OS | Role |
|
||||
|-------|------|---------|----|------|
|
||||
| Hermes | debby | Hermes Agent (upstream) | Debian 13 | Orchestrator, soul backup |
|
||||
| Zot | debby | Zot RPC | Debian 13 | Coding, media workflows |
|
||||
| Claude | domedog | Claude Code | Linux | Verification, review |
|
||||
| Codex | osa | Codex CLI | FreeBSD 15 | ISO builds, validation |
|
||||
| Autolycus | osa | Hermes Agent (fork) | FreeBSD 15 | Native FreeBSD Hermes |
|
||||
| Agent | Host | Harness | OS | Role |
|
||||
| --------- | ------- | ----------------------- | ---------- | ------------------------- |
|
||||
| Hermes | debby | Hermes Agent (upstream) | Debian 13 | Orchestrator, soul backup |
|
||||
| Zot | debby | Zot RPC | Debian 13 | Coding, media workflows |
|
||||
| Claude | domedog | Claude Code | Linux | Verification, review |
|
||||
| Codex | osa | Codex CLI | FreeBSD 15 | ISO builds, validation |
|
||||
| Autolycus | osa | Hermes Agent (fork) | FreeBSD 15 | Native FreeBSD Hermes |
|
||||
|
||||
## Private sources
|
||||
|
||||
|
|
|
|||
|
|
@ -8,6 +8,7 @@ Four targeted patches (setup.py, uninstall.py, voice_mode.py, install script).
|
|||
No LGPL encumbrance — pure MIT, same as upstream.
|
||||
|
||||
**Key facts:**
|
||||
|
||||
- Runs on FreeBSD without emulation or containers
|
||||
- CLI, Telegram gateway, TUI all functional on FreeBSD
|
||||
- `scripts/install-freebsd.sh` provides native installation
|
||||
|
|
@ -20,14 +21,14 @@ Currently OSA (FreeBSD 15 host) runs Codex CLI for ISO builds and cargo validati
|
|||
It has no Hermes instance — all orchestration happens on debby (Linux). Adding
|
||||
Autolycus to OSA gives us:
|
||||
|
||||
| Capability | Before | After |
|
||||
|-----------|--------|-------|
|
||||
| Hermes on FreeBSD | ❌ None | ✅ Native |
|
||||
| ISO-side agent | ❌ Codex only | ✅ Hermes + Codex |
|
||||
| layered-soul on FreeBSD | ❌ No | ✅ Via adapters/hermes.md |
|
||||
| Headroom on FreeBSD | ❌ No path | ✅ Python works natively |
|
||||
| Colibri + Hermes co-host | ❌ Linux only | ✅ Both on FreeBSD |
|
||||
| Telegram gateway on OSA | ❌ No | ✅ Direct from FreeBSD |
|
||||
| Capability | Before | After |
|
||||
| ------------------------ | ------------- | ------------------------- |
|
||||
| Hermes on FreeBSD | ❌ None | ✅ Native |
|
||||
| ISO-side agent | ❌ Codex only | ✅ Hermes + Codex |
|
||||
| layered-soul on FreeBSD | ❌ No | ✅ Via adapters/hermes.md |
|
||||
| Headroom on FreeBSD | ❌ No path | ✅ Python works natively |
|
||||
| Colibri + Hermes co-host | ❌ Linux only | ✅ Both on FreeBSD |
|
||||
| Telegram gateway on OSA | ❌ No | ✅ Direct from FreeBSD |
|
||||
|
||||
## Phased integration
|
||||
|
||||
|
|
@ -62,29 +63,29 @@ Autolycus to OSA gives us:
|
|||
|
||||
## Agent matrix (expanded)
|
||||
|
||||
| Agent | Host | Harness | OS | Model | Role |
|
||||
|-------|------|---------|----|-------|------|
|
||||
| Hermes | debby | Hermes Agent (upstream) | Debian 13 | DeepSeek v4 | Orchestrator, soul backup |
|
||||
| Zot | debby | Zot RPC | Debian 13 | GLM-5.1 | Coding, media |
|
||||
| Claude | domedog | Claude Code | Linux | Claude | Verification, review |
|
||||
| Codex | osa | Codex CLI | FreeBSD 15 | GPT | ISO builds, validation |
|
||||
| **Autolycus** | **osa** | **Hermes Agent (fork)** | **FreeBSD 15** | **TBD** | **Native FreeBSD agent** |
|
||||
| Agent | Host | Harness | OS | Model | Role |
|
||||
| ------------- | ------- | ----------------------- | -------------- | ----------- | ------------------------- |
|
||||
| Hermes | debby | Hermes Agent (upstream) | Debian 13 | DeepSeek v4 | Orchestrator, soul backup |
|
||||
| Zot | debby | Zot RPC | Debian 13 | GLM-5.1 | Coding, media |
|
||||
| Claude | domedog | Claude Code | Linux | Claude | Verification, review |
|
||||
| Codex | osa | Codex CLI | FreeBSD 15 | GPT | ISO builds, validation |
|
||||
| **Autolycus** | **osa** | **Hermes Agent (fork)** | **FreeBSD 15** | **TBD** | **Native FreeBSD agent** |
|
||||
|
||||
## Gaps to close (from FreeBSD audit)
|
||||
|
||||
| Gap | Severity | Fix |
|
||||
|-----|----------|-----|
|
||||
| faster-whisper wheels | Medium | Build from source, or skip voice on FreeBSD |
|
||||
| Clipboard support | Low | Implement xclip/xsel equivalent for FreeBSD |
|
||||
| Docker/Singularity backends | Low | Skip — Colibri provides jail-based isolation |
|
||||
| Platform detection in setup.py | Medium | Add FreeBSD branches (upstreamable) |
|
||||
| Gap | Severity | Fix |
|
||||
| ------------------------------ | -------- | -------------------------------------------- |
|
||||
| faster-whisper wheels | Medium | Build from source, or skip voice on FreeBSD |
|
||||
| Clipboard support | Low | Implement xclip/xsel equivalent for FreeBSD |
|
||||
| Docker/Singularity backends | Low | Skip — Colibri provides jail-based isolation |
|
||||
| Platform detection in setup.py | Medium | Add FreeBSD branches (upstreamable) |
|
||||
|
||||
## Files to touch
|
||||
|
||||
| File | Change |
|
||||
|------|--------|
|
||||
| `layered-soul/memories/curated/agent-roster.md` | Add Autolycus row |
|
||||
| `layered-soul/AGENTS.md` | Add Autolycus to agent references |
|
||||
| `layered-soul/docs/PLAN-CONFIGURE-PRIVATE-REPO.md` | Add Phase 5: FreeBSD agent |
|
||||
| `clawdie-ai/docs/` (or handoff) | Agent matrix expansion note |
|
||||
| `colibri/docs/AGENTS.md` | Note FreeBSD-side Hermes availability |
|
||||
| File | Change |
|
||||
| ----------------------------------------------- | ---------------------------------------- |
|
||||
| `layered-soul/memories/curated/agent-roster.md` | Add Autolycus row |
|
||||
| `layered-soul/AGENTS.md` | Add Autolycus to agent references |
|
||||
| `layered-soul/docs/CONNECT-HERMES-SOUL.md` | Document FreeBSD agent source connection |
|
||||
| `clawdie-ai/docs/` (or handoff) | Agent matrix expansion note |
|
||||
| `colibri/docs/AGENTS.md` | Note FreeBSD-side Hermes availability |
|
||||
|
|
|
|||
|
|
@ -2,30 +2,30 @@
|
|||
|
||||
## Active agents
|
||||
|
||||
| Agent | Home Host | Harness | Model | Role |
|
||||
|-------|----------|---------|-------|------|
|
||||
| Hermes | debby (Debian 13) | Hermes Agent | DeepSeek v4 | Orchestrator, primary dev agent, soul backup |
|
||||
| Zot | debby (Debian 13) | Zot RPC | GLM-5.1 | Coding specialist, media workflows |
|
||||
| Claude | domedog (Linux) | Claude Code | Claude | Independent verification, secondary builder, reviewer |
|
||||
| Codex | osa (FreeBSD 15) | Codex CLI | GPT | FreeBSD 15 validation, ISO builds, hardware proofs |
|
||||
| Autolycus | osa (FreeBSD 15) | Hermes Agent (fork) | TBD | Native FreeBSD Hermes instance, ISO-side agent |
|
||||
| Agent | Home Host | Harness | Model | Role |
|
||||
| --------- | ----------------- | ------------------- | ----------- | ----------------------------------------------------- |
|
||||
| Hermes | debby (Debian 13) | Hermes Agent | DeepSeek v4 | Orchestrator, primary dev agent, soul backup |
|
||||
| Zot | debby (Debian 13) | Zot RPC | GLM-5.1 | Coding specialist, media workflows |
|
||||
| Claude | domedog (Linux) | Claude Code | Claude | Independent verification, secondary builder, reviewer |
|
||||
| Codex | osa (FreeBSD 15) | Codex CLI | GPT | FreeBSD 15 validation, ISO builds, hardware proofs |
|
||||
| Autolycus | osa (FreeBSD 15) | Hermes Agent (fork) | TBD | Native FreeBSD Hermes instance, ISO-side agent |
|
||||
|
||||
## Multi-agent groups
|
||||
|
||||
| Group | Platform | Members | Purpose |
|
||||
|-------|----------|---------|---------|
|
||||
| "My Debby" | Telegram | @hermes_samob_bot + @zot_samob_bot | Orchestration + coding delegation |
|
||||
| FreeBSD side | OSA host | Codex + Autolycus | ISO builds, validation, native FreeBSD ops |
|
||||
| Group | Platform | Members | Purpose |
|
||||
| ------------ | -------- | ---------------------------------- | ------------------------------------------ |
|
||||
| "My Debby" | Telegram | @hermes_samob_bot + @zot_samob_bot | Orchestration + coding delegation |
|
||||
| FreeBSD side | OSA host | Codex + Autolycus | ISO builds, validation, native FreeBSD ops |
|
||||
|
||||
## Harness matrix
|
||||
|
||||
| Harness | Hosts | Native OS | Capabilities |
|
||||
|---------|-------|-----------|-------------|
|
||||
| Hermes Agent (upstream) | debby | Linux | Full agent, skills, cron, Telegram gateway, voice |
|
||||
| Hermes Agent (Autolycus fork) | osa | FreeBSD 15 | Fork targeting FreeBSD, LGPL v2.1, PTY/local terminal |
|
||||
| Zot RPC | debby | Linux | Structured delegation, GLM-5.1 inference |
|
||||
| Claude Code | domedog | Linux | Verification, code review, document review |
|
||||
| Codex CLI | osa | FreeBSD 15 | ISO builds, cargo test, hardware validation |
|
||||
| Harness | Hosts | Native OS | Capabilities |
|
||||
| ----------------------------- | ------- | ---------- | ----------------------------------------------------- |
|
||||
| Hermes Agent (upstream) | debby | Linux | Full agent, skills, cron, Telegram gateway, voice |
|
||||
| Hermes Agent (Autolycus fork) | osa | FreeBSD 15 | Fork targeting FreeBSD, LGPL v2.1, PTY/local terminal |
|
||||
| Zot RPC | debby | Linux | Structured delegation, GLM-5.1 inference |
|
||||
| Claude Code | domedog | Linux | Verification, code review, document review |
|
||||
| Codex CLI | osa | FreeBSD 15 | ISO builds, cargo test, hardware validation |
|
||||
|
||||
## Secrets
|
||||
|
||||
|
|
|
|||
|
|
@ -4,17 +4,18 @@ Cross-harness skills reviewed and imported from the private `hermes-soul` runtim
|
|||
|
||||
## Included skills
|
||||
|
||||
| Skill | Category | Purpose |
|
||||
| ------------------------- | ------------ | ----------------------------------------------------------------- |
|
||||
| forgejo-operations | devops | Manage self-hosted Forgejo — repos, users, PRs, branch protection |
|
||||
| vaultwarden-secrets | devops | Self-hosted Vaultwarden + Bitwarden CLI for agent secrets |
|
||||
| bootable-usb-images | devops | Download, verify, flash compressed bootable USB images |
|
||||
| herdr-deployment | devops | Build, configure, deploy Herdr terminal workspace manager |
|
||||
| colibri-development | software-dev | Develop in the Colibri Rust workspace — builds, tests, crates |
|
||||
| systematic-debugging | software-dev | 4-phase root cause debugging methodology |
|
||||
| test-driven-development | software-dev | TDD: RED-GREEN-REFACTOR cycle enforcement |
|
||||
| codebase-knowledge-graphs | software-dev | Build/query persistent codebase knowledge graphs |
|
||||
| vision-model-setup | mlops | Configure and troubleshoot vision capabilities across providers |
|
||||
| Skill | Category | Purpose |
|
||||
| ------------------------- | ------------ | ------------------------------------------------------------------------ |
|
||||
| forgejo-operations | devops | Manage self-hosted Forgejo — repos, users, PRs, branch protection |
|
||||
| vaultwarden-secrets | devops | Self-hosted Vaultwarden + Bitwarden CLI for agent secrets |
|
||||
| bootable-usb-images | devops | Download, verify, flash compressed bootable USB images |
|
||||
| herdr-deployment | devops | Build, configure, deploy Herdr terminal workspace manager |
|
||||
| colibri-development | software-dev | Develop in the Colibri Rust workspace — builds, tests, crates |
|
||||
| systematic-debugging | software-dev | 4-phase root cause debugging methodology |
|
||||
| test-driven-development | software-dev | TDD: RED-GREEN-REFACTOR cycle enforcement |
|
||||
| codebase-knowledge-graphs | software-dev | Build/query persistent codebase knowledge graphs |
|
||||
| freebsd-cost-optimization | devops | Use Colibri cost modes (fast/smart/max) to minimize API spend on FreeBSD |
|
||||
| vision-model-setup | mlops | Configure and troubleshoot vision capabilities across providers |
|
||||
|
||||
## Adding skills
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue