File size: 4,745 Bytes
92bdf98
ea1c770
 
 
 
92bdf98
f384d7a
92bdf98
ea1c770
92bdf98
4934594
92bdf98
 
ea1c770
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
f384d7a
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
---
title: AI Project Planner
emoji: πŸš€
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 6.2.0
app_file: app.py
pinned: true
license: mit
short_description: Transform product specs into project plans via AI
---

# πŸš€ AI Project Planner

**Transform product specifications into comprehensive project plans using orchestrated AI agents.**

[![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## What This Does

Upload any product specification and watch as specialized AI agents collaborate to generate:

- **πŸ‘€ User Stories** - Persona-based requirements in "As a... I want... So that..." format
- **πŸ“¦ Product Features** - Logically grouped capabilities with descriptions and user benefits
- **πŸ”§ Engineering Tasks** - Detailed development work breakdown with dependencies and estimates

## How It Works

```
Product Spec β†’ Action Planner β†’ Routing Agent β†’ Specialized Teams β†’ Project Plan
                                      β”‚
                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                    ↓                 ↓                 ↓
              Product Manager   Program Manager   Dev Engineer
              (User Stories)    (Features)        (Tasks)
                    β”‚                 β”‚                 β”‚
                    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Ίβ”‚β—„β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                              Evaluation Agents
                          (Quality Assurance Loop)
```

### The Agent Architecture

| Agent | Role | Output |
|-------|------|--------|
| **Action Planning Agent** | Breaks down high-level goals into workflow steps | Task sequence |
| **Routing Agent** | Directs each step to the appropriate specialist using semantic similarity | Agent selection |
| **Product Manager Team** | Knowledge Agent + Evaluation Agent for user stories | Validated stories |
| **Program Manager Team** | Knowledge Agent + Evaluation Agent for features | Validated features |
| **Dev Engineer Team** | Knowledge Agent + Evaluation Agent for tasks | Validated tasks |

## Quick Start

1. **Enter your OpenAI API key** (required for AI agents to function)
2. **Upload or paste** a product specification (or use an example)
3. **Click Generate** and watch the workflow execute
4. **Download** your project plan in Markdown or JSON format

## Example Output

### User Story
```
As a Customer Support Representative, I want the Email Router system 
to automate responses to routine inquiries so that I can focus on 
addressing complex customer issues efficiently.
```

### Product Feature
```
Feature Name: Intelligent Email Classification
Description: NLP-powered analysis for categorizing incoming emails
Key Functionality: Content analysis, intent detection, priority assignment
User Benefit: Reduced manual triage time by 70%
```

### Engineering Task
```
Task ID: EMAIL-001
Task Title: Implement NLP classification engine
Related User Story: US-001
Description: Develop ML pipeline for email content analysis
Acceptance Criteria: Classification accuracy >95%
Estimated Effort: 3 weeks
Dependencies: Email preprocessing module
```

## Technical Details

- **Model**: GPT-3.5-turbo for text generation
- **Embeddings**: text-embedding-3-large for semantic routing
- **Framework**: Gradio for the web interface
- **Quality Control**: Iterative evaluation loops with up to 5 refinement cycles

## Use Cases

- **Product Managers**: Quickly generate user stories from feature ideas
- **Technical Program Managers**: Create comprehensive project plans
- **Engineering Leads**: Break down requirements into actionable tasks
- **Startups**: Transform product vision into development roadmaps

## Privacy & Security

- Your API key is **never stored** - it's only used for the current session
- Product specifications are **not retained** after processing
- All processing happens in real-time with no data persistence

## Built With

- [Gradio](https://gradio.app/) - Web interface framework
- [OpenAI API](https://openai.com/) - AI capabilities
- [NumPy](https://numpy.org/) - Vector operations for semantic routing

## Author

Built as part of the Udacity AI Programming curriculum, extended with production deployment capabilities.

## License

MIT License - feel free to use, modify, and distribute.

---

**⭐ If you find this useful, please star the repository!**