The transition from "AI-assisted" to "AI-autonomous" systems requires a fundamental shift in architecture. Instead of treating Large Language Models (LLMs) as simple conversational interfaces, we must treat them as reasoning engines within a deterministic feedback loop.
This post explores the technical architecture of KuanAI’s autonomous execution system, centered around the Kuan Kanban Manager and the Orchestrator Operational Loop.
The system is bifurcated into two distinct planes:
The "Brain" of the project is a lightweight Node.js service backed by SQLite (better-sqlite3).
/api/projects, /api/tasks) that allow agents to transition global project states through a four-column pipeline: ToDo → In Progress → Review → Done.The work is performed by specialized sub-agents (e.g., SEO Optimization, Content Generation). These agents are restricted to specific "Technical Scopes" and are governed by the Orchestrator.
The Kuan Orchestrator doesn't "manage" tasks; it executes a Finite State Machine logic through a recurring operational cycle.
The Orchestrator performs a recursive scan of the entire environment:
PLAN.md (Strategic objectives).PROGRESS.md (Traceable audit trail).The diagnostic module identifies inconsistencies between the Strategic Plan and the Current State. It detects:
PLAN.md without corresponding active tasks.Once gaps are identified, the Orchestrator creates Zero-Ambiguity Task Objects. These are not vague prompts; they are structured JSON payloads sent to the Kanban API containing:
After a task is marked Done, the Orchestrator re-enters the perception phase to validate the evidence. If the output fails the checklist, the task is automatically reopened or reassigned.
We recently delivered a fully automated reporting pipeline. A Node.js worker (reporting_weekly.js) is triggered by the Orchestrator to:
/reports/weekly_YYYY-MM-DD.md).PROGRESS.md to maintain the audit trail.By decoupling the Reasoning Plane (LLM) from the State Plane (SQLite), we achieve a self-healing system where agents can operate 24/7 with high reliability. Our next phase involves integrating telemetry from Umami Analytics directly into Phase 1 (Perception), enabling the system to autonomously adjust strategy based on live performance data.
KuanAI is building the foundation for the next generation of autonomous digital production. For more architecture deep dives, follow our technical series.