1---2name: hermes-workspace-23description: Use when laying out or cleaning the file workspace shared by a Hermes Agent chief and its managers - inbox, dated dossiers (README / received pieces / internal work / deliverables), clients, admin areas, knowledge, automation, archives and a to-delete area awaiting approval, a mirrored private space, scripts kept apart from documents, scratch outside the workspace, file naming, the end-of-task checklist and a weekly cleanup job that only asks before deleting. Not for context-file resolution rules (hermes-core) or sandboxing (hermes-security).4metadata:5 source: https://skillmd.com/skills/fusengine/hermes-workspace-26---78<objective>9One filing logic for the chief and every agent, written once in the shared10`.hermes.md`: where each kind of document goes, how files are named, where11scripts and temporary files live (never among documents), what every agent12ticks before closing a task, and a weekly cleanup that tidies what is safe13and asks before deleting anything.14</objective>1516# Hermes Workspace1718## Freshness check1920Before writing or changing any Hermes config, run `hermes --version` and21`hermes update --check`, then read22https://github.com/NousResearch/hermes-agent/releases/latest. If the installed23or latest version is newer than 0.23.0, read every release note since 0.23.024("Upgrade notes" first) and adjust. Never apply guidance from this skill to a25newer version without that check.2627## Hermes facts this skill relies on2829| Fact | Consequence | Owner skill |30|------|-------------|-------------|31| `.hermes.md` is found by walking from the working directory up to the git root | Put the filing rules in `.hermes.md` at each workspace root; make that root the git root (or the cwd) of every agent | hermes-core |32| Cron jobs load project context only with `--workdir` | Every workspace job (cleanup, rituals) passes `--workdir <root>` | hermes-cron |33| `terminal.cwd` per profile | Set each profile's cwd inside its own root | hermes-core |34| Kanban `scratch` workspaces are deleted on task completion; `dir:<abs path>` is preserved | Use `dir:` for dossier work, keep temporary files in scratch | hermes-delegation |35| No native "write only here" policy | Containers / `HERMES_WRITE_SAFE_ROOT` + checklist | hermes-security |3637## Decision map3839| Question | Load |40|----------|------|41| Which folder for what, synced chief root, nested `.hermes.md`, company vs private, transition symlinks | [layout.md](references/layout.md) |42| Knowledge base (`SCHEMA.md`, `index.md`, `log.md`) | [templates/knowledge-schema.md](references/templates/knowledge-schema.md) |43| File names, scripts, temporary files | [naming-scripts-scratch.md](references/naming-scripts-scratch.md) |44| End-of-task checklist, weekly cleanup, who keeps order | [checklists.md](references/checklists.md) |45| Filing block for `.hermes.md` (+ company outbound email block) | [templates/hermes-md-filing.md](references/templates/hermes-md-filing.md) |46| Dossier README | [templates/dossier-readme.md](references/templates/dossier-readme.md) |47| Weekly cleanup cron job | [templates/cleanup-job.md](references/templates/cleanup-job.md) |4849## Critical rules50511. **Documents and scripts never mix.** The workspace holds documents; each52 script has its own folder with a README, outside the document roots.532. **Scratch lives outside the workspace** and is disposable.543. **Received pieces are never modified**; work happens in `travail/`55 (internal notes) and `livrables/` (deliverables).564. **Nothing is deleted by an agent.** Candidates go to the to-delete area;57 the owner approves deletion.585. **Doubt about private vs company → ask the chief**, never create a new59 top-level folder.606. **Same rules for every agent**: full reference in the chief root's61 `.hermes.md`, the applicable part repeated in each root's `.hermes.md`.627. **A synced workspace is the owner's view**: no secrets, no scratch, one63 final version per deliverable.648. **Old paths stay as transition symlinks**; nothing new is created under65 them.6667## Sources6869- https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files70- https://hermes-agent.nousresearch.com/docs/user-guide/features/cron (`--workdir`)71- https://hermes-agent.nousresearch.com/docs/user-guide/features/kanban (workspace kinds)72- https://hermes-agent.nousresearch.com/docs/user-guide/configuration (`terminal.cwd`)73- https://hermes-agent.nousresearch.com/docs/user-guide/security (file write safety)