Skill: Workflow State (DEPRECATED)

⚠️ DEPRECATED: This skill has been superseded by the consolidated workflow tracking approach.

Use instead: skills/workflow/workflow-tracking/

State files now live in .ai-dev-team/workflow/active/{workflow-name}/state.json instead of .ai-dev-team/workflow-state/.

---

Migration Guide

Old Approach (Deprecated)

.ai-dev-team/
└── workflow-state/
    ├── PROJECT-123.json    # Per-story state
    ├── PROJECT-124.json
    └── PROJECT-125.json

New Approach (Use This)

workflow/
└── active/
    └── development-EPIC-45/
        ├── workflow.md         # Workflow manifest
        ├── state.json          # Consolidated state (replaces per-story files)
        ├── stories/            # Story details
        │   ├── PROJECT-123.md
        │   └── PROJECT-124.md
        └── decisions.md        # Decision log

---

What Changed

Aspect	Old	New
Location	.ai-dev-team/workflow-state/	.ai-dev-team/workflow/active/{name}/state.json
Scope	Per-story	Per-workflow (may contain multiple stories)
Related files	Scattered (context/, .ai-dev-team/)	Consolidated in workflow folder
Story details	Separate context/stories/*.md	.ai-dev-team/workflow/active/{name}/stories/*.md
Cleanup	Manual	Automatic via archival skill

---

Key Benefits of New Approach

1. Single source of truth - All workflow state in one folder
2. Simpler agent updates - Agents only update .ai-dev-team/workflow/active/{name}/
3. Automatic archival - Archival skill handles cleanup and context updates
4. Better visibility - Workflow folder in project root, not hidden

---

State Schema (Still Valid)

The state.json schema is largely the same. See skills/workflow/workflow-tracking/SKILL.md for the current schema.

Key additions in new approach:

• workflow_id - Workflow folder name
• workflow_type - Type of workflow (development, sprint-planning, etc.)

---

See Also

• skills/workflow/workflow-tracking/SKILL.md - Current workflow tracking approach
• skills/workflow/workflow-archival/SKILL.md - Archival and context updates

---

Historical Reference

The content below is preserved for reference. Do not use this approach for new workflows.

<details> <summary>Original Documentation (Archived)</summary>

Original Purpose

This skill enabled persistent workflow state tracking for individual stories. Each story had its own state file that tracked current position, gate history, and completed steps.

Original State File Location

.ai-dev-team/
└── workflow-state/
    ├── PROJECT-123.json
    ├── PROJECT-124.json
    └── PROJECT-125.json

Original Schema

See state-schema.json for the JSON schema (still applicable to new state.json format).

</details>