Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
53ed782
fix(swarm): recover dead worker sessions, add launcher wrappers, rais…
Jul 2, 2026
f1d6c89
feat(agentic-os): unified file space, all-cloud fleet, perf, green te…
Jul 5, 2026
e304cc3
feat(swarm): blocked-item controls, permission modes, model router, s…
Jul 5, 2026
dd2b468
perf+fix: query caching, Obsidian knowledge vault, graceful API state…
Jul 5, 2026
7512bdf
fix(swarm): stop reporting successful dispatches as blocked/timed-out
estevanjim03-cyber Jul 7, 2026
869a3f1
fix(swarm): self-heal recurring provider drift; models 503; remove-pr…
estevanjim03-cyber Jul 7, 2026
daa7ba0
feat(swarm): "Clear All" button — stop all workers, cancel all tasks,…
estevanjim03-cyber Jul 7, 2026
23bb163
feat(swarm): Clear All also wipes worker chat history for a truly fre…
estevanjim03-cyber Jul 7, 2026
df10de0
feat(swarm): TUI self-completion, daily spend cap, scheduled agent mi…
estevanjim03-cyber Jul 7, 2026
def1387
feat(swarm): phase 2 — daily backups, health-strip drift warnings, Di…
estevanjim03-cyber Jul 7, 2026
a52951f
feat(echo-studio): real backend — persist page specs + dispatch build…
estevanjim03-cyber Jul 7, 2026
9c62d42
feat(agora): real-presence lobby over WebSocket — live peers as littl…
estevanjim03-cyber Jul 7, 2026
b1df3c7
fix(swarm): Clear All now kills in-flight tasks and clears agent logs
estevanjim03-cyber Jul 7, 2026
17537bd
fix(swarm): cold-TUI readiness gate + clear-after-death — kills the r…
estevanjim03-cyber Jul 7, 2026
dd03ef1
docs: playbook entry for cold-TUI readiness gate + clear-race fix
estevanjim03-cyber Jul 7, 2026
260e9e9
fix(security): auth-gate kanban, SSE events, playground NPC/admin routes
estevanjim03-cyber Jul 7, 2026
c7eb077
feat(swarm): Tier 1 learning loops — outcome memory, scoreboard, rout…
estevanjim03-cyber Jul 7, 2026
a4f227f
fix(swarm): self-improve maintainer must use an isolated git worktree
estevanjim03-cyber Jul 7, 2026
edd7bb3
docs: playbook — workers must isolate git work in worktrees
estevanjim03-cyber Jul 7, 2026
4db6252
feat(swarm): Tier B reach — two-way Discord bot + voice-to-orchestrator
estevanjim03-cyber Jul 7, 2026
9495c81
fix(swarm): three-layer defense against workers hijacking the live re…
estevanjim03-cyber Jul 7, 2026
3735c73
feat(swarm): Tier C (partial) — watchdog service + unified timeline
estevanjim03-cyber Jul 7, 2026
4a1abc5
feat(swarm): Tier D+F — RAG memory, task queue, morning briefing, pal…
estevanjim03-cyber Jul 7, 2026
d0c9f7e
feat(swarm): Tier E+G — tier right-sizing, gzip assets, pipelines, iC…
estevanjim03-cyber Jul 7, 2026
2a5029e
fix(swarm): make Clear All actually clear — zombie reaper, kill-first…
estevanjim03-cyber Jul 8, 2026
e06c55e
feat(swarm): Tier H — auto-verification, standing goals, proactive pr…
estevanjim03-cyber Jul 8, 2026
965a408
feat(swarm): Tier I (partial) — phone push via ntfy + GitHub notifica…
estevanjim03-cyber Jul 8, 2026
915c4be
feat(swarm): Tier I — Gmail integration (OAuth loopback + inbox watcher)
estevanjim03-cyber Jul 8, 2026
fefe273
feat(swarm): Tier J — session replay, activity chart, one-command ins…
estevanjim03-cyber Jul 8, 2026
e25c1a2
feat(swarm): Tier K — SSE live updates + optimistic queue actions
estevanjim03-cyber Jul 8, 2026
995b1a5
feat(swarm): Tier L — parallel fleet (worker clones + concurrency caps)
estevanjim03-cyber Jul 8, 2026
2e6da07
feat(swarm): Tier M — four new agents (scribe, data-analyst, archivis…
estevanjim03-cyber Jul 8, 2026
feb7601
feat(swarm): Tier N — natural-language command router + workflow temp…
estevanjim03-cyber Jul 8, 2026
cb9d349
feat(swarm): Tier O — failure autopsies, anomaly alerts, self-benchmark
estevanjim03-cyber Jul 8, 2026
f2cb8ca
feat(security): Tier R — tamper-evident audit log + weekly security scan
estevanjim03-cyber Jul 8, 2026
ff0692c
fix(swarm): shakedown fixes — same-drain clone allocation + stale pip…
estevanjim03-cyber Jul 8, 2026
dd08099
docs: playbook — Tier R + shakedown findings
estevanjim03-cyber Jul 8, 2026
86bda18
fix(swarm): reap pipeline runs orphaned by server restarts
estevanjim03-cyber Jul 8, 2026
0a9a5d4
docs: playbook — shakedown addendum (orphan reaper, reviewer tier flag)
estevanjim03-cyber Jul 8, 2026
12d7ec3
feat(dashboard): hibernate button — stop the whole background fleet
estevanjim03-cyber Jul 10, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 18 additions & 12 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,21 +1,27 @@
# Hermes Workspace Agent Contract

> **Operating a cloud session on this workspace? Read
> [`SWARM-OPERATIONS-PLAYBOOK.md`](./SWARM-OPERATIONS-PLAYBOOK.md) FIRST.** It is
> the durable record of what breaks, recurring bugs to re-check every session,
> exact fix commands, and the build/verify/ship workflow. Update its change log
> when you land a structural fix.

This workspace uses semantic Hermes swarm workers, not numbered-only lanes. The source of truth for routing is `swarm.yaml`; each worker also has a matching profile under `~/.hermes/profiles/<worker-id>/`, a role skill `<worker-id>-core`, and a wrapper in `~/.local/bin/`.

## Current semantic roster

| Worker | Wrapper | Tools | Skills | MCP | Plugins |
|---|---|---|---|---|---|
| `orchestrator` | `orchestrator:plan` | todo, kanban, delegation, terminal, file, gbrain, session_search, cronjob, skills, clarify, web | orchestrator-core, gstack-for-hermes, gbrain, kanban-orchestrator, subagent-driven-development, writing-plans, requesting-code-review, workspace-dispatch | gbrain | none |
| `km-agent` | `km:health` | gbrain, file, terminal, session_search, skills, todo, cronjob, web | km-agent-core, gbrain, obsidian-markdown, obsidian-cli, obsidian-bases, json-canvas, gstack-for-hermes | gbrain | none |
| `builder` | `builder:task` | terminal, file, browser, web, gbrain, session_search, skills, todo | builder-core, gstack-for-hermes, test-driven-development, systematic-debugging, github-pr-workflow, requesting-code-review, codebase-inspection | gbrain | none |
| `reviewer` | `reviewer:gate` | terminal, file, web, gbrain, session_search, skills | reviewer-core, requesting-code-review, github-code-review, systematic-debugging, gstack-for-hermes, gbrain, codebase-inspection | gbrain | none |
| `qa` | `qa:smoke` | browser, terminal, file, vision, gbrain, session_search, skills, web | qa-core, browser-harness-power-use, dogfood, gstack-for-hermes | gbrain | none |
| `researcher` | `researcher:quick` | gbrain, web, browser, terminal, file, vision, session_search, skills, todo | researcher-core, gbrain, autoresearch, browser-harness-power-use, gstack-for-hermes, researcher-quick, researcher-autoresearch, arxiv, youtube-content, polymarket | gbrain | none |
| `ops-watch` | `ops:health` | terminal, cronjob, file, gbrain, skills, session_search, web | ops-watch-core, gbrain, hermes-agent, systematic-debugging, webhook-subscriptions | gbrain | none |
| `maintainer` | `maintainer:check` | terminal, file, web, browser, gbrain, session_search, skills | maintainer-core, github-repo-management, github-pr-workflow, github-issues, github-code-review, gbrain, gstack-for-hermes, hermes-agent | gbrain | none |
| `strategist` | `strategist:review` | gbrain, web, session_search, file, skills, todo, clarify | strategist-core, gstack-for-hermes, gbrain, writing-plans, polymarket | gbrain | none |
| `inbox-triage` | `inbox:triage` | gbrain, web, file, session_search, todo, skills, terminal | inbox-triage-core, gbrain, obsidian-markdown, gstack-for-hermes, defuddle, youtube-content | gbrain | none |
| Worker | Wrapper | Tools | Skills | MCP | Plugins |
| -------------- | ------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | ------- |
| `orchestrator` | `orchestrator:plan` | todo, kanban, delegation, terminal, file, gbrain, session_search, cronjob, skills, clarify, web | orchestrator-core, gstack-for-hermes, gbrain, kanban-orchestrator, subagent-driven-development, writing-plans, requesting-code-review, workspace-dispatch | gbrain | none |
| `km-agent` | `km:health` | gbrain, file, terminal, session_search, skills, todo, cronjob, web | km-agent-core, gbrain, obsidian-markdown, obsidian-cli, obsidian-bases, json-canvas, gstack-for-hermes | gbrain | none |
| `builder` | `builder:task` | terminal, file, browser, web, gbrain, session_search, skills, todo | builder-core, gstack-for-hermes, test-driven-development, systematic-debugging, github-pr-workflow, requesting-code-review, codebase-inspection | gbrain | none |
| `reviewer` | `reviewer:gate` | terminal, file, web, gbrain, session_search, skills | reviewer-core, requesting-code-review, github-code-review, systematic-debugging, gstack-for-hermes, gbrain, codebase-inspection | gbrain | none |
| `qa` | `qa:smoke` | browser, terminal, file, vision, gbrain, session_search, skills, web | qa-core, browser-harness-power-use, dogfood, gstack-for-hermes | gbrain | none |
| `researcher` | `researcher:quick` | gbrain, web, browser, terminal, file, vision, session_search, skills, todo | researcher-core, gbrain, autoresearch, browser-harness-power-use, gstack-for-hermes, researcher-quick, researcher-autoresearch, arxiv, youtube-content, polymarket | gbrain | none |
| `ops-watch` | `ops:health` | terminal, cronjob, file, gbrain, skills, session_search, web | ops-watch-core, gbrain, hermes-agent, systematic-debugging, webhook-subscriptions | gbrain | none |
| `maintainer` | `maintainer:check` | terminal, file, web, browser, gbrain, session_search, skills | maintainer-core, github-repo-management, github-pr-workflow, github-issues, github-code-review, gbrain, gstack-for-hermes, hermes-agent | gbrain | none |
| `strategist` | `strategist:review` | gbrain, web, session_search, file, skills, todo, clarify | strategist-core, gstack-for-hermes, gbrain, writing-plans, polymarket | gbrain | none |
| `inbox-triage` | `inbox:triage` | gbrain, web, file, session_search, todo, skills, terminal | inbox-triage-core, gbrain, obsidian-markdown, gstack-for-hermes, defuddle, youtube-content | gbrain | none |

## Operating rules

Expand Down
Loading