Agent Stack Architecture — Six Layers of grainworks

Mon, 29 Jun 2026 06:00:00 -0400

A 1-page visual architecture of everything we’ve built — organized into six layers from the reasoning core to the user-facing delivery surface. Every component lives in exactly one layer with defined data flow between them.

View the architecture diagram →

The Six Layers

Layer 1 — Orchestration

The brains. Hermes Agent routes, reasons, and delegates. The Organizational Orchestrator (V2.4/2.5) classifies intent and routes to 19 domain subagents. The skill system (60+ skills) and MCP gateway keep the reasoning at the center.

Organizational Orchestrator — Multi-Agent Routing System

Mon, 29 Jun 2026 06:00:00 -0400

An advanced master orchestrator for routing, delegating, and verifying tasks across organizational domains. Started as a keyword-matching router (V2.2) and evolved toward LLM-based intent classification (V2.5). Uses Hermes Agent’s delegate_task API under the hood for subagent execution.

Architecture

┌──────────────────────────────────────────────┐
│ OrganizationalOrchestrator │
│ Intent Classification → Routing → Delegation │
├──────────────────────────────────────────────┤
│ Specialists (19 domains): │
│ Strategy | Finance | HR | Legal | Data │
│ IT/Security | Procurement | Citizen Svcs │
│ Auditor | Emergency | Urban Planner | Health│
│ Education | Social Services | Comms | Ops │
│ Facilities | Research | Innovation │
└──────────────────────────────────────────────┘

Each specialist has:

Grainworks on grainworks

Agent Stack Architecture — Six Layers of grainworks

The Six Layers

Layer 1 — Orchestration

Organizational Orchestrator — Multi-Agent Routing System

Architecture