gps-denied-desktop/.cursor/commands/2.planning/2.20_plan_jira_epics.md

Generate Jira Epics

Initial data:

• Problem description: @_docs/00_problem/problem_description.md
• Input data: @_docs/00_problem/input_data. They are for reference only, yet it is an example of the real data
• Restrictions: @_docs/00_problem/restrictions.md
• Acceptance criteria: @_docs/00_problem/acceptance_criteria.md
• Full Solution Description: @_docs/01_solution/solution.md
• Components: @_docs/02_components

Role

You are a world class product manager

Task

• Generate Jira Epics from the Components using Jira MCP
• Order epics by dependency (which must be done first)
• Include rough effort estimation per epic
• Ensure each epic has clear goal and acceptance criteria, verify it with acceptance criteria
• Generate draw.io components diagram based on previous diagram shows relations between components and current Jira Epic number, corresponding to each component.

Output

Epic format:

• Epic Name [Component] – [Outcome]

  • Example: Data Ingestion – Near-real-time pipeline

• Epic Summary (1–2 sentences)

  • What we are building + why it matters

• Problem / Context

  • Current state, pain points, constraints, business opportunities, Links to architecture decision records or diagrams

• Scope. Detailed description

• In Scope. Bullet list of capabilities (not tasks)

• Out-of-scope. Explicit exclusions to prevent scope creep

• Assumptions

• System design specifics, input material quality, data structures, network availability etc

• Dependencies

• Other epics that must be completed first

• Other components, services, hardware, environments, certificates, data sources etc.

• Effort Estimation

• T-shirt size (S/M/L/XL) or story points range

• Users / Consumers

• Internal, External, Systems, Short list of the key use cases.

• Requirements

• Functional - API expectations, events, data handling, idempotency, retry behavior etc

• Non-functional - Availability, latency, throughput, scalability, processing limits, data retention etc

• Security/Compliance - Authentication, encryption, secrets, logging, SOC2/ISO if applicable

• Design & Architecture (links)

• High-level diagram link, Data flow, sequence diagrams, schemas etc

• Definition of Done (Epic-level)

• Feature list per epic scope

• Automated tests (unit/integration/e2e) + minimum coverage threshold met

• Runbooks if applicable

• Documentation updated

• Acceptance Criteria (measurable)

• Risks & Mitigations

• Top 5 risks (technical + delivery) with mitigation owners or systems involved

• Label epic

• component:

• env:prod|stg

• type:platform|data|integration

• Jira Issue Breakdown

  • Create consistent child issues under the epic
  • Spikes
  • Tasks
  • Technical enablers

Notes

• Be as much concise as possible in formulating epics. The less words with the same meaning - the better epic is.