# Architecture & Design

Complete system architecture and design documentation for VAPORA.

## Core Architecture & Design

- **[VAPORA Architecture](vapora-architecture.md)** — Complete system architecture and design
- **[Agent Registry & Coordination](agent-registry-coordination.md)** — Agent orchestration patterns and NATS integration
- **[Multi-Agent Workflows](multi-agent-workflows.md)** — Workflow execution, approval gates, and parallel coordination
- **[Multi-IA Router](multi-ia-router.md)** — Provider selection, routing rules, and fallback mechanisms
- **[Roles, Permissions & Profiles](roles-permissions-profiles.md)** — Cedar policy engine and RBAC implementation
- **[Task, Agent & Doc Manager](task-agent-doc-manager.md)** — Task orchestration and documentation lifecycle
- **[Schema Validation Pipeline](schema-validation-pipeline.md)** — Runtime validation with Nickel contracts for MCP tools and agent tasks

## Overview

These documents cover:

- Complete system architecture and design decisions
- Multi-agent orchestration and coordination patterns
- Provider routing and selection strategies
- Workflow execution and task management
- Security, RBAC, and policy enforcement
- Learning-based agent selection and cost optimization
- Runtime schema validation with Nickel contracts