workbench-work-items

Work item management for Workbench CLI. Use when creating, updating, linking, or closing work items and tracking execution status.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The workbench-work-items Claude skill is a specialized tool designed for seamless work item management within the Workbench CLI. It streamlines the software development lifecycle by enabling users to create, track, and link tasks directly to technical documentation like ADRs and specifications, ensuring high traceability and organized project execution.

Use Cases

  • Task Lifecycle Management: Efficiently create, prioritize, and assign development tasks (e.g., features, bugs) using CLI commands to maintain project momentum.
  • Technical Documentation Linking: Automatically associate work items with Architecture Decision Records (ADRs), product specs, and Pull Requests to ensure every code change is well-documented.
  • Workflow Automation & Status Tracking: Update task statuses from 'draft' to 'done' with integrated notes, while automatically moving files between active and completed directories.
  • Audit Trail & Reporting: Maintain a reliable history of project progress by tracking execution status and linking external artifacts, keeping stakeholders informed and boards accurate.
nameworkbench-work-items
descriptionWork item management for Workbench CLI. Use when creating, updating, linking, or closing work items and tracking execution status.

Key settings

  • .workbench/config.json: paths.itemsDir, paths.doneDir, ids.width, prefixes, git.branchPattern.
  • Status values: draft, ready, in-progress, blocked, done, dropped.

Core workflows

  1. Ensure planning artifacts exist (specs, ADRs, architecture docs) before major work.
  2. Create a work item and set its initial status.
  3. Link related specs, ADRs, files, PRs, or issues.
  4. Update status and close work items when done.

Commands

Create a task:

workbench item new --type task --title "Do the thing" --status draft --priority medium --owner platform

Update status:

workbench item status TASK-0001 in-progress --note "started implementation"

Close and move to done:

workbench item close TASK-0001 --move

Link docs or PRs:

workbench item link TASK-0001 --spec /docs/10-product/spec.md --adr /docs/40-decisions/ADR-YYYY-MM-DD-title.md --pr https://github.com/org/repo/pull/1

Output

  • Work items in docs/70-work/items (active) and docs/70-work/done (closed).
  • Linked docs and external artifacts tracked in front matter.

Guardrails

  • Use a work item for every meaningful change and link the supporting docs.
  • Keep status accurate so reports and boards stay reliable.
  • If a decision happens during work, update/create the ADR and link it.