gen-jira

Convert funcspec.md and techspec.md requirements into a structured Jira Epic and Stories file.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/hariinfo/agentic-code-template --skill gen-jira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gen-jira
Source: https://github.com/hariinfo/agentic-code-template/tree/main/.claude/skills/jira-modernize
Command: npx skills add https://github.com/hariinfo/agentic-code-template --skill gen-jira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate functional and technical specifications into JIRA-ready epics and stories, accelerating planning and ensuring traceability across docs.

Core Features & Use Cases

  • Epic → Story hierarchy with deep technical context, referencing techspec sections (API-001, MSG-001, TD-001).
  • Dual acceptance criteria aligned to functional requirements and technical specifications.
  • Traceability artifacts including fingerprint reminders, sprint breakdowns, and reverse-index mappings of legacy files to stories.
  • Supports migration/cutover storytelling and inter-story dependencies for realistic roadmaps.

Quick Start

Place analysis.md, funcspec.md, and techspec.md under modernization-output/{slug} and run /gen-jira <slug> to generate jira-stories.md.

Frequently Asked Questions about gen-jira

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

FAQPage Schema
How do I convert functional and technical specs into ready-to-ship Jira stories?

To convert functional and technical specs into Jira stories, place analysis.md, funcspec.md, and techspec.md in your project directory. The system translates them into a structured Epic and Story hierarchy with traceability, outputting a single jira-stories.md file.

How do you map technical design requirements like API-001 to Jira epics and stories?

Mapping technical design requirements like API-001 to Jira epics and stories involves referencing techspec sections directly within the generated story context. This creates deep technical traceability and includes dual acceptance criteria aligned to both functional and technical specifications.

Can I generate migration and cutover stories from a technical specification?

Yes, you can generate migration and cutover stories from a technical specification. The process identifies functional and technical requirements to produce a structured Epic and Story hierarchy, explicitly including migration/cutover storytelling and inter-story dependencies for realistic roadmaps.

What is the best way to maintain traceability between legacy files and new Jira tickets?

The best way to maintain traceability between legacy files and new Jira tickets is to generate a reverse-index mapping. The output jira-stories.md includes a traceability header, fingerprint validation reminder, and a reverse-index mapping of legacy files to stories to enable drift detection.

Does generating Jira stories from specs require a specific sprint breakdown structure?

Generating Jira stories from specs does not require a specific input sprint structure, but the output includes a sprint breakdown. This breakdown, along with inter-story dependencies and dual acceptance criteria, is produced automatically to enable project governance and realistic roadmap planning.

Why use spec-to-jira generation for software modernization projects?

Spec-to-jira generation is used for software modernization projects to accelerate planning and ensure traceability across documentation. It translates complex functional and technical specifications into ready-to-ship epics and stories, complete with migration plans and drift detection artifacts.