Introduction
Zakardo is an agent-native full-stack application framework for building applications where AI agent behavior is expressed as structured, versioned, validated programs called plans, composed of governed, typed units of execution called capabilities, triggered by user intents.
The Problem Zakardo Solves
Section titled “The Problem Zakardo Solves”Current AI agent frameworks treat agent behavior as an emergent property of prompt engineering and tool calling. This model has fundamental issues:
| Problem | Description |
|---|---|
| No inspectable program | There is no versioned, testable artifact describing what an agent will do before it does it |
| No governance | Side effects are fire-and-forget with no policy layer |
| No learning loop | Successful behavior is not captured as a reusable artifact |
| No auditability | Logs are unstructured and not replayable |
| No composability | Every framework defines its own incompatible tool interface |
| No frontend model | No architecture exists for intent-driven, plan-aware UIs |
Current frameworks ask: How do I give an LLM the ability to call functions?
Zakardo asks: How do I build, govern, validate, and trust the programs that agents execute?
The Execution Loop
Section titled “The Execution Loop”Every Zakardo application runs through the same core loop:
Intent → Planner → Plan Draft → Enrichment → Full Plan IR → Validator → Execution Engine → Trace- Intent — The user expresses a desired outcome in natural language
- Planner — An LLM-powered, policy-aware planner generates a minimal Plan Draft using backward chaining
- Enrichment — A deterministic 8-step pipeline converts the draft into a fully typed Plan IR with schemas, dependency graphs, and metadata
- Validator — 10 structural and policy checks verify the plan is safe to execute
- Execution Engine — A durable state machine runs the plan step-by-step with checkpointing, retry, and governed side effects
- Trace — An immutable, append-only record captures everything for auditing, replay, and learning
Key Concepts
Section titled “Key Concepts”| Concept | What It Is |
|---|---|
| Intent | User request (natural language, packaged action, or structured form) — the entry point |
| Plan | Structured, versioned program of capability invocations with typed data flow |
| Capability | Typed, versioned unit of execution with declared inputs, outputs, effect class, and boundary |
| Effect Class | What a capability does: READ, WRITE_INTERNAL, WRITE_EXTERNAL, DESTRUCTIVE |
| Boundary | Where it executes: LOCAL, REMOTE, USER_ENV |
| Trace | Immutable, replayable record of every execution event |
| Policy / Gate | Governance rules that can pause execution for human approval |
| A2UI | Google’s Agent-to-UI protocol — declarative, streaming frontend rendering |
| Plan Library | Stores and promotes validated plans through a trust lifecycle |
How Zakardo Differs
Section titled “How Zakardo Differs”| Framework | Focus | Zakardo’s Difference |
|---|---|---|
| LangChain / CrewAI | LLM orchestration and tool calling | Zakardo operates at the execution runtime layer beneath LLM reasoning. Plans are inspectable programs, not emergent behavior |
| Temporal / Prefect | Deterministic workflow orchestration | Zakardo plans can be generated dynamically by an LLM planner. Capabilities have governance, effect classes, and trust lifecycles |
| OPA / Cedar | General-purpose policy enforcement | Zakardo’s policy layer is purpose-built for agent execution, using effect class and boundary declarations |
| LangSmith / Arize | LLM call observability | Zakardo traces are structural, replayable execution records that drive regression testing and plan promotion |
Packages
Section titled “Packages”| Package | Purpose |
|---|---|
@zakardo/core | Core runtime — everything from types to the Hono server |
@zakardo/client | Zero-dependency typed TypeScript client SDK (HTTP + SSE) |
@zakardo/studio | Visual dev tool — browser, playground, inspector |
@zakardo/testing | Test utilities — factories, mocks, matchers, test runtime |
Next Steps
Section titled “Next Steps”- Install Zakardo to set up your development environment
- Build your first project with a step-by-step tutorial
- Explore concepts to understand intents, plans, and capabilities in depth