Skip to content

Ground meta-orchestration subagents, remove fabricated metrics (#300) - #308

Merged
necatiozmen merged 2 commits into
mainfrom
fix/knowledge-synthesizer-grounding
Aug 12, 2026
Merged

necatiozmen merged 2 commits into
mainfrom
fix/knowledge-synthesizer-grounding

Conversation

@necatiozmen

Copy link
Copy Markdown
Member

Summary

Addresses #300, which points out that the meta-orchestration agents read as walls of buzzwords with metrics and capabilities their tools cannot back up. The critique is largely fair, so this reworks the whole 09-meta-orchestration category to be honest about what a Claude Code subagent with Read, Write, Edit, Glob, Grep can actually do.

All 8 files shared the identical ~286-line template. For each one:

  • Removed fabricated metrics — the numeric-target checklists (Pattern accuracy > 85%, Retrieval time < 100ms, 100% guarantees), the progress/status JSON blobs with invented counts ("patterns_identified": 342, "recovery_rate": "93%"), and the "Delivery notification" brag sentences (improving system performance by 23%, Knowledge graph contains 50k+ entities). These were pure hallucination bait — nothing computes them.
  • Cut technique/buzzword blocks the tools cannot execute (federated/reinforcement learning, live knowledge graphs, message buses, sub-second monitoring pipelines). Each agent is reframed honestly as planning and documenting, not running a live runtime.
  • Replaced the circular "Communication Protocol" JSON (which assumed a non-existent orchestration bus) with honest coordination: ordinary subagents passing context through shared files and the invoking orchestrator, plus explicit tool-scope and grounding rules (cite path:line evidence, don't invent numbers, flag uncertainty).
  • Preserved frontmatter (name/tools/model) and the sibling-agent cross-references.

Impact

File Before After
knowledge-synthesizer 287 86
agent-organizer 286 82
context-manager 286 94
error-coordinator 286 101
multi-agent-coordinator 286 66
performance-monitor 286 94
task-distributor 286 85
workflow-orchestrator 286 86

Net: +419 / −2021 lines across the category.

Changes

  • Rewrote all 8 agent definitions in categories/09-meta-orchestration/
  • Bumped voltagent-meta 1.0.3 → 1.0.4 (plugin.json + marketplace.json) per the version-bump CI gate

Test plan

  • No residual fabricated-metric / progress-JSON / delivery-brag patterns in any of the 8 files
  • Frontmatter (name/tools/model) unchanged per file
  • Sibling-agent cross-references preserved (no dangling references)
  • Version-bump CI gate simulated locally — passes (single meta bump covers all category .md changes; marketplace in sync)

🤖 Generated with Claude Code

necatiozmen and others added 2 commits August 12, 2026 13:50
Rewrites the knowledge-synthesizer definition to match what its tools
(Read, Write, Edit, Glob, Grep) can actually do, addressing issue #300:

- Removes fabricated metrics ("Pattern accuracy > 85%", "50k+ entities",
  "improving performance by 23%") the model would otherwise hallucinate
  into its output.
- Drops technique blocks the tools cannot execute (federated/reinforcement
  learning, knowledge-graph building, anomaly/causation inference).
- Replaces the circular "Communication Protocol" JSON (which assumed a
  non-existent message bus) with an evidence-cited output schema and an
  honest note that coordination happens through shared files.
- Adds hard grounding rules: every pattern must cite path:line evidence
  and appear in >=2 sources; no invented counts.

Bumps voltagent-meta 1.0.3 -> 1.0.4 (plugin.json + marketplace.json) to
satisfy the version-bump CI gate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Applies the same cleanup as knowledge-synthesizer to the rest of the
category, all of which shared the identical keyword-stuffed template:

  agent-organizer, context-manager, error-coordinator,
  multi-agent-coordinator, performance-monitor, task-distributor,
  workflow-orchestrator

For each file:
- Removed fabricated metrics — the numeric-target checklists
  (">95%", "<100ms", "100%"), the progress/status JSON blobs with
  invented counts, and the "Delivery notification" brag sentences the
  model would otherwise hallucinate into its output.
- Cut technique/buzzword blocks the tools (Read, Write, Edit, Glob,
  Grep) cannot execute; reframed each agent honestly as planning and
  documenting rather than running a live runtime.
- Replaced the circular "Communication Protocol" JSON (which assumed a
  non-existent message bus) with honest file-and-orchestrator
  coordination and explicit tool-scope/grounding rules.
- Preserved frontmatter (name/tools/model) and the sibling-agent
  cross-references.

Each file dropped from ~286 lines to ~66-101. No version bump needed
beyond the 1.0.4 already applied for knowledge-synthesizer, since all
changes are within the voltagent-meta category.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@necatiozmen
necatiozmen merged commit c9e51ec into main Aug 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant