workflow-state

Manage persistent workflow state across sessions and checkpoints.

33|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/lvlup-sw/exarchos --skill workflow-state-lvlup-sw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-state
Source: https://github.com/lvlup-sw/exarchos/tree/main/skills-src/workflow-state
Command: npx skills add https://github.com/lvlup-sw/exarchos --skill workflow-state-lvlup-sw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manage durable workflow state outside the agent context so progress, tasks, and artifacts persist across sessions and context compaction, preventing lost work and broken orchestrations.

Core Features & Use Cases

  • Persistent Checkpoints: Save and restore workflow phase, tasks, worktrees, PR URLs, and synthesis metadata to resume work after interruptions.
  • Guarded Phase Transitions: Perform atomic updates and guarded phase moves (init, set, get, cancel, cleanup) via MCP to enforce workflow invariants.
  • Reconciliation & Validation: Reconcile state with git and materialized views to detect desyncs and verify merges before completing workflows.
  • Use Case: Save state before a long-running agent session, resume after summarization with exact phase and task context, and safely advance through plan → delegate → review cycles with guard enforcement.

Quick Start

Use the workflow-state skill to checkpoint the current feature workflow and save artifacts so you can resume later with exact phase and task context.

Frequently Asked Questions about workflow-state

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist agent workflow state across context compaction or session interruptions?

To persist agent workflow state across context compaction, you can checkpoint workflow phase, tasks, and artifacts externally. This ensures progress survives context summarization and allows resuming with exact phase context later.

What is a guarded phase transition in workflow orchestration?

A guarded phase transition is an atomic state update that enforces workflow invariants during orchestration. It validates state before moving between phases via MCP actions, ensuring safe progression through plan, delegate, and review cycles.

How do I reconcile workflow state with git and materialized views?

To reconcile workflow state with git and materialized views, run validation checks that detect desyncs between persisted state and the actual repository. This verifies merges and confirms alignment before completing workflows.

Can I use MCP tools to initialize and cancel feature workflows?

Yes, you can use MCP tools to initialize and cancel feature workflows. The system satisfies MCP tool requirements for exarchos_workflow actions including init, get, set, cancel, and cleanup to control feature, debug, and refactor workflows.

When should I checkpoint workflow state outside the agent context?

You should checkpoint workflow state outside the agent context before long-running sessions or when saving artifacts. This prevents lost work and broken orchestrations by storing phase, tasks, worktrees, and PR URLs durably for later resumption.