state

Manage state.md updates and orchestrate playbook operations.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/M2AI-jp/thanks4claudecode-fresh --skill state
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: state
Source: https://github.com/M2AI-jp/thanks4claudecode-fresh/tree/main/.claude/skills/state
Command: npx skills add https://github.com/M2AI-jp/thanks4claudecode-fresh --skill state

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill centralizes management of workspace knowledge (state.md) and playbook operation, enabling reliable tracking of progress, planned milestones, and criteria for completion.

Core Features & Use Cases

  • Playbook state & progress: Track the currently active playbook, milestone, and phase.
  • Done-criteria & CRITIQUE: Validate completion evidence and critique results before marking as done.
  • Context-sensitive guidance: Enforce update rules and branch protection to prevent unauthorized changes.

Quick Start

Initiate a new project task by creating a plan/playbook skeleton, then update state.md with active playbooks and goals.

Frequently Asked Questions about state

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

FAQPage Schema
How do I track project progress and milestones in a workspace?

Track project progress by maintaining a state.md file that records the active playbook, current milestone, and phase. Update it as you move through planning, execution, and verification stages, capturing completion evidence and criteria met at each transition.

What's the best way to manage workflow state and validate task completion?

Manage workflow state by defining done_criteria upfront, then updating state.md with evidence as work progresses. Use CRITIQUE execution to validate results against criteria before marking tasks complete, ensuring quality gates across playbook phases.

How do I set up and orchestrate playbook operations for project planning?

Create a playbook skeleton with phases and milestones, then use the state management system to track transitions between them. Enforce required structures and timestamps to guide progress from plan creation through execution to final verification.

Can I enforce rules and prevent unauthorized changes to project state?

Yes. The system enforces branch protection and update rules on state.md, requiring proper structure, timestamps, and phase progression. This prevents unauthorized modifications while ensuring audit trails and review readiness.

What happens if completion criteria aren't met before marking a task done?

The CRITIQUE execution validates evidence against done_criteria before allowing state transitions. If criteria aren't satisfied, the task remains open, preventing premature progression and maintaining quality checkpoints across planning, execution, and verification phases.