Enums & Statuses

Every actor and operational entity in matic carries a status that drives routing, staffing, dispatch, and governance decisions. This section enumerates those status values — plus the other controlled vocabularies (collab modes, signal types, scope, risk class) that appear across schemas, frontmatter, and the CLI. Use it as the authoritative list when authoring policies, reading audit trails, or writing code that reasons about entity state.

Agent Status

Lifecycle states for an agent — spawned, onboarding, available, engaged, learning, assessment, idle, suspended, decommissioned — with the allowed transitions between them. Read more

Team Status

Team lifecycle states — forming, briefed, active, blocked, releasing, disbanded — and what each implies for dispatch and staffing. Read more

Project Status

Project lifecycle states — proposed, chartered, staffed, active, on-hold, completing, archived — aligned to the chartering and completion workflow. Read more

Work Item & Run Status

Terminal and in-flight states for the executable layer: Work Item (queued, running, blocked, complete, failed, retrying) and Run (pending, running, complete, failed, cancelled). Read more

Signal Types

The canonical signal taxonomy — channel messages, webhooks, routine emissions, scheduled events, and agent messages — and how each is dispatched. Read more

Collab Modes

Named coordination modes — pair, review, async, briefing, shadow, delegate, consult — that govern how multiple actors share a work item. Read more

Scope & Risk Class

The four operational scopes (org, project, team, agent) and the risk classes (budget, technical, dependency, governance, model, external) used by the Risk Registry and Guardrails. Read more