[continuing #19101] AGENTS.md gaps round 2: missing auxiliary config, unverified --now flag, stale PR refs, more

[pty819]

AGENTS.md Stale Content — Round 2 (Issues 9–16)

Following up on #19101. These 8 additional gaps were identified but not included in that issue.

---

9. auxiliary Config Section Completely Undocumented

Location: hermes_cli/config.py DEFAULT_CONFIG

AGENTS.md "Adding Configuration" section (lines 297–342) covers:

• model, agent, terminal, compression, display, stt, tts
• memory, security, delegation, smart_model_routing, checkpoints

Missing: The auxiliary top-level section with:

• auxiliary.vision — vision model config
• auxiliary.curator — curator task config (provider, model, base_url, timeout)
• auxiliary.embedding — embedding model config
• auxiliary.max_tokens — max tokens for auxiliary tasks
• auxiliary.reasoning_effort — reasoning effort for auxiliary tasks

Also missing: honcho: {} section in DEFAULT_CONFIG (empty but present).

Priority: Medium

---

10. Skill --now Flag Unverified

Location: AGENTS.md lines 532–535

"Slash commands that mutate system-prompt state … must be cache-aware: default to deferred invalidation … with an opt-in --now flag for immediate invalidation. See /skills install --now for the canonical pattern."

This was stated without verifying that --now actually exists in hermes skills install --help output in v0.12.0. The flag's current existence is unconfirmed.

Priority: Low (verify and either confirm or remove)

---

11. Async Delegation / Persistent Subagent PR References Are Stale

Context: Older AGENTS.md versions referenced two PRs as "in progress, not merged":

• async_delegation (PR feat(async-delegation): non-blocking background agent tools #5587)
• Persistent ACP background subagents (PR feat(delegation): add persistent ACP background subagents #4950)

These PR numbers and their status (merged, closed, or still open) were never verified against current main. The stale references should be removed or replaced with confirmed current-state information.

Priority: Medium

---

12. delegate_task / Cron 3-Minute Interrupt Mechanism Not Documented in AGENTS.md

Location: hermes-agent skill (separate from AGENTS.md), cron/scheduler.py, delegate_tool.py

AGENTS.md mentions cron only as:

cron/ # Scheduler — jobs.py, scheduler.py

The 3-minute hard interrupt mechanism for cron sessions is completely undocumented in AGENTS.md. This is critical for anyone trying to run long-running tasks via cron. Related concepts also missing:

• Catchup windows (half period, clamped 120s–2h)
• Grace windows (120s for one-shot jobs)
• File lock ~/.hermes/cron/.tick.lock preventing duplicate ticks

Priority: High

---

13. Memory Provider List — Hierarchy and Completeness

Location: AGENTS.md lines 463–464

Listed as a flat string: "honcho, mem0, supermemory, byterover, hindsight, holographic, openviking, retaindb"

Issues:

• plugins/memory/openviking/ exists but is not separately listed as a memory provider
• Some providers have nested subdirectories not mentioned
• The distinction between "builtin" memory providers and pip-installed ones is unclear

Priority: Low

---

14. Toolset List Incomplete

Location: AGENTS.md file tree (lines ~22–56) and "Adding New Tools" section

AGENTS.md does not enumerate available toolsets. toolsets.py reveals many undocumented toolsets:

• yuanbao — Tencent Yuanbao platform
• spotify — Spotify playback control
• moa — Mixture of Agents
• rl — Reinforcement learning tools
• kanban — Kanban board tools
• debugging — Debugging toolkit
• safe — Safe toolkit without terminal

Priority: Medium

---

15. Slash Command --now Flag Scope Undocumented

Location: AGENTS.md lines 532–535

"Slash commands that mutate system-prompt state … must be cache-aware: default to deferred invalidation (change takes effect next session), with an opt-in --now flag for immediate invalidation."

Which slash commands actually support --now? The --now flag exists for /skills install but the broader policy (which commands must be cache-aware, which support --now) is not enumerated.

Priority: Low

---

16. Config Loader Coverage — auxiliary and curator sections missing

Location: AGENTS.md lines 324–333

AGENTS.md documents three config loaders but the auxiliary and curator sections are not covered anywhere, compounding issues #9 and #4 from #19101.

Priority: Medium

---

Summary

#	Issue	Priority
9	auxiliary config section undocumented	Medium
10	--now flag unverified	Low
11	Stale PR references (async_delegation #5587, ACP #4950)	Medium
12	3-minute interrupt mechanism undocumented	High
13	Memory provider hierarchy unclear	Low
14	Toolset list incomplete (yuanbao, spotify, moa, rl, kanban…)	Medium
15	--now flag scope undocumented	Low
16	Config loader coverage gaps (auxiliary, curator)	Medium