← ClaudeAtlas

meerkat-architecturelisted

Internal architecture guide for the Meerkat agent platform. This skill should be used when understanding crate ownership, trait contracts, the agent construction pipeline, session service lifecycle, runtime control plane, mob orchestration internals, machine authority, comms wiring, or making cross-cutting architectural changes. Oriented toward AI agents and developers working on meerkat internals, not end users.
lukacf/meerkat · ★ 14 · AI & Automation · score 73
Install: claude install-skill lukacf/meerkat
# Meerkat Internal Architecture Meerkat is a library-first agent runtime. The execution pipeline is shared across all surfaces. Understanding crate ownership, trait contracts, the DSL-authoritative machine system, and the runtime control plane is essential for making changes that don't break architectural invariants. This file is a lean navigator. Load the specific reference under `references/` when working on that domain. ## Core Principles 1. **Infrastructure, not application** — the agent loop is a composable primitive with no opinions about prompts, tools, or output. 2. **Trait contracts own the architecture** — `meerkat-core` defines contracts; implementations live in satellite crates. 3. **Surfaces are skins, not authorities** — CLI, REST, RPC, MCP, WASM route through shared substrate and factory seams, but runtime-backed surfaces own runtime semantics. 4. **Composition over configuration** — optional components are `Option<Arc<dyn Trait>>`, not feature-flagged defaults. 5. **Runtime conforms to catalog-generated machines** — the runtime follows the verified DSL model, not the other way around. Production bridge modules import/invoke catalog-owned DSL bodies; they do not author competing machine semantics. 6. **Mob is the only multi-agent runtime path** — no separate sub-agent substrate. User-facing "delegate"/"sub-agent" flows compile to mob members, often inside session-owned implicit mobs. 7. **Override-first resource injection** — `AgentBuildConfig` overrides ta