work-item git:20260831.856ee57A

Immutable. This exact content is served forever at /api/v1/blob/79c16b141a87dfe2.

---
name: work-item
description: WHAT - Router for creating and refining epics, user stories, tasks, bugs, and incidents using
  Best Practices work item hierarchy.
origin:
  type: first-party
---
# Work Item Router (WHAT)

Use this skill when the user asks to create, refine, or evaluate work items.

## Default guardrails

1. Apply **`output-handshake`** before producing final content or writing to a tool.
2. Use the smallest applicable skill:
   - Epic -> `epic`
   - User story -> `user-story`
   - Technical task -> `task`
   - Bug -> `bug`
   - Incident -> `incident`
3. Use **`planning`** when the item needs breakdown, estimation, prioritization, or capacity checks.
4. Use **`clickup-cli`** for ClickUp writes only after user approval.

## Hierarchy

Epic -> Story/Task/Bug -> Subtasks. Not every methodology uses every level; follow the engagement pack and ticket system.

## References

- `references/default-template.md`
- `references/example-routing-dashboard.md` — example routing decision classifying a feature request as user story