Decisions

Every consequential choice in a matic org produces an immutable Decision record, whether that choice comes from an agent during planning, a human at a checkpoint, or the system resolving a conflict. Decision records capture what was chosen, who chose it, why it was chosen, and what alternatives were considered. As entity-attached, append-only, queryable records, they provide a durable audit trail for directional choices that complements the event-level detail in audit logs.

This section explains the Decision record format, the workflows that create decisions, and the ways decisions can be queried across an org.

Decision Record Schema

Decision Record Schema explains the frontmatter and body structure of a Decision record, including the entity attachment model, status lifecycle, classification flags, and the Context / Decision / Rationale / Consequences body format.

HITL-Originated Decisions

HITL-Originated Decisions covers how human responses at checkpoints become Decision records, including the dual-write rule with audit entries, permission levels required for each decision class, and escalation behavior when the designated approver is unavailable.

Proposal Review Decisions

Proposal Review Decisions describes the decisions produced when proposals such as project proposals, hypotheses, skill proposals, or policy proposals are approved, rejected, or sent back for revision against the Charter.

Charter Amendment Decisions

Charter Amendment Decisions documents the owner-gated process for amending an org's Charter, including what triggers an amendment, the required permission level, and how the amendment decision propagates to downstream validation.

Conflict Resolutions

Conflict Resolutions explains how matic resolves output conflicts, HITL contradictions, and inter-agent disagreements through a tiered strategy: agent defers to human, conservative output wins, Auto Matic arbitration, then escalation, with every resolution recorded as a Decision.

Scope and Queryability

Scope and Queryability explains how decisions are scoped to orgs, projects, tasks, work items, and agents, and how to query them using the matic decisions CLI with filters for entity, time range, classification flags, and status.