Workbench Hermes Docs Sync

Core Rule

When To Use

• skill additions, renames, removals, or registry-facing skill-map changes;
• public README, docs map, agent roster, issue-template, autopilot, or install instruction changes;
• Super.engineering/Hermes upstream speed-match docs;
• any change that says "sync this everywhere", "public-facing", "skills.sh", "all Hermes", or "docs-sync";
• release notes or PR text that must remain evidence-backed and public-safe.

Public Surface Sweep

• README.md

  : install count, public overview, docs map, runtime model, Chinese overview when relevant.

• AGENTS.md

  : read order, operating rules, file map, validation command list.

• SYNTHESIS.md

  : current strategy when the change alters operating model.

• DECISIONS.md

  : durable rationale for behavior-changing workflow changes.

• skills/README.md

  : registry-facing skill list and install instructions.

• skills/*/SKILL.md

  : affected skill contracts and cross-skill references.

• docs/*.md

  : lane docs, public contracts, public-safe evidence boundaries.

• agents/**/*.md

  : Hermes, Claude, Codex, remote, or reviewer role bindings.

• issue-templates/

  and

  autopilots/

  : reusable entry points affected by the new workflow.

Review Loop

1. Read the Claude-authored diff first.
2. Identify the behavior or public promise that changed.
3. Sweep the public surfaces above using file search and direct reads.
4. Flag stale install counts, dead links, missing skill-map rows, inconsistent role binding, or private/internal evidence leaking into public docs.
5. Recommend the smallest patch set.
6. Return a verdict. Do not silently mutate live Multica/Hermes runtime config.

git diff --name-only
git diff --check
rg -n "skill-name|lane-name|Hermes|Claude Code|skills.sh|install" README.md AGENTS.md SYNTHESIS.md DECISIONS.md docs skills agents issue-templates autopilots

Verdict Contract

HERMES_DOCS_SYNC_REVIEW
source_author: Claude Code | other
changed_behavior:
public_surfaces_checked:
required_patches:
no_change_needed:
public_safety:
installability:
verification:
residual_risk:
VERDICT: PASS | FLAG | BLOCK

PASS

FLAG

BLOCK

Common Failure Modes

• Only updating

  skills/README.md

  and forgetting README install count.
• Adding a workflow doc without a decision record.
• Adding a skill but not binding it to the Hermes role that should use it.
• Treating Discord/terminal screenshots as public proof.
• Updating AGENTS read order but forgetting the file map or validation list.
• Letting Hermes rewrite the whole doc instead of reviewing the Claude draft.