Handbook

Hermes Integration

Hermes is an external agent workcell, not an embedded dependency of Lenses, Fleet, or LCDL.

Updated

Positioning

Hermes is an external agent workcell, not an embedded dependency of Lenses, Fleet, or LCDL.

Hermes owns:

  • adaptive operator behavior,
  • memory,
  • reusable skills,
  • MCP tool orchestration,
  • workflow learning.

Hermes does not own:

  • canonical governance,
  • approval authority,
  • direct execution boundary,
  • evidence system of record.

Recommended Hermes topology

How Hermes reaches Forge visibility, governed tasks, and bounded jobs through MCP without owning governance or execution.

  1. Hermes processExternal agent workcell that orchestrates adaptive skills and MCP tools.
  2. MCP: forge_lenses_mcpWorkspace inspection and agent-run proposals via read-oriented Lenses tools.
  3. MCP: forge_lcdl_mcpGoverned decomposition, verification, and failure reduction for LLM tasks.
  4. MCP: forge_fleet_mcpHealth checks and read-only job template inspection on Fleet.
  5. optional filesystem/git MCPOptional local repo and filesystem access outside the Forge MCP surface.

MVP tool exposure

Start read/proposal only:

  • lenses.workspace_state
  • lenses.project_summary
  • lenses.create_agent_run
  • lenses.create_evidence_packet
  • lcdl.decompose
  • lcdl.verify
  • lcdl.reduce_failure
  • fleet.health
  • fleet.list_templates
  • fleet.get_job

Add fleet.submit_template_job only after approval gating is implemented.

Skill pack

Canonical Hermes skills live in hermes/skills/ in this repo and can be synced to ~/.hermes/skills/.