state-sync

Synchronize task state changes to .claude/workflow-state.json across workflow phases.

2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/yutna/vibe-next-template --skill state-sync-yutna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: state-sync
Source: https://github.com/yutna/vibe-next-template/tree/main/.claude/skills/state-sync
Command: npx skills add https://github.com/yutna/vibe-next-template --skill state-sync-yutna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps workflow state current across phases by automatically updating state when the task changes phase, new files are touched, a gate result changes, or a blocker appears.

Core Features & Use Cases

  • Automatic state synchronization on phase transitions, file touches, and gate outcomes
  • Clear, explicit state fields (phase, requirements status, plan status, delivery readiness) to prevent stale data
  • Reference: CLAUDE.md (workflow contract) and workflow state stored at .claude/workflow-state.json

Quick Start

Update the state file immediately after any phase change, new file touches, or blocker appears to keep the workflow state accurate.

Frequently Asked Questions about state-sync

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

FAQPage Schema
How do I keep workflow state synchronized across project phases?

Workflow state synchronization automatically updates phase, requirements status, plan status, and delivery readiness fields in a central state file whenever task transitions or file touches occur.

What is workflow state synchronization and when do I need it?

Workflow state synchronization prevents stale data by enforcing explicit, testable validation on state fields during planning, implementation, and delivery. You need it when managing complex phase transitions and blockers.

How to update workflow state after a gate result or blocker appears?

Update the central workflow state file immediately after any gate outcome changes, new files are touched, or a blocker appears to maintain accurate phase and status tracking across the project.

Does state synchronization work without external dependencies?

Yes, state synchronization operates without external dependencies by reading and writing directly to the .claude/workflow-state.json file to enforce consistent state validation.

What's the best way to track task blockers and phase transitions consistently?

Tracking task blockers and phase transitions consistently requires applying explicit state fields like implementation.status and delivery.status to a central state file, preventing stale data during delivery.

Why does my workflow state file contain stale phase data after file updates?

Workflow state files contain stale phase data when state changes are not explicitly synchronized after file touches or gate results, requiring automatic updates to maintain consistency.