harness-wip-control

Decomposes broad requests into atomic tasks with one active work item at a time.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-wip-control-maicongambini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-wip-control
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/harness-wip-control
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-wip-control-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Broad requests like "add X" or "refactor Y" often lead to scope creep, half-finished changes, and lost context. This Skill enforces a WIP=1 (work-in-progress limit of one) discipline so only a single atomic task is active at any moment, with everything else explicitly deferred. ## Core Features & Use Cases - Request Decomposition: Restates the broad request, lists all implied sub-tasks, and orders them by dependency before any code is written. - WIP=1 Contract: Marks exactly one task as in_progress in feature_list.json; newly discovered work is recorded as not_started instead of being started immediately. - Observable Acceptance Criteria: Requires runnable commands as acceptance criteria and explicit non-goals for the session. - Use Case: When asked to "improve the API layer", the Skill produces a dependency-ordered task list, activates only the first atomic unit, and records the rest as pending with clear exclusions. ## Quick Start Ask the agent to decompose your broad feature request into atomic tasks and start only the first one using the WIP control workflow.

Frequently Asked Questions about harness-wip-control

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

FAQPage Schema
How do I break a large feature request into smaller tasks?

Restate the request exactly as received, list all implied sub-tasks, and order them by dependency. Then mark exactly one task as in_progress in feature_list.json and define runnable acceptance criteria for it before writing any code.

What is WIP=1 in task management for coding agents?

WIP=1 means only one work item is in progress at any time. All other tasks stay marked as not_started, and work discovered mid-execution is added to the backlog rather than started immediately.

When should I decompose a request before coding?

Decompose before any multi-step request such as adding a feature, refactoring a module, or improving a system, and before opening any file to edit. This prevents scope creep and keeps each session focused on one atomic unit.

What happens when new work is discovered during execution?

Newly discovered work is added to feature_list.json as not_started and is not started in the current session. If the active task expands in scope, execution stops and the request is redecomposed with approval before continuing.

What are the limitations of a WIP=1 workflow?

WIP=1 serializes work, so parallelizable tasks are completed sequentially rather than concurrently. It is less suitable when independent changes must ship together or when a single session must deliver multiple unrelated fixes.