save-workflow-state

Persist conductor workflow state to JSON in .claude/state/conductor.json.

7|3|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/BerryKuipers/claude-code-toolkit --skill save-workflow-state
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: save-workflow-state
Source: https://github.com/BerryKuipers/claude-code-toolkit/tree/main/.claude/skills/state-management/save-workflow-state
Command: npx skills add https://github.com/BerryKuipers/claude-code-toolkit --skill save-workflow-state

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, date.

What problem does it solve?

Long-running workflows can be interrupted by various factors, leading to lost progress and duplicated effort. This Skill persists the current state of a conductor workflow to enable smart resumption across sessions.

Core Features & Use Cases

  • Persistent State Storage: Creates a dedicated state directory and saves a comprehensive JSON state object (.claude/state/conductor.json).
  • Detailed Context Capture: Tracks current phase, completed phases, issue context, branch information, PR number, audit score, architecture plan, and implementation notes.
  • Workflow Recovery: Enables the workflow to pick up exactly where it left off, preventing redundant work and ensuring continuity.
  • Use Case: After completing each major phase of a conductor workflow (e.g., Issue Discovery, Implementation, Quality Assurance, PR Creation), use this Skill to save the current progress, making the workflow resilient to interruptions.

Quick Start

Save workflow state after Phase 1 completion

save-workflow-state 137 "Add user dark mode preference toggle" 1 "feature/issue-137-dark-mode" null null "VSA compliant, no violations found"

This will create or update the .claude/state/conductor.json file with the current workflow state.

Frequently Asked Questions about save-workflow-state

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

FAQPage Schema
How do I save workflow progress to prevent losing work between sessions?

Save workflow state by persisting conductor workflow progress to a JSON file (.claude/state/conductor.json). This captures issue metadata, current phase, branch information, and context, enabling you to resume exactly where you left off after interruptions.

What information does workflow state persistence capture?

Workflow state persistence tracks issue number and title, current and completed phases, branch name, files changed, commit count, PR number, architecture plan, and implementation notes. All data is stored as JSON for validation and recovery.

Can I use workflow state saving across all phases of development?

Yes, state persistence applies across all six phases—Issue Discovery, Branch Setup, Implementation, Quality Assurance, PR Creation, and Final Report. Save state after completing each phase to enable smart resumption and prevent duplicate work.

What happens if my conductor workflow gets interrupted mid-phase?

When interrupted, your saved workflow state allows recovery without redundant work. The state file stores complete context so the workflow can pick up exactly where it stopped, maintaining continuity across restarts.

Do I need special setup to store workflow state?

No special setup required—the Skill creates the state directory (.claude/state) and manages JSON storage automatically. It uses only standard tools (jq for JSON processing, date for timestamps) already available in most environments.

How does workflow state differ from manual checkpointing?

Automated workflow state persistence captures comprehensive context—phases, branch details, audit scores, and implementation notes—in a standardized JSON format. This enables deterministic resumption and prevents the gaps that manual checkpointing leaves.