Summary

AGENTS.md (764 lines, last refresh: d42b6a2 on 2026-04-23) at v0.12.0 (HEAD: 5d3be89) contains several stale or missing sections that do not reflect the current codebase. This issue documents 8 confirmed gaps.

Issue 1: Test Suite Numbers Stale (Line ~56)

AGENTS.md says:
~15k tests across ~700 files as of Apr 2026

Actual: 16,820 tests across 893 files

Impact: Numbers understated by ~12% (tests) and ~27% (files).

Issue 2: Tool Auto-Discovery Description Misleading (Lines ~262-290)

AGENTS.md says: auto-discovery means "no manual import list to maintain" and implies that adding registry.register() is sufficient for a tool to be available.

Reality: Two steps are required:

1. registry.register() in tools/*.py (auto-discovered)
2. The tool name must be added to a toolset definition in toolsets.py for it to actually be available

_HERMES_CORE_TOOLS in toolsets.py is still actively used — not dead code. AGENTS.md step 2 ("Add to toolsets.py") is correct but the description of step 1 is misleading about scope.

Issue 3: plugins/ Directory Incomplete (Lines ~43-45, ~487-490)

AGENTS.md lists: memory/, context_engine/, and vague others (Dashboard, image-gen, disk-cleanup, examples)

Actual disk (15 directories):
context_engine/, disk-cleanup/, example-dashboard/, google_meet/, hermes-achievements/, image_gen/, kanban/, memory/, observability/, platforms/, spotify/, strike-freedom-cockpit/, and more

Missing from docs: google_meet, hermes-achievements, kanban, observability, platforms, spotify, strike-freedom-cockpit

Note: plugins/memory/ providers list is accurate (all 8 present).

Issue 4: Curator System Entirely Absent

AGENTS.md (764 lines) has ZERO mention of the curator system.

Actual: curator is a major feature:

• agent/curator.py (1599 lines) + hermes_cli/curator.py (430 lines)

CLI commands: status, run, pause, resume, pin, unpin, restore, backup, rollback

Config schema: enabled, interval_hours, min_idle_hours, stale_after_days, archive_after_days, backup

Not found in code (not implemented): auto_merge, pin_protection, schedule (weekly)

Documentation exists only in: website/docs/user-guide/features/curator.md and RELEASE_v0.12.0.md — it never made it into AGENTS.md.

Issue 5: Cron System Barely Documented (Lines ~52, ~74)

AGENTS.md only says:
cron/ # Scheduler — jobs.py, scheduler.py

Missing from AGENTS.md:

• Schedule format types (duration, every X, cron expression, ISO timestamp)
• CLI subcommands (/cron list/add/edit/pause/resume/run/remove)
• Per-job fields (skills, model/provider overrides, script injection, context_from for job chaining, workdir, multi-platform delivery)
• 3-minute interrupt mechanism, catchup windows, grace windows

Issue 6: delegate_task Documentation Incomplete (Lines ~74, ~114-131)

Missing from AGENTS.md:

• Batch mode: tasks array with configurable concurrency
• Orchestrator role: max_spawn_depth
• All delegation config knobs: max_concurrent_children, child_timeout_seconds, orchestrator_enabled, subagent_auto_approve, inherit_mcp_toolsets
• Clear statement that delegate_task is synchronous (parent waits) — not async
• The async_delegation PR references in older AGENTS.md versions are stale

Issue 7: yuanbao Platform Not Documented

• yuanbao.py and related files exist in gateway/platforms/
• Not mentioned anywhere in AGENTS.md beyond the yuanbao directory existing in the file tree
• qqbot IS mentioned in the file tree (line 39) but yuanbao is not documented

Issue 8: Skill Frontmatter Fields Incomplete (Lines ~513-517)

AGENTS.md lists: name, description, version, platforms, metadata.hermes.tags, metadata.hermes.category, metadata.hermes.config

Missing from docs (all are used in actual skills):

• author
• license
• related_skills
• tags (top-level)
• category (top-level)

Suggested Priority