Schema: deterministic agent workflows

[rajanbor]

Goal

Define library/schemas/workflow.schema.json for multi-step procedures agents can execute and resume.

Human contract

Document trigger, preconditions, ordered or parallel steps, inputs/outputs, checkpoints, failure handling, rollback, escalation, completion, and handoff. Include a safe dependency-update workflow.

Machine contract

Represent steps as stable IDs with typed dependencies, tool/profile references, retry limits, and terminal states. Reject cycles unless an explicitly bounded loop is modeled.

Acceptance criteria

• Schema, guide, sequential and parallel examples, and invalid fixtures exist.
• Graph validation catches missing steps, cycles, and unreachable terminals.
• Every mutating step defines failure and recovery behavior.
• Resume semantics are deterministic and documented.
• Humans can execute the example from the Markdown alone.

Depends on document, agent, and tool schemas.