Status Values & Enums
All accepted enum values across the Animus system. These values are case-insensitive on input and kebab-case on output unless otherwise noted.
Normalized Subject Status
Used by: animus subject list --status, animus subject status, animus subject update --status
| Value | Aliases | Description |
|---|---|---|
backlog | todo | Task is in the backlog, not yet ready for work |
ready | Task is ready to be picked up | |
in-progress | in_progress, inprogress | Task is actively being worked on |
blocked | Task is blocked by a dependency or issue | |
on-hold | on_hold, onhold | Task is paused/held |
done | completed | Task is complete |
cancelled | Task has been cancelled |
Serialization: kebab-case (e.g., "in-progress", "on-hold")
Groupings:
- Active:
in-progress - Terminal:
done,cancelled - Blocked:
blocked,on-hold
Subject Priority Buckets
Used by: animus subject create --priority, animus subject update --priority
| Value | Description |
|---|---|
p0 | Highest priority |
p1 | High priority |
p2 | Normal priority |
p3 | Lower priority |
Serialization: lowercase (e.g., "p1")
Requirement Priority (MoSCoW)
Used internally by the built-in requirements domain model and requirement-linked workflows.
| Value | Description |
|---|---|
must | Must have (non-negotiable) |
should | Should have (important but not critical) |
could | Could have (nice to have) |
wont | Won't have (explicitly excluded) |
Serialization: lowercase (e.g., "must", "should")
Default: should
Requirement Status
Used internally by the built-in requirements domain model and requirement-linked workflows.
| Value | Description |
|---|---|
draft | Initial state, requirement is being drafted |
refined | Requirement has been refined with details and criteria |
planned | Requirement is planned for implementation |
in-progress | Requirement is being implemented (alias: in_progress) |
done | Requirement is fully implemented |
po-review | Awaiting product owner review |
em-review | Awaiting engineering manager review |
needs-rework | Sent back for rework after review |
approved | Approved through review process |
implemented | Implementation complete and verified |
deprecated | No longer relevant |
Serialization: kebab-case (e.g., "in-progress", "po-review", "needs-rework")
Default: draft
Workflow Phase Decision Verdict
Used in: PhaseDecision.verdict, on_verdict routing in workflow YAML
| Value | Description |
|---|---|
advance | Phase succeeded; proceed to next phase or on_verdict target |
rework | Phase needs rework; route back to the specified target phase |
skip | Phase should be skipped; jump to the specified target |
fail | Phase failed fatally; terminate workflow or route to error handler |
Serialization: lowercase (e.g., "advance", "rework")
Unknown verdict values are deserialized as a catch-all Unknown variant.
Workflow Phase Status
Used in: WorkflowPhaseExecution.status
| Value | Description |
|---|---|
pending | Phase has not started |
ready | Phase is ready to execute |
running | Phase is currently executing |
success | Phase completed successfully |
failed | Phase failed |
skipped | Phase was skipped |
Serialization: snake_case (e.g., "pending", "success")
Merge Strategy
Used in: post_success.merge.strategy in workflow YAML
| Value | Description |
|---|---|
merge | Standard git merge (default) |
squash | Squash merge into a single commit |
rebase | Rebase onto target branch |
Serialization: lowercase
Default: merge
Batch on_error Policy
Used by: animus.workflow.run-multiple
| Value | Description |
|---|---|
continue | Process all items regardless of individual failures |
stop | Stop after the first failure; remaining items are marked skipped |
Agent Action
Used by: animus agent control --action, animus.agent.control
| Value | Description |
|---|---|
pause | Pause the running agent |
resume | Resume a paused agent |
terminate | Terminate the agent |
See also: Workflow YAML Schema, Configuration, Exit Codes.