agent-workflow

# Agent Workflow A structured workflow engine for OpenClaw agents. Migrated and generalized from the [superpowers](https://github.com/anthropics/claude-code-superpowers) workflow system into a code-agnostic, general-purpose workflow plugin. ## What it does Provides a persistent state machine that guides your agent through a complete work lifecycle: ``` brainstorming → writing-plans → [execute] → verification → finishing-work ↓ subagent-driven-execution OR executing-plans ``` With support for: - **Persistent state** — workflow survives session restarts - **Multi-project** — run multiple workflows concurrently - **Branching** — choose execution strategy at branch points - **Context-plugins** — fork into review/parallel-agents without leaving main flow - **Soft-guard goto** — jump to any step with warnings about skipped prerequisites - **11 bundled Skills** — covering the full workflow lifecycle ## Installation This is a **Plugin**, not a plain Skill. Install via: ```bash openclaw plugins install clawhub:agent-workflow openclaw gateway restart ``` Then enable in your `~/.openclaw/openclaw.json`: ```json { "plugins": { "allow": ["agent-workflow"] }, "tools": { "allow": ["agent_workflow"] } } ``` ## Usage In your agent (via Feishu, Discord, or any channel): ``` Start a new workflow for my Q2 planning project ``` The agent will call `agent_workflow` with `action: "start"` and guide you through the workflow. ## Tool: `agent_workflow` | Action | Description | |--------|-------------| | `start` | Begin a new workflow | | `status` | View current state (all active workflows if no ID given) | | `next` | Advance to the next step | | `goto` | Jump to any node (soft-guard warns about skipped steps) | | `complete` | Mark current node done | | `fork` | Activate a context-plugin without leaving main flow | | `join` | Complete a fork and return | | `getSkill` | Load full SKILL.md for the current node | | `list` | List all workflows | | `abandon` | Abandon a workflow | ## Bundled Skills - `brainstorming` — Turn ideas into specs - `writing-plans` — Break specs into tasks - `executing-plans` — Sequential execution - `subagent-driven-execution` — Parallel subagent execution - `verification-before-completion` — Evidence before claims - `finishing-work` — Delivery options - `dispatching-parallel-agents` — Fork independent tasks - `requesting-review` — Dispatch reviewer subagent - `receiving-review` — Evaluate feedback rigorously - `systematic-problem-solving` — Root-cause diagnosis - `writing-skills` — Create/improve Skills