Architecture

Architecture

This section is the source of truth for runtime behavior across kobi-ai, kobi-agent-service, and kobi-mcp-server.

Runtime Rules (Current)

• Browser calls BFF for inference and canvas APIs.
• BFF calls engine with internal contract headers.
• Engine executes workflow and dispatches tools via MCP.
• MCP applies tool-level validation and persists side effects.

Architecture Topics

System Design

• Cross-System Status
• System Overview
• Repository and Codebase Map
• Data Models and Ownership
• Thread and State Lifecycle
• Ownership Boundary
• Runtime Flow Diagrams
• MCP Execution Model

Integration Contract

• API and Event Contracts
• Hybrid Canvas API Calls

Security and Governance

• Identity, Access, and Data Isolation
• Architecture Guardrails

Operations

• Operations Runbook