EpicCraft - Agile Story Generator
🚀 Turn Product Ideas into Complete Agile Artifacts --- Instantly
Generate Epics, User Stories, Acceptance Criteria, and
Technical Notes using AI --- directly inside VS Code.
Built for Product Owners , Product Managers, Tech Leads, and Agile
Teams.
👨💻 Publisher
Duddu Arun Kumar
Repo: https://github.com/arun4duddu/EpicCraft-Agile-Story-Generator/
📄 License
Licensed under the MIT License.
📌 Overview
EpicCraft transforms a simple product idea into structured Agile
deliverables aligned with industry best practices.
Instead of spending hours writing backlog items, simply describe your
feature:
"Allow customers to pay via UPI in the POS app"
...and EpicCraft generates:
✅ Epic
✅ INVEST-compliant user stories
✅ Gherkin acceptance criteria
✅ Technical architecture notes
✅ Diagrams (Mermaid / PlantUML)
Support
GitHub Issues
VS Code Extension Marketplace
Email support: arun4duddu@gmail.com
🧠 Why EpicCraft?
| Problem |
EpicCraft Solution |
| Writing stories takes too long |
AI generates structured artifacts instantly |
| Poorly defined requirements |
INVEST-aligned stories |
| Missing acceptance criteria |
Automatic BDD generation |
| Documentation scattered |
Export-ready Markdown |
| Manual Jira creation |
Optional direct publishing |
🚀 Features
⚙️ Core Capabilities
- ✍️ Single-Line → Full Stories
- 📐 INVEST-Compliant User Stories
- ✅ Gherkin Acceptance Criteria
- 🧩 Technical Architecture Notes
- 🌙 Modern Dark/Light UI
- ⚡ Fast AI generation (~5--10s)
🔗 Export & Integrations
- 📝 Markdown Export --- Confluence, Wikis, GitHub Docs
- 💾 JSON Export --- Automation & pipelines
- 📤 Jira Publishing (Optional) via MCP Server - PRO MODEL
- 📊 Mermaid / PlantUML Diagrams
🧩 Flexibility & Customization
- Multiple LLM Providers:
- OpenAI
- Azure OpenAI
- GitHub Copilot
- Domain-aware prompting (FinTech, E-commerce, SaaS, IoT)
- Works with or without Jira
📦 Installation
- Open VS Code
- Go to Extensions (Ctrl + Shift + X)
- Search for EpicCraft
- Click Install
🎯 Quick Start
1️⃣ Open EpicCraft
Run command:
EpicCraft: Open Story Generator
2️⃣ Describe Your Use Case
Allow customers to pay via UPI in the POS app
- Select domain
- Choose story count (3--8)
- Enable Jira publishing
4️⃣ Generate Stories 🚀
AI creates:
- Epic
- User stories
- Acceptance criteria
- Technical insights
5️⃣ Export or Publish
Action Use Case
Markdown Documentation
JSON Automation
Jira Agile workflow
📋 Generated Artifacts
Epic
- Title & description
- Business value
- Success metrics
- Acceptance criteria
User Stories (INVEST)
As a [role]
I want [action]
So that [benefit]
Acceptance Criteria:
Given ...
When ...
Then ...
Technical Notes
- Architecture overview
- Component diagrams
- Sequence diagrams
- Security considerations
- Scalability insights
🏛 System Architecture
┌─────────────────────────────────────┐
│ VS Code Extension (TS) │
├─────────────────────────────────────┤
│ Webview UI (HTML/CSS) │
├─────────────────────────────────────┤
│ Prompt Engine + Templates │
├─────────────────────────────────────┤
│ LLM Provider (AI Generation) │
├─────────────────────────────────────┤
│ MCP Server ⇄ Jira API (Optional) │
└─────────────────────────────────────┘
📚 Prompt Customization
All AI behavior is configurable via:
/templates
File Purpose
prompts.yaml Story generation prompts
hints.yaml Domain intelligence
Modify outputs without changing code.
🔒 Security & Privacy
Secure by Default
- VS Code Secret Storage for API keys
- No telemetry (opt-in only)
- HTTPS-only communication
- Credentials never logged
Best Practices
- Never commit API keys
- Use environment variables
- Rotate credentials regularly
🛠 Troubleshooting
Jira Connection Failed
- Verify MCP Server URL
- Check authentication token
- Confirm Jira project key
Slow Generation
- Possible API rate limits
- Check network connectivity
- Verify Azure deployment status
🚧 Roadmap
v0.1 --- MVP
- Epics + stories generation
- Modern webview UI
- Markdown & JSON export
- Configurable settings
v0.2 --- Technical Intelligence
- Technical notes generation
- Diagram rendering
.puml exports
v1.0 --- PRO Edition
- MCP Jira integration
- Issue publishing
- Preview / dry-run
- Advanced mappings
v1.1+ Enterprise
- Azure DevOps integration
- GitHub Issues sync
- Team templates
- Collaboration features
⭐ If EpicCraft helps your workflow, consider giving it a star!
