# Run Work

Execute a work unit end-to-end: sequence tasks by dependency, implement, test between...

- Repository: https://github.com/hashgraph-online/awesome-codex-plugins (1479 stars)
- Category: Testing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hashgraph-online/awesome-codex-plugins --skill run-work -g -a claude-code -y`
Codex: `npx skills add hashgraph-online/awesome-codex-plugins --skill run-work -g -a codex -y`
Cursor: `npx skills add hashgraph-online/awesome-codex-plugins --skill run-work -g -a cursor -y`
Gemini CLI: `npx skills add hashgraph-online/awesome-codex-plugins --skill run-work -g -a gemini-cli -y`

## Description

Execute a work unit end-to-end: sequence tasks by dependency, implement, test between tasks, commit, and track progress. Use to deliver a complete feature in one session. Invoked as /agiflow:run-work <work-unit>. Uses get_work_unit, list_tasks, update_task, get_work_unit_progress.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

> Invoked as `/agiflow:run-work`. In hosts without slash-prompts, this skill is triggered by matching intent and drives AgiFlow via its MCP tools.

**Usage**:

- `/agiflow:run-work <work-unit-slug-or-id>` - Execute specific work unit
- `/agiflow:run-work` - List and select from available work units

**Examples**:

- `/agiflow:run-work DXX-WU-1` (using slug)
- `/agiflow:run-work 01K8FABMNEJG1XTA9JGHSNFV40` (using ID)
- `/agiflow:run-work` (interactive selection)

---

**Guardrails**

- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
- Keep changes tightly scoped to the requested outcome within the work unit scope.
- A work unit represents a cohesive feature/epic that can be completed in one Claude Code session.

If a work unit slug/id is provided, load it with `get_work_unit`; otherwise list available work units with `list_work_units` for selection.

---

## AgiFlow Project Management Guidelines

Follow the shared AgiFlow project-management guidelines in [`references/agiflow-agents.md`](../../references/agiflow-agents.md), agent assignment, the task status workflow and transitions, work-unit best practices, and the tags strategy apply to this workflow.


---

**Task Status Workflow (per task)**
Each task moves individually through: `Todo → In Progress → Testing → Review`
The work unit stays `in_progress` until all tasks reach `Review` or `Done`.
If any task hits `Blocked`, consider setting the work unit to `blocked` too.

**IMPORTANT: Planning Status Guard**
This skill ONLY executes tasks in "Todo" or later status. Tasks in "Planning" have NOT been groomed and are NOT ready for execution. Use `backlog-grooming` to promote Planning tasks to Todo first.

**Steps**
Track these steps as TODOs and complete them one by one.

## 1. Work Unit Selection & Loading

**If work unit slug/id NOT provided:**

The rest: https://github.com/hashgraph-online/awesome-codex-plugins/blob/HEAD/plugins/AgiFlow/ai-plugin/skills/run-work/SKILL.md