state-management

Read, write, and validate the .spec2cloud/state.json file for phase and increment tracking.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/EmeaAppGbb/spec2cloud-microhack-greenfield --skill state-management-emeaappgbb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: state-management
Source: https://github.com/EmeaAppGbb/spec2cloud-microhack-greenfield/tree/main/.github/skills/state-management
Command: npx skills add https://github.com/EmeaAppGbb/spec2cloud-microhack-greenfield --skill state-management-emeaappgbb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill manages the project state across different phases and increments, ensuring the ability to resume and track progress in the spec2cloud development framework.

Core Features & Use Cases

  • State Management: Read, write, and validate the .spec2cloud/state.json file for tracking the project's current phase and increment.
  • State Schema Definition: Defines the schema for the state file, including the protocol for reading and writing state.
  • Resume Logic: Re-validates the state and continues from where the last iteration left off.
  • Use Case: When a project encounters an error or requires manual intervention, this Skill allows the orchestrator to resume the workflow from the last known good state.

Quick Start

Start the state management Skill to read and validate the current state before proceeding with the development workflow.

Frequently Asked Questions about state-management

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

FAQPage Schema
How do I resume a workflow after an error requires manual intervention?

To resume a workflow after a manual intervention, this Skill re-validates the project state and continues the development iteration from the last known good position recorded in the state file.

What is the best way to track project phase and increment progress in spec2cloud?

Tracking phase and increment progress in spec2cloud requires reading and validating the state.json file, which defines the schema for storing the project's current development position.

Do I need a specific file format for state validation in resumable workflows?

Yes, state validation in resumable workflows requires the .spec2cloud/state.json file, which must adhere to the defined state schema protocol for reading and writing project data.

How does state management handle error recovery during development phases?

State management handles error recovery by validating the existing state schema and resuming the orchestrator workflow from the exact increment where the previous iteration failed.

When should I start the state management process for a spec2cloud project?

You should start the state management process to read and validate the current state before proceeding with any subsequent steps in the spec2cloud development workflow.

Can I use custom schemas for state tracking instead of the default state.json?

No, resumable workflows require strict adherence to the predefined state.json schema, which enforces the specific protocol for reading, writing, and validating project phase data.