state-management

Read and write project state to .spec2cloud/state.json with validation.

Updated May 6, 2026
One-click install
npx skills add https://github.com/crgarcia12/compy --skill state-management-crgarcia12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: state-management
Source: https://github.com/crgarcia12/compy/tree/main/.github/skills/state-management
Command: npx skills add https://github.com/crgarcia12/compy --skill state-management-crgarcia12

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the management of state across project phases and increments, ensuring consistent and accurate state updates and resume re-validation logic.

Core Features & Use Cases

  • State Reading: Read and parse .spec2cloud/state.json to determine project phase and increment status.
  • State Writing: Update and write state back to .spec2cloud/state.json at the end of each loop iteration.
  • State Schema: Defines the state schema and read/write protocol.
  • Resume Re-validation: Re-validate state and resume project from the last known good state.
  • Use Case: Use when reading project state, updating state after task completion, or resuming from a previous session.

Quick Start

Use the state-management skill to update the state at the end of a loop iteration with the results of the task you just executed.

Frequently Asked Questions about state-management

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

FAQPage Schema
How do I manage project state across multiple development phases?

To manage project state across multiple development phases, you can read and write updates to a state.json file, ensuring consistent state validation and accurate phase tracking throughout your project lifecycle.

How does resume re-validation work when restoring a previous project session?

Resume re-validation works by reading the last known good state from your state.json file and re-validating the project schema, allowing you to accurately resume project execution from the exact increment where the previous session stopped.

Do I need Python to handle JSON state validation for my project?

Yes, you need Python to handle JSON state validation because the state-management process requires Python capabilities to parse, read, and write structured JSON data back into the state.json file accurately.

What is the best way to update project state after a task completion loop?

The best way to update project state after a task completion loop is to write the execution results directly back to your state.json file at the end of each loop iteration, maintaining consistent state schema and phase accuracy.

Why does my project state schema become inconsistent across increments?

Your project state schema becomes inconsistent across increments if state writing does not occur at the end of each loop iteration, but you can fix this by enforcing state validation and resume re-validation logic through your state.json file.

Can I use this state management approach for validating phase status in a JSON file?

Yes, you can use this state management approach for validating phase status because it specifically reads and parses the state.json file to determine project phase and increment status while maintaining schema consistency.