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.