Skip to content

feat(prompt): broaden Hermes self-knowledge pointer to docs + skill - #38538

Merged
teknium1 merged 1 commit into
mainfrom
hermes/hermes-9ffe5e61
Jun 4, 2026
Merged

feat(prompt): broaden Hermes self-knowledge pointer to docs + skill#38538
teknium1 merged 1 commit into
mainfrom
hermes/hermes-9ffe5e61

Conversation

@teknium1

@teknium1 teknium1 commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Every Hermes agent now treats the docs site as a standing source of self-knowledge — not just a reactive lookup when the user explicitly asks about config.

HERMES_AGENT_HELP_GUIDANCE (added in #16535, Apr 27) only fired "if the user asks about configuring, setting up, or using Hermes Agent itself." This broadens it: the agent treats https://hermes-agent.nousresearch.com/docs as its authoritative, always-latest reference for any Hermes-related help and for understanding its own features/tools, points to the hermes-agent skill for additional guidance/workflows, and treats the docs as the source of truth when the two differ.

Changes

  • agent/prompt_builder.py: rewrite the HERMES_AGENT_HELP_GUIDANCE constant. Wider trigger (help/extend/troubleshoot + self-understanding, not just config), docs framed as authoritative + latest, skill kept as secondary guidance.

Cache safety

Static constant in the stable tier (system_prompt.py:102, appended unconditionally for every agent). No runtime metadata, no per-turn mutation — upholds the system-prompt HARD INVARIANT, zero prompt-cache impact.

Validation

E2E via a real offline AIAgent (build_system_prompt_parts, dummy key/url, no network):

Check Result
Docs URL in stable tier PASS
"authoritative reference" framing PASS
"most up-to-date" latest framing PASS
skill_view(name='hermes-agent') pointer PASS
"source of truth when the two differ" PASS

Infographic

ui-wireframe

The HERMES_AGENT_HELP_GUIDANCE block (added #16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

🔎 Lint report: hermes/hermes-9ffe5e61 vs origin/main

ruff

Total: 0 on HEAD, 0 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 0 pre-existing issues carried over.

ty (type checker)

Total: 9744 on HEAD, 9744 on base (➖ 0)

🆕 New issues: none

✅ Fixed issues: none

Unchanged: 5047 pre-existing issues carried over.

Diagnostics are surfaced as warnings — this check never fails the build.

@alt-glitch alt-glitch added type/feature New feature or request comp/agent Core agent runtime: loop, agent_init, prompt builder, context-compression, responses endpoint P3 Low — cosmetic, nice to have labels Jun 3, 2026
@teknium1
teknium1 merged commit f99665f into main Jun 4, 2026
23 checks passed
@teknium1
teknium1 deleted the hermes/hermes-9ffe5e61 branch June 4, 2026 00:01
Yuki-14544869 pushed a commit to Yuki-14544869/hermes-agent that referenced this pull request Jun 4, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
davidgut1982 pushed a commit to davidgut1982/hermes-agent that referenced this pull request Jun 5, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
changman pushed a commit to changman/hermes-agent that referenced this pull request Jun 10, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
alt-glitch pushed a commit that referenced this pull request Jun 14, 2026
…38538)

The HERMES_AGENT_HELP_GUIDANCE block (added #16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
kossteg pushed a commit to kossteg/hermes-agent that referenced this pull request Jun 16, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
T02200059 pushed a commit to T02200059/hermes-agent that referenced this pull request Jun 18, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
xyshanren pushed a commit to xyshanren/hermes-agent-cn that referenced this pull request Jun 25, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
waefrebeorn pushed a commit to waefrebeorn/slermes that referenced this pull request Jul 2, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
santhreal pushed a commit to santhreal/hermes-agent that referenced this pull request Jul 13, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
donbowman pushed a commit to donbowman/hermes-agent that referenced this pull request Jul 13, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
Gravezzz pushed a commit to Gravezzz/hermes-agent that referenced this pull request Jul 21, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
leewenjie pushed a commit to leewenjie/hermes-agent that referenced this pull request Aug 7, 2026
…ousResearch#38538)

The HERMES_AGENT_HELP_GUIDANCE block (added NousResearch#16535) only fired when the
user explicitly asked about configuring/setting up Hermes. Broaden it so
the agent treats the docs as a standing source of self-knowledge for any
Hermes-related help and for understanding its own features/tools, points
to the hermes-agent skill for additional guidance, and treats the docs as
the authoritative/latest source of truth when the two differ.

Static constant in the cache-safe stable tier — no prompt-cache impact.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/agent Core agent runtime: loop, agent_init, prompt builder, context-compression, responses endpoint P3 Low — cosmetic, nice to have type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants