Guides

Practical walkthroughs for day-to-day Animus operations.

Planning and Requirements

Requirements Workflow -- From vision drafting through requirement decomposition into actionable tasks.

Task Management -- Creating, prioritizing, assigning, and tracking tasks through their full lifecycle.
Writing Custom Workflows -- YAML workflow authoring: agents, phases, pipelines, MCP servers, and post-success hooks.
Self-Hosting Workflow -- How Animus tracks its own development through animus commands.

Daemon Operations -- Starting, stopping, pausing, configuring, and monitoring the autonomous daemon.
Operator Runbook -- Production healthchecks, common failure scenarios with remediations, debug procedures, backup/restore, and disaster recovery.
Model Routing -- How Animus selects models and tools per phase, and how to override defaults.
Web Dashboard -- Launching the web UI, navigating boards, and using the REST API.

Working with Animus via MCP Tools -- Complete guide to all 77 built-in MCP tools: JSON examples, common workflows, sequencing tips, pagination, and batch operations.

Plugin Author Guide -- Write providers, subject backends, trigger backends, and transports. Stdio JSON-RPC contract, scaffolding, testing with animus-plugin-testkit, cosign signing, and publishing.
Full System Architecture -- End-to-end architecture across crates, processes, state, daemon, runners, plugins, control surfaces, and verification.
Plugin System Architecture -- Discovery, install state, wire protocol, hosting, security, and runtime plugin paths.

CI/CD -- CI workflows, release pipelines, build commands, and test targets.
Upgrading Animus -- General upgrade procedure, plugin updates, and rollback. Links to per-version migration guides.
Troubleshooting -- Common issues, diagnostics, and fixes.