Requirements Translator

{
  "prd": {
    "title": "Multi-Agent Workflow Builder",
    "date": "2026-01-28",
    "version": "1.0",
    "status": "DRAFT",
    "author": "requirements-translator"
  },
  "problem_statement": {
    "problem": "AI engineers spend 2-4 hours setting up LangGraph supervisor-worker patterns manually",
    "impact": "Slower time-to-value, errors in boilerplate, inconsistent patterns",
    "who_affected": "AI engineers building multi-agent systems (est. 500 MAU)"
  },
  "solution": {
    "summary": "Visual workflow builder with drag-drop nodes and LangGraph code generation",
    "key_capabilities": [
      "Drag-drop node placement (supervisor, worker, router)",
      "Visual edge connections with conditions",
      "One-click code generation (Python + TypeScript)",
      "Template library for common patterns"
    ]
  },
  "scope": {
    "in_scope": [
      "Basic node types: supervisor, worker, router, human-in-loop",
      "Edge types: sequential, conditional, parallel",
      "Code export: Python only (v1)",
      "3 starter templates"
    ],
    "out_of_scope": [
      "TypeScript export (v2)",
      "Custom node creation (v2)",
      "Real-time collaboration (v3)",
      "Version control integration (v3)"
    ],
    "future_considerations": ["Plugin system", "Team workspaces"]
  },
  "user_stories": [
    {
      "id": "US-001",
      "story": "As an AI engineer, I want to drag nodes onto a canvas so that I can visually design my workflow",
      "acceptance_criteria": [
        "GIVEN I'm on the workflow builder, WHEN I drag a node from the palette, THEN it appears on the canvas",
        "GIVEN a node is on canvas, WHEN I click it, THEN I see a properties panel",
        "GIVEN two nodes exist, WHEN I drag from output to input, THEN an edge connects them"
      ],
      "priority": "HIGH",
      "estimate": "3 story points"
    }
  ],
  "edge_cases": [
    {"case": "Empty canvas export", "expected": "Show error: 'Add at least one node'"},
    {"case": "Disconnected nodes", "expected": "Warning with option to proceed"},
    {"case": "Circular dependencies", "expected": "Block with clear error message"}
  ],
  "non_functional": {
    "performance": "Canvas supports 50+ nodes without lag",
    "accessibility": "Keyboard navigation for all actions",
    "browser_support": "Chrome, Firefox, Safari (latest 2 versions)"
  },
  "github_issues_to_create": [
    {"title": "[Feature] Workflow builder canvas", "labels": ["feature", "frontend", "priority::high"]},
    {"title": "[Feature] Node palette and drag-drop", "labels": ["feature", "frontend"]},
    {"title": "[Feature] Python code export", "labels": ["feature", "backend", "priority::high"]}
  ],
  "received_from": "business-case-builder",
  "handoff_to": "metrics-architect"
}

I - Independent (can be developed separately)
N - Negotiable (details can be discussed)
V - Valuable (delivers user value)
E - Estimable (team can size it)
S - Small (fits in a sprint)
T - Testable (has clear acceptance criteria)

## US-XXX: [Title]

**As a** [persona/role]
**I want to** [action/goal]
**So that** [benefit/outcome]

### Acceptance Criteria
- [ ] GIVEN [context], WHEN [action], THEN [result]
- [ ] GIVEN [context], WHEN [action], THEN [result]
- [ ] GIVEN [context], WHEN [action], THEN [result]

### Edge Cases
- [ ] When [unusual situation], then [expected behavior]

### Out of Scope
- [Thing that might be assumed but isn't included]

### Dependencies
- Requires: [other story/component]
- Blocks: [downstream story]

# [Feature Name] PRD

## Problem Statement
- What problem are we solving?
- Who has this problem?
- What's the impact of not solving it?

## Solution
- High-level approach
- Key capabilities
- User experience overview

## Scope
### In Scope (v1)
- [Capability 1]
- [Capability 2]

### Out of Scope
- [Deferred capability]
- [Non-goal]

## User Stories
[Link to stories]

## Non-Functional Requirements
- Performance: [targets]
- Security: [requirements]
- Accessibility: [standards]

## Success Metrics
[Link to metrics-architect output]

## Open Questions
- [ ] [Unresolved decision]

┌─────────────────────────────────────────────────────┐
│                    IN SCOPE (v1)                     │
│  ┌─────────────────────────────────────────────────┐│
│  │ • Core feature A                                ││
│  │ • Core feature B                                ││
│  │ • Essential integration                          ││
│  └─────────────────────────────────────────────────┘│
├─────────────────────────────────────────────────────┤
│                 OUT OF SCOPE (later)                 │
│  ┌─────────────────────────────────────────────────┐│
│  │ • Nice-to-have C (v2)                           ││
│  │ • Advanced feature D (v3)                        ││
│  │ • Enterprise feature E (future)                  ││
│  └─────────────────────────────────────────────────┘│
├─────────────────────────────────────────────────────┤
│                    NON-GOALS                         │
│  ┌─────────────────────────────────────────────────┐│
│  │ • We will NOT do X (even later)                 ││
│  │ • This is NOT meant to replace Y                ││
│  └─────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────┘

# Create feature issue with proper structure
gh issue create --title "[Feature] Workflow builder canvas" \
  --body "## User Story\nAs an AI engineer...\n\n## Acceptance Criteria\n- [ ] ..." \
  --label "feature,frontend,priority::high"

# Link issues to milestone
gh issue edit 123 --milestone "v2.0"

# Create issue from template if available
gh issue create --template feature_request.md

# Add issue to project board
gh project item-add PROJECT_ID --owner OWNER --url ISSUE_URL