id: architecture-one-sheet sidebar_label: Architecture One Sheet title: ValkyrAI Architecture — One Sheet description: High-level architecture overview for ValkyrAI: OAS specs, Applications, Workflows, and Agents. tags: [architecture, overview]
ValkyrAI — Architecture One Sheet
A concise overview of the system architecture: the relationship between OpenAPI specs, Applications, Workflows, and Agents.
Core concepts
- OAS/OpenAPI Spec — the blueprint describing APIs
- Application — a deployable system using specs, workflows, agents
- Agent — autonomous runtime that executes workflows and orchestrates behavior
The flow
- Upload OpenAPI spec → validate and store
- Create Application from spec (or manually)
- Define Workflows and ExecModules for automation
- Agents run Workflows (scheduled or event-driven)
- Apps can be published as MCP services for external consumption
Why it matters
- Specs are first-class artifacts enabling code generation
- Agents provide scale and autonomous orchestration
- Workflows model business processes that scale across applications
See also: OAS Spec Quick Reference