hermes-workspace/docs/hermes-workspace-naming-contract.md

Hermes Workspace Naming Contract

This repo is for Hermes Workspace and Hermes Agent work.

Canonical product names

Use these names in all new UI, docs, skills, prompts, tests, review comments, and handoffs:

• Hermes Workspace
• Hermes Agent
• Swarm
• Hermes Kanban
• HERMES_HOME
• ~/.hermes

Forbidden new references

Do not introduce these in new work unless quoting legacy history or compatibility behavior:

• Hermes Workspace
• Hermes Agent
• Claude swarm
• Claude-native paths
• HERMES_HOME
• ~/.hermes

Legacy compatibility rule

If older code, docs, tests, or handoffs contain Claude-era wording, treat it as legacy residue.

Default action:

• normalize it to Claude naming
• preserve old wording only when explicitly documenting migration or backwards compatibility

Runtime/path rules

For Claude-native runtime work, prefer:

• HERMES_HOME
• ~/.hermes/profiles/<workerId>
• claude
• Hermes worker sessions

Do not suggest Claude-specific runtime wrappers or profile paths for live Hermes Workspace behavior.

Swarm/UI language rules

Prefer:

• Ready not person-specific hardcoded labels
• Board / Cards / List for reports views
• Hermes Workspace and Hermes Agent in update/config/status UI

Avoid:

• person-specific product labels baked into UI
• Claude-branded wording in Hermes Workspace surfaces

Reviewer rule

Any PR or patch that introduces new Claude-branded naming into Hermes Workspace should be treated as a regression unless it is:

• a legacy compatibility note
• a migration guide
• a quoted historical artifact

Agent instruction rule

When an agent is working in this repo:

• assume Claude naming is canonical
• rewrite Claude-era references to Claude by default
• do not invent Claude-branded paths, products, or wrapper guidance
• if uncertain, prefer repo-native Claude terminology over historical aliases