Docs · Work
Create a Work item
A Work item enters Zero from GitHub, Jira (planned), or manually. Every Work item gets a type, a title, a description, and a definition of done.
From a GitHub issue
Click Import in the Zero console. Paste a GitHub issue URL or search by repository. Zero fetches the issue title, body, and labels, then creates a Work item and writes github-context.md into the case memory directory.
- The Work type is inferred from labels where possible (e.g.
buglabel → typebug). - You can edit the type, title, and description before saving.
- The original GitHub issue URL is stored and linked from the Work item.
Create manually
Click New Work in the console. Choose a type, add a title, and write a description that defines what done looks like. Zero accepts six Work types:
| Type | When to use |
|---|---|
bug | Observed incorrect behavior with a clear expected outcome |
feature | New capability being added to existing code |
refactor | Structural improvement with no behavioral change |
investigation | Exploratory work — root cause unknown, no fix yet |
epic | A parent Work item grouping related child items |
greenfield | New project or module being built from scratch |
From a Jira ticket
Planned. Jira integration is in development. When available, it will work similarly to the GitHub import flow — paste a Jira ticket URL or authenticate with your workspace to browse tickets.
What gets created
Every Work item Zero creates includes:
- A unique Work item ID (e.g.
CASE-0041) - Initial state:
OPEN problem-definition.md— your description, written to local memory- A blank proof checklist — filled in as sessions complete
github-context.mdif imported from GitHub
Next steps
After creating a Work item, start a planning session to form a hypothesis and generate a proposed plan.