Issue Station
Sign In
Tools hereToolbox

hermes - ✅(Solved) Fix docs: architecture page omits the Kanban subsystem [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#28601•Fetched 2026-05-20 04:03:14
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Author
marklights54-bytemarklights54-byte
Participants
marklights54-bytemarklights54-byte
Timeline (top)
labeled ×3cross-referenced ×1

Fix Action

Fixed

PR fix notes

PR #28615: docs(architecture): add Kanban subsystem section

Description (problem / solution / changelog)

Summary

Add the Kanban subsystem to the developer-guide architecture page, which was the only major subsystem missing from the overview.

Changes:

  1. Directory tree — Added 7 kanban source files under hermes_cli/, kanban_tools.py under tools/, and plugins/kanban/ at the top level
  2. Data flow diagram — New "Kanban Multi-Agent" section showing the decompose → db → tools → diagnostics → swarm → dashboard pipeline
  3. Subsystem description — Paragraph covering Kanban's role as the multi-agent task board, its module layout, and the 8 canonical collaboration patterns
  4. System Overview diagram — Added Kanban Board box alongside existing Prompt/Provider/Tool boxes
  5. Cross-link — Link to the existing Kanban user guide at /docs/user-guide/features/kanban

Why: Kanban accounts for ~12K LOC across 7 modules plus a plugin and bundled skills. It is the fourth major coordination subsystem (alongside gateway, cron, and ACP) and deserves the same architectural treatment so contributors and operators can navigate the code.

Fixes #28601

Changed files

  • website/docs/developer-guide/architecture.md (modified, +30/-2)
RAW_BUFFERClick to expand / collapse

The developer-guide/architecture page has no mention of the Kanban subsystem, despite it being a substantial part of the codebase and central to multi-agent workflows introduced in v0.13/v0.14.

Evidence of the gap:

  • hermes_cli/kanban_db.py — 247 KB (one of the largest single files in the repo)
  • hermes_cli/kanban.py — 104 KB (TUI surface)
  • hermes_cli/kanban_swarm.py, kanban_decompose.py, kanban_diagnostics.py, kanban_specify.py — supporting CLI modules
  • plugins/kanban/ — bundled React dashboard plugin
  • Bundled skills: kanban-worker, kanban-orchestrator
  • Dedicated user-guide page already exists: /docs/user-guide/features/kanban
  • Eight canonical multi-agent collaboration patterns are built around it

Suggested fix: Add a short section (paragraph + the directory map entries above + link to the user-guide page) under the architecture overview. Could fit naturally alongside the existing gateway/cron/ACP-adapter descriptions, since Kanban is the fourth major coordination subsystem.

For comparison, the architecture page does cover gateway internals, cron scheduler, ACP adapter, and the plugin model — Kanban is comparable in scope and warrants the same treatment so contributors and operators can navigate the code.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#vector store#embedding generation#cache error#pipeline error#runtime error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - ✅(Solved) Fix docs: architecture page omits the Kanban subsystem [1 pull requests, 1 participants]