he-workflow

Orchestrates multi-phase workflows by updating WORKFLOW_STATE.md and coordinating transitions in .heracles projects.

Updated Jul 23, 2025
One-click install
npx skills add https://github.com/data-players/Marker-OCR-API --skill he-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: he-workflow
Source: https://github.com/data-players/Marker-OCR-API/tree/main/.heracles/agents/skills/he-workflow
Command: npx skills add https://github.com/data-players/Marker-OCR-API --skill he-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill acts as the control center for multi-phase workflows, managing session data, workflow state, phase transitions, and finalization actions.

Core Features & Use Cases

  • Manage sessions stored under .heracles/sessions/ to track ongoing work.
  • Read, write, and update the workflow state (WORKFLOW_STATE.md) as actions progress through init, spec, dev, test, review, and finalize.
  • Trigger system actions and support templates for consistency across projects.
  • Real-world use: coordinate a new project from setup through final deployment with auditable state changes and rollback points.

Quick Start

Initialize a new workflow session and write the initial WORKFLOW_STATE.md to start tracking progress.

Frequently Asked Questions about he-workflow

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

FAQPage Schema
How do I track multi-phase workflow state transitions across project sessions?

Multi-phase workflow state transitions are tracked by orchestrating sessions and updating a WORKFLOW_STATE.md file, allowing you to monitor progression through phases like init, spec, dev, test, review, and finalize with persistent state logs.

What is the best way to automate phase progression and finalization tasks in a multi-phase project?

Automating phase progression and finalization tasks is handled by coordinating workflow transitions with guardrails for prerequisites, ensuring that each phase like dev or test meets specific criteria before advancing to finalize.

Can I use templates to initialize workflow state for consistency across multiple projects?

Yes, you can use templates to initialize workflow state, generating a consistent WORKFLOW_STATE.md file across multiple projects to ensure uniform session tracking and standardized phase progression right from setup.

How does session state management work for ongoing project workflows?

Session state management works by storing ongoing work data under dedicated session directories, reading and writing updates to the workflow state file as actions progress, and logging changes to maintain an auditable history.

Do I need a specific project context to manage workflow state and phase transitions?

Yes, workflow state and phase transitions require a specific project context managed within a dedicated directory structure, ensuring that session data, state persistence, and finalization actions are properly scoped and tracked.

Why are workflow state transitions failing despite meeting phase requirements?

Workflow state transitions fail when prerequisite guardrails are not fully satisfied, preventing the progression from phases like dev or test to finalize until all required state persistence and change logging actions are completed.