nexus/.planning/milestones/v1.4-REQUIREMENTS.md
Nexus Dev 8ae8e526d9 chore: complete v1.4 Hermes Default Provider milestone
3 phases, 6 plans, 16 requirements. Archives copied to milestones/.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-04 03:55:49 +00:00

2.8 KiB

Requirements Archive: v1.4 Hermes Default Provider

Archived: 2026-04-02 Status: SHIPPED

For current requirements, see .planning/REQUIREMENTS.md.


Requirements — Milestone v1.4: Hermes Default Provider

Hermes Integration (7)

  • HERM-01 — Hermes adapter is installed, enabled, and appears in the "Add Agent" dropdown
  • HERM-02 — User can create a Hermes agent with config options (model selection, tool permissions)
  • HERM-03 — Heartbeat execution spawns hermes chat -q, processes task, returns result
  • HERM-04 — Session persistence works across heartbeats via --resume flag
  • HERM-05 — Nexus-managed skills are visible alongside Hermes native skills in agent config
  • HERM-06 — Cost tracking captures token usage and model costs for Hermes agents
  • HERM-07 — Dashboard shows Hermes-specific info (model name, memory usage, native skill count)

Ollama Integration (5)

  • OLLA-01 — Nexus detects whether Ollama is installed locally
  • OLLA-02 — User can see a list of available Ollama models when configuring a Hermes agent
  • OLLA-03 — User can configure a Hermes agent with any local Ollama model
  • OLLA-04 — Model recommendation based on RAM/VRAM from a shipped catalog
  • OLLA-05 — If Ollama is not present, user is offered installation instructions

Default Provider Logic (4)

  • DFLT-01 — If no cloud provider (Claude Code, etc.) is detected, Hermes + Ollama is offered as default during onboarding
  • DFLT-02 — Default agent templates (PM, Engineer, Generalist) work correctly with Hermes runtime
  • DFLT-03 — GSD workflow functions correctly with Hermes as the agent runtime
  • DFLT-04 — Fresh install with only Hermes + Ollama works end-to-end (no paid subscription or API key required)

Future Requirements

None deferred — all PRD items included in this milestone.

Out of Scope

  • Multi-provider model routing (Hermes can use OpenRouter/Anthropic/OpenAI but that's Hermes config, not Nexus)
  • Hermes MCP server management (Hermes handles its own MCP connections)
  • Custom Hermes skill authoring UI (skills are file-based, not GUI-managed)

Traceability

Requirement Phase Status
HERM-01 Phase 27 Complete
HERM-02 Phase 27 Complete
HERM-03 Phase 27 Complete
HERM-04 Phase 27 Complete
HERM-05 Phase 28 Complete
HERM-06 Phase 28 Complete
HERM-07 Phase 28 Complete
OLLA-01 Phase 28 Complete
OLLA-02 Phase 28 Complete
OLLA-03 Phase 28 Complete
OLLA-04 Phase 28 Complete
OLLA-05 Phase 28 Complete
DFLT-01 Phase 29 Complete
DFLT-02 Phase 29 Complete
DFLT-03 Phase 29 Complete
DFLT-04 Phase 29 Complete