workflow-kit

workflow-kit

A full product lifecycle plugin for Claude Code, Codex CLI, OpenCode, and Gemini CLI.

Define your product's Vision, Mission, and Core → generate a structured workplan → execute with mandatory domain-expert reviewer agents → synthesize deliverables → maintain.

The product can be anything: a webapp, a research paper, a library, an API, an article, a dataset. The workflow adapts automatically.

---

Philosophy

Everything needs a reviewer. No task is complete until a domain-expert reviewer agent has validated the output. The worker builds; the reviewer validates. These are separate agent processes — the reviewer is mandatory infrastructure, not optional.

The product defines the workflow. A webapp needs a code-reviewer and a devops reviewer. A research paper needs a researcher reviewer. An article needs an editor. workflow-kit detects your product type from your Vision and creates the right reviewer profiles automatically.

User is always the admin. Agents execute; you decide. You approve transitions between phases. Feedback at synthesis creates sub-tasks that loop back through execution — you never lose control of direction.

---

Lifecycle

┌─────────┐    ┌──────┐    ┌─────────┐    ┌───────────┐    ┌──────────┐
│  DEFINE  │───▶│ PLAN │───▶│ EXECUTE │───▶│ SYNTHESIZE│───▶│ MAINTAIN │
└─────────┘    └──────┘    └─────────┘    └───────────┘    └──────────┘
  Vision +            Objectives     Agent+Reviewer     Package +       Scheduled
  Mission +           + Tasks        pairs per task     User review     jobs
  Core +                                  ▲                  │
  System audit                            └──────────────────┘
                                          feedback loop

State tracked in workflow/state.yaml. Each phase requires user approval to advance.

---

New in v0.3: Tier 1 Features

Cross-provider reviewer

Use a different LLM provider for reviews than for worker tasks — eliminates sycophancy bias when a model reviews its own output.

# workflow.yaml
reviewers:
  - endpoint: "https://api.anthropic.com/v1/messages"
    api_key: "${ANTHROPIC_API_KEY}"
    model: "claude-haiku-4-5-20251001"

Per-task override: add a "reviewer" field to any task JSON in workflow/tasks/pending/<id>.json to use a different reviewer for that specific task:

{
  "task_id": "feat-007",
  "reviewer": {
    "endpoint": "https://api.openai.com/v1/chat/completions",
    "api_key": "${OPENAI_API_KEY}",
    "model": "gpt-4o"
  }
}

Checkpoint & Resume

If the dispatcher crashes mid-task (power loss, OOM, Ctrl+C), workflow-kit recovers automatically on next startup. File snapshots are written before each task begins and deleted when the task completes.

# Auto-detected on every startup. If dispatcher crashed mid-task:
python -m workflow_kit start              # automatically recovers + retries interrupted task
python -m workflow_kit start --resume     # same, explicit flag for clarity

Parallel execution

Run multiple tasks concurrently. Tasks that share files are never run in parallel — conflict detection is automatic.

# workflow.yaml
settings:
  max_parallel_tasks: 3  # run up to 3 tasks concurrently (default: 1)

AgentOps metrics

Every completed task records timing, retry count, and reviewer pass/fail to .workflow/metrics.jsonl. View the dashboard via:

/workflow-kit:status   →  shows metrics dashboard

Or from CLI:

python -m workflow_kit status

---

Skills

Skill	Phase	What it does
/workflow-kit:init	define	Guided wizard: Vision/Mission/Core + system audit + LLM setup + reviewer profiles
/workflow-kit:plan	plan	Orchestrator generates objectives + tasks from workflow/product.md
/workflow-kit:execute	execute	Dispatcher runs tasks; spawns reviewer agent after each
/workflow-kit:synthesize	synthesize	Packages output by product type; presents to user; handles feedback loop
/workflow-kit:maintain	maintain	Creates and runs scheduled maintenance jobs
/workflow-kit:status	any	Inline phase + dispatcher + task counts + reviewer results
/workflow-kit:monitor	any	Live TUI or web dashboard

---

Installation

Claude Code

# Step 1: add the marketplace (one time only)
claude plugin marketplace add Le-Xuan-Thang/workflow-kit

# Step 2: install the plugin
claude plugin install workflow-kit

Restart Claude Code. Skills available as /workflow-kit:init, /workflow-kit:plan, etc.

Codex CLI

# Step 1: add the marketplace
codex plugin marketplace add Le-Xuan-Thang/workflow-kit

# Step 2: install the plugin
codex plugin add workflow-kit@Le-Xuan-Thang