🏛️ PANEL

PRD from Agent Negotiation & Expert Logic — Multi-agent AI system that transforms project ideas into comprehensive PRDs through expert debates and judicial review.

---

📑 Table of Contents

• Features
• Quick Start
• Usage Example
• Project Structure
• Agents
• API Reference
• Configuration
• Output
• Development
• License

---

✨ Features

Feature	Description
🎯 Smart Clarification	AI asks targeted questions to understand your vision
💬 Expert Debate	13+ specialized agents debate best approaches
⚖️ Judicial Review	3 judges score business, technical & feasibility
📡 Real-time Streaming	Watch agents discuss live via SSE
📦 Complete Output	Download PRD + transcripts + exports as ZIP

Tech Stack: Python + FastAPI + AutoGen | Vue 3 + Vite + Tailwind | OpenAI GPT-4o

---

🚀 Quick Start

Prerequisites: Python 3.10+ • Node.js 18+ • Just • OpenAI API key

git clone https://github.com/CodeBlackwell/PANEL.git
cd PANEL
just setup # Install all dependencies# Edit backend/.env and add your OPENAI_API_KEY
just dev # Start backend + frontend

Open:http://localhost:5173

Manual setup (without Just)

# Backendcd backend && python -m venv venv &&source venv/bin/activate
pip install -r requirements.txt && cp .env.example .env
uvicorn app.main:app --reload --port 8000
# Frontend (new terminal)cd frontend && npm install && npm run dev

---

💡 Usage Example

1. Enter idea → "A marketplace for local farmers to sell directly to restaurants"
2. Configure → Select agents: Architect, Security, Backend Dev, UX
Debate rounds: 5
3. Clarify → Answer questions about target users, scale, budget
4. Watch debate → Agents discuss architecture, security, UX trade-offs
5. View scores → Business: 8/10 | Technical: 9/10 | Feasibility: 7/10
6. Download → Get PRD.md + transcripts + requirements.json

Sample output inexamples/prds/

---

🏗️ Project Structure

PANEL/
├── backend/
│ ├── app/
│ │ ├── main.py # FastAPI entry
│ │ ├── agents/ # AutoGen definitions
│ │ │ ├── definitions.py # Agent prompts
│ │ │ ├── teams.py # GroupChat configs
│ │ │ └── orchestrator.py # Workflow control
│ │ ├── api/routes/ # Endpoints
│ │ └── services/ # Business logic
│ └── requirements.txt
├── frontend/
│ └── src/
│ ├── views/ # Page components
│ ├── components/ # UI components
│ └── stores/ # Pinia state
├── agents/ # Agent definitions
└── examples/prds/ # Sample outputs

---

🤖 Agents

Debate Agents (select 2-6)

Agent	Focus	Agent	Focus
🏗️ Architect	System design, patterns	🔐 Security	Auth, compliance
⚙️ DevOps	CI/CD, infrastructure	🎨 UX	Experience, a11y
🧪 QA	Testing, quality	📋 Product Manager	Stories, roadmap
🗄️ Data Engineer	Pipelines, ETL	🤖 ML Engineer	Models, MLOps
🖥️ Frontend Dev	UI, performance	⚡ Backend Dev	APIs, caching
📱 Mobile Dev	iOS/Android	📊 Business Analyst	Requirements, ROI
👨‍💻 Tech Lead	Code quality

Judge Agents

⚖️ Business	⚖️ Technical	⚖️ Feasibility
Market fit, revenue	Architecture, security	Resources, timeline, risks

---

🔌 API Reference

Method	Endpoint	Description
POST	/api/v1/sessions	Create session
GET	/api/v1/sessions/{id}	Get status
POST	/api/v1/sessions/{id}/idea	Submit idea
POST	/api/v1/sessions/{id}/config	Configure agents
GET	/api/v1/sessions/{id}/clarify/stream	SSE: Clarification
POST	/api/v1/sessions/{id}/answers	Submit answers
GET	/api/v1/sessions/{id}/debate/stream	SSE: Debate
GET	/api/v1/sessions/{id}/judge/stream	SSE: Evaluation
GET	/api/v1/sessions/{id}/download	Download ZIP

---

⚙️ Configuration

Edit backend/.env:

OPENAI_API_KEY=your_key_hereMODEL_NAME=gpt-4oDEFAULT_DEBATE_ROUNDS=5MAX_DEBATE_ROUNDS=15STORAGE_PATH=./sessions

---

📦 Output

Generated ZIP structure:

prd_{session_id}.zip
├── PRD.md # Final document
├── original_prompt.txt # Your idea
├── transcripts/
│ ├── clarification.md # Q&A phase
│ ├── debate.md # Expert discussion
│ └── review.md # Judge evaluations
├── metadata/
│ └── scores.json # Numeric scores
└── exports/
├── requirements.json # Structured reqs
└── decisions.json # Key decisions

---

🛠️ Development

just test# Run all tests
just build # Production frontend build
just help# List all commands

Recipe	Description
just dev	Run backend + frontend
just backend	Backend only
just frontend	Frontend only
just test	Run all tests
just build	Production build
just clean	Remove generated files

---

📄 License

MIT License - see LICENSE for details.

---

Built with AutoGen + GPT-4o