flow-engine

Manage state transitions and event logging for multi-step AI development workflows.

2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/dd-xiaozhi/dev-agent-flow --skill flow-engine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flow-engine
Source: https://github.com/dd-xiaozhi/dev-agent-flow/tree/main/.claude/skills/flow-engine
Command: npx skills add https://github.com/dd-xiaozhi/dev-agent-flow --skill flow-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of managing complex, multi-step AI development workflows by providing a robust state machine that tracks progress, maintains event logs, and ensures task consistency across the entire development lifecycle.

Core Features & Use Cases

  • Workflow State Management: Automatically tracks current steps, next steps, and phase transitions for various development flows like TAPD integration or local bug fixes.
  • Event Bus Integration: Maintains a persistent, append-only event log for every task, enabling auditability and cross-agent communication.
  • Use Case: When a developer starts a new story, this engine initializes the workflow template, locks the version hash, and ensures that every subsequent agent action is validated against the defined process, preventing skipped steps or rule violations.

Quick Start

Use the flow-engine skill to initialize a new development flow for the current story by running the flow_advance init command with the appropriate flow ID.

Frequently Asked Questions about flow-engine

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

FAQPage Schema
How do I track state transitions for multi-step AI development workflows?

You can track state transitions for multi-step AI development workflows by using a state machine that operates within task-specific JSON stores to validate step completion and maintain audit trails. The engine logs every agent action into an append-only event log.

How does a state machine ensure deterministic process execution for automated agents?

A state machine ensures deterministic process execution by locking workflow template version hashes and validating every subsequent agent action against the defined process. This mechanism prevents skipped steps and rule violations during automated task orchestration.

What is the best way to maintain an audit trail for inter-agent event synchronization?

The best way to maintain an audit trail for inter-agent event synchronization is to use a persistent, append-only event log for every task. This records all state transitions and enables cross-agent communication throughout the development lifecycle.

How do I initialize a new workflow template for a development story?

To initialize a new workflow template for a development story, run the flow_advance init command with the appropriate flow ID. The engine will lock the version hash and prepare the state machine to track subsequent phase transitions.

Can I use task-specific JSON stores to validate step completion in automated workflows?

Yes, you can use task-specific JSON stores to validate step completion in automated workflows. The state machine operates within this context to track progress, validate transitions, and ensure task consistency across the entire development lifecycle.

When do I need workflow orchestration with state-machine precision for AI tasks?

You need workflow orchestration with state-machine precision for AI tasks when managing complex, multi-step development flows that require strict progress tracking, event logging, and task consistency. This prevents skipped steps and rule violations across automated agents.