Skip to main content

Jira story, epic, and bug

When intake.jira.enabled is true and the ask contains an issue key, the receptionist resolves jira-story, jira-epic, or jira-bug from the issue type — before change class.

Shared rules

  • intake-agent fetches once. Everyone else reads intake.md. Do not call tracker MCP from the parent or from BA.
  • No MCP reachable is not a reason to guess: intake returns BLOCKED. Connect MCP, set intake.jira.mcp_namespaces, or paste the description as plain text (feature-development).
  • Do not hardcode a project key, JQL, MCP server name, or issue-type mapping in a skill. Those belong in config.json.

Chains

WorkflowPlan sourceChain
jira-storyintake.mdintake → sign-off requirements → architect? → BA → waves → tester → devops → retro (skip_pm)
jira-epicepic-plan.mdSame shape; BA writes one child spec per in-scope story
jira-bugrca.mdintake → bug-analyst → developer → critic → tester → devops → retro. No PM/BA/Architect

run_tester is true on bugs. Do not let the developer start a fix before HANDOFF-bug-analyst.md is SUCCESS. rca.md is the defect’s specification.

Issue-type map (story, task, bug, defect, epic, …) is under intake.jira.issue_type_map. Tool names default to getJiraIssue and searchJiraIssuesUsingJql.

Enable/disable: config guide. Failures: intake troubleshooting.