| Hat | Stage | Upstream gate | Output | Unblocks |
|---|---|---|---|---|
| PO | Intake | Jira epic ID listed in project.conf EPICS |
product/context-library/epics/<EPIC-ID>.md |
/prd-draft |
When to Use
User references a Jira epic ID (e.g. EPIC-001) or pastes a Jira link, intending to start work on it inside this workbench.
Prerequisites
- Epic ID in
project.conf EPICS. If missing, append and commit. - Atlassian MCP optional. Enabled → use
get_issue. Disabled → paste epic body.
Protocol
- Verify epic in
project.conf EPICS. - Pull epic — MCP
get_issueor manual paste. Capture summary, description, ACs, priority, assignee, reporter, parent, linked issues, labels, top 10 comments. - Write
product/context-library/epics/{EPIC_ID}.mdwith frontmatterstatus: draftand sections: Summary, Description, Acceptance Criteria, Linked issues, Comments. Mark unknownsTODO: …. - Update
EPIC-PIPELINE.mdsection## EPIC {EPIC_ID}. - Never publish or approve — tell user to run
wb.publish+wb.approve.
Output Frontmatter
id: epic-{EPIC_ID}
title: {title}
status: draft
priority: {priority}
pm: {assignee}
business_owner: {BO}
jira_url: https://<your-jira-domain>.atlassian.net/browse/{EPIC_ID}
pulled_at: {today}
source: {mcp|manual}
Do Not
- Set
status: publishedorstatus: approved— both are human-driven via aliases. - Expose MCP tokens in the written file.
- Draft a PRD from this skill — that is
/prd-draft.