plan-jira-ticket

Create Jira ticket work plans with requirements, root cause analysis, and solution options.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/shysssthanhtri/AI-tools --skill plan-jira-ticket
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-jira-ticket
Source: https://github.com/shysssthanhtri/AI-tools/tree/main/skills/plan-jira-ticket
Command: npx skills add https://github.com/shysssthanhtri/AI-tools --skill plan-jira-ticket

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers convert a Jira ticket into a rigorous, reviewable work plan by extracting requirements, performing codebase-root-cause analysis, proposing up to three optimized solutions with pros and cons, and producing an implementation-ready plan and progress tracker inside docs/<ticket-id>/.

Core Features & Use Cases

  • Deep requirements synthesis: reads the ticket summary and acceptance criteria, surfaces implicit requirements and edge cases for a clear definition of done.
  • Codebase analysis & root-cause investigation: searches and inspects relevant files, tests, and dependencies to identify true defects or constraints and cite evidence.
  • Decision-driven planning: presents up to three maintainable solution options with pros/cons, pauses for user choice, then writes the finalized plan.md and progress.md under docs/<ticket-id>/ for team collaboration.
  • Use Case: Prepare a shareable implementation plan for ticket CM-4873 that developers and reviewers can execute against an isolated worktree.

Quick Start

Plan ticket CM-4873 by deeply analyzing its docs/CM-4873/ snapshot, proposing solution options, and writing the initial docs/CM-4873/plan.md in Awaiting decision status.

Frequently Asked Questions about plan-jira-ticket

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an implementation plan from a Jira ticket?

Creating an implementation plan from a Jira ticket involves extracting requirements, performing root-cause analysis on the codebase, proposing solution options, and writing a documented workplan. This Skill automates that workflow by generating plan.md and progress.md files inside your docs directory for review.

What is root-cause analysis in software engineering workplans?

Root-cause analysis in software engineering workplans searches and inspects relevant files, tests, and dependencies to identify true defects or constraints. It provides cited evidence to ensure the implementation plan addresses the actual underlying issues rather than just surface symptoms.

How do I break down Jira tickets into actionable development tasks?

Breaking down Jira tickets involves deep requirements synthesis to surface implicit requirements and edge cases. You then map these into decision-driven implementation tasks, producing up to three optimized maintainable solution options with documented pros and cons for team review.

Do I need a designated worktree to finalize a ticket workplan?

Yes, you need a designated worktree to finalize a ticket workplan. The planning process validates and operates inside the isolated worktree to ensure proposed solutions and generated documentation align with the correct codebase state before implementation begins.

What's the best way to document solution options before coding?

The best way to document solution options before coding is to write a structured plan.md file under a docs/<ticket-id>/ directory. This file should capture up to three optimized solution options with pros and cons, pausing for a user decision before finalizing the implementation tasks.

Can I track implementation progress alongside the ticket workplan?

Yes, you can track implementation progress alongside the ticket workplan. The process generates a progress.md file within the same docs/<ticket-id>/ directory, providing a tracker that developers and reviewers can update during execution against the isolated worktree.