state-management

Consolidate project workflow state into FLOW.md and ITEM-XXX.md Markdown files.

4|1|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/DoubleslashSE/claude-marketplace --skill state-management-doubleslashse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: state-management
Source: https://github.com/DoubleslashSE/claude-marketplace/tree/main/Plugins/flow-workflow/skills/state-management
Command: npx skills add https://github.com/DoubleslashSE/claude-marketplace --skill state-management-doubleslashse

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill consolidates project workflow state into two Markdown patterns: FLOW.md for backlog and project context, and ITEM-XXX.md for per-item state.

Core Features & Use Cases

  • Minimal Footprint: Two file patterns replace 9+ files and reduce maintenance.
  • Checkpoint & Resume: Enable resumption from interruptions via per-item checkpoints.
  • Human-Readable State: State stored in plain Markdown for easy hand-editing and auditing.
  • Context Budget Awareness: Track and report context usage across items.

Quick Start

Starting a new state-managed project with a single FLOW.md and per-item ITEM-XXX.md.

Frequently Asked Questions about state-management

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

FAQPage Schema
How do I track project backlog and workflow state in plain Markdown?

Track project backlog and workflow state in Markdown by consolidating context into a FLOW.md file and individual item records into ITEM-XXX.md files. This pattern replaces multiple tracking files with two human-readable patterns for easy auditing.

What is the best way to resume interrupted work using checkpoint files?

Resume interrupted work by using per-item checkpoint files. The state-management approach captures automatic checkpoints within ITEM-XXX.md files, enabling reliable resumption of multi-item workflows from the exact phase of interruption.

Can I hand-edit project workflow state without breaking automated tracking?

Yes, you can hand-edit project workflow state safely. State is stored entirely in plain Markdown formats like FLOW.md, ensuring human-readable state that supports easy manual editing, auditing, and direct review without breaking the structure.

How do I initialize a new state-managed workflow for a multi-item project?

Initialize a state-managed workflow by creating a single FLOW.md file for project context and backlog tracking, then generate individual ITEM-XXX.md files for each item. This supports initialization, item creation, and phase transitions across the workflow.

Does this Markdown workflow state approach work for tracking context usage across items?

Yes, this Markdown workflow state approach tracks context usage. It includes context budget awareness features that monitor and report context usage across items, helping teams coordinate multi-item workflows within defined limits.

When should I use a single FLOW.md file instead of multiple tracking documents?

Use a single FLOW.md file when you need a minimal footprint for backlog tracking. This pattern replaces nine or more separate files, reducing maintenance overhead while providing checkpoint-based resume and per-item decision history.