Spaces:
Runtime error
Runtime error
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.**
[](https://huggingface.co/spaces)
[](https://www.python.org/downloads/)
[](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!** |