Concepts

This section explains the core ideas behind Animus. Each page covers one architectural concept in depth.

Pages

• How Animus Works -- Core architecture, the three-layer model, and the big picture.
• Workflows -- Everything is a workflow: pack-qualified workflows, and project-local YAML.
• Subject Dispatch -- The universal work envelope that drives all execution.
• The Daemon -- The dumb scheduler: tick loop, capacity, and execution facts.
• Agents and Phases -- AI personas, phase execution, rework loops, and phase guards.
• MCP Integration -- How agents use MCP tools to observe and mutate state.
• State Management -- The split between project-local .animus/ config and repo-scoped runtime state.
• Worktree Isolation -- Built-in tasks get isolated git worktrees; plugin-owned tasks can run directly from the project root.