# vivekjain17/jira-prompts architecture

> Architecture diagram of the GitHub repository vivekjain17/jira-prompts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vivekjain17/jira-prompts
- Repository: https://github.com/vivekjain17/jira-prompts

## Overview

This repository documents a prompt-driven workflow for generating and reviewing Adobe Stock Jira EPIC descriptions; it contains no executable workflow code. The graph follows the README’s documented process and capabilities. Source-specific integrations and internal implementation details are not sampled, so links show only documented interactions, not underlying MCP calls.

Main entry points: [`docs/EPIC_Description_Generation_Prompt.md`](https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md) (Generation Prompt), [`examples`](https://github.com/vivekjain17/jira-prompts/tree/main/examples) (HTML Review File), [`docs/USAGE_EXAMPLES.md`](https://github.com/vivekjain17/jira-prompts/blob/main/docs/USAGE_EXAMPLES.md) (Revise or Cancel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Generation Workflow"]
  node_prompt["Generation Prompt"]
  node_jira_epic[("Jira EPIC")]
  node_description_check["Description Check"]
  node_template["EPIC Template"]
  node_findings["Aggregated Findings"]
  node_description["Generated Description"]
end

subgraph group_sources["Information Sources"]
  node_wiki["Wiki Pages"]
  node_figma["Figma Files"]
  node_stories["Stories"]
  node_github["GitHub Links"]
  node_confluence["Confluence"]
  node_other_sources["Other Sources"]
end

subgraph group_review["Review and Output"]
  node_review_file["HTML Review File"]
  node_approval(("User Approval"))
  node_jira_update[("Jira Update")]
  node_revision["Revise or Cancel<br/>[USAGE_EXAMPLES.md]"]
  node_bulk_summary["Bulk Summary<br/>[USAGE_EXAMPLES.md]"]
end

node_user(("Requester"))

node_user -->|"requests generation"| node_prompt
node_prompt -->|"retrieves EPIC"| node_jira_epic
node_prompt -->|"checks description"| node_description_check
node_description_check -->|"reads current text"| node_jira_epic
node_prompt -->|"follows structure"| node_template
node_prompt -->|"searches first"| node_wiki
node_prompt -->|"searches next"| node_figma
node_prompt -->|"searches next"| node_stories
node_prompt -->|"searches next"| node_github
node_prompt -->|"searches next"| node_confluence
node_prompt -->|"searches last"| node_other_sources
node_wiki -->|"provides findings"| node_findings
node_figma -->|"provides findings"| node_findings
node_stories -->|"provides findings"| node_findings
node_github -->|"provides findings"| node_findings
node_confluence -->|"provides findings"| node_findings
node_other_sources -->|"provides findings"| node_findings
node_prompt -->|"aggregates sources"| node_findings
node_prompt -->|"generates text"| node_description
node_findings -->|"informs content"| node_description
node_template -->|"structures content"| node_description
node_description -->|"renders proposal"| node_review_file
node_jira_epic -->|"supplies current text"| node_review_file
node_review_file -->|"presents for review"| node_approval
node_approval -->|"approves update"| node_jira_update
node_approval -->|"declines proposal"| node_revision
node_prompt -->|"summarizes batch"| node_bulk_summary

click node_prompt "https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md"
click node_description_check "https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md"
click node_template "https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md"
click node_findings "https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md"
click node_description "https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md"
click node_review_file "https://github.com/vivekjain17/jira-prompts/tree/main/examples"
click node_revision "https://github.com/vivekjain17/jira-prompts/blob/main/docs/USAGE_EXAMPLES.md"
click node_bulk_summary "https://github.com/vivekjain17/jira-prompts/blob/main/docs/USAGE_EXAMPLES.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_prompt,node_jira_epic,node_description_check,node_template,node_findings,node_description toneBlue
class node_wiki,node_figma,node_stories,node_github,node_confluence,node_other_sources toneAmber
class node_review_file,node_approval,node_jira_update,node_revision,node_bulk_summary,node_user toneMint
```

## Components

### Generation Workflow

- [Generation Prompt](https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md): `docs/EPIC_Description_Generation_Prompt.md`
- **Jira EPIC**
- [Description Check](https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md): `docs/EPIC_Description_Generation_Prompt.md`
- [EPIC Template](https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md): `docs/EPIC_Description_Generation_Prompt.md`
- [Aggregated Findings](https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md): `docs/EPIC_Description_Generation_Prompt.md`
- [Generated Description](https://github.com/vivekjain17/jira-prompts/blob/main/docs/EPIC_Description_Generation_Prompt.md): `docs/EPIC_Description_Generation_Prompt.md`

### Information Sources

- **Wiki Pages**
- **Figma Files**
- **Stories**
- **GitHub Links**
- **Confluence**
- **Other Sources**

### Review and Output

- [HTML Review File](https://github.com/vivekjain17/jira-prompts/tree/main/examples): `examples`
- **User Approval**
- **Jira Update**
- [Revise or Cancel](https://github.com/vivekjain17/jira-prompts/blob/main/docs/USAGE_EXAMPLES.md): `docs/USAGE_EXAMPLES.md`
- [Bulk Summary](https://github.com/vivekjain17/jira-prompts/blob/main/docs/USAGE_EXAMPLES.md): `docs/USAGE_EXAMPLES.md`

### Other components

- **Requester**

## Connections

- Requester → Generation Prompt: requests generation
- Generation Prompt → Jira EPIC: retrieves EPIC
- Generation Prompt → Description Check: checks description
- Description Check → Jira EPIC: reads current text
- Generation Prompt → EPIC Template: follows structure
- Generation Prompt → Wiki Pages: searches first
- Generation Prompt → Figma Files: searches next
- Generation Prompt → Stories: searches next
- Generation Prompt → GitHub Links: searches next
- Generation Prompt → Confluence: searches next
- Generation Prompt → Other Sources: searches last
- Wiki Pages → Aggregated Findings: provides findings
- Figma Files → Aggregated Findings: provides findings
- Stories → Aggregated Findings: provides findings
- GitHub Links → Aggregated Findings: provides findings
- Confluence → Aggregated Findings: provides findings
- Other Sources → Aggregated Findings: provides findings
- Generation Prompt → Aggregated Findings: aggregates sources
- Generation Prompt → Generated Description: generates text
- Aggregated Findings → Generated Description: informs content
- EPIC Template → Generated Description: structures content
- Generated Description → HTML Review File: renders proposal
- Jira EPIC → HTML Review File: supplies current text
- HTML Review File → User Approval: presents for review
- User Approval → Jira Update: approves update
- User Approval → Revise or Cancel: declines proposal
- Generation Prompt → Bulk Summary: summarizes batch