name: jira-project-setup
title: JIRA Project Setup Workflow
description: Complete workflow for setting up JIRA integration with a new or existing project
type: integration
category: setup
estimated_time: 60-90 minutes

agents:
  - jira
  - pm
  - architect

startup_sequence:
  - agent: jira
    task: setup
    message: "Starting JIRA integration setup wizard"
  
planning_phase:
  - id: 1.1
    agent: jira
    task: setup
    inputs:
      mode: discover
    outputs:
      - JIRA instance analysis
      - Available projects list
      - Field configurations
    decision_points:
      - id: D1
        name: Project Selection
        options:
          - Use existing JIRA project
          - Create new JIRA project
          - Configure multiple projects

  - id: 1.2
    agent: jira
    task: setup
    note: "Configure JIRA integration with project mapping"
    inputs:
      - Selected project details
      - Integration requirements
    outputs:
      - .bmad-workspace/config/jira-expansion-config.yaml
      - .bmad-workspace/config/jira-config.yaml
      - Field mapping definitions
      - Workflow state mappings

  - id: 1.3
    agent: jira
    task: jira-operations
    command: "validate configuration"
    note: "Test JIRA connection and validate project access"
    inputs:
      - JIRA configuration
      - Project mapping
    outputs:
      - Connection validation results
      - Field detection results
      - Integration points documentation
      - Error handling strategy

implementation_phase:
  - id: 2.1
    agent: jira
    task: setup
    inputs:
      mode: mcp-setup
    outputs:
      - MCP configuration validated
      - Connection established
      - Permissions verified

  - id: 2.2
    agent: jira
    task: setup
    inputs:
      mode: field-mapping
      - Field mapping definitions
    outputs:
      - Configured custom fields
      - Validated mappings
      - Test results

  - id: 2.3
    agent: jira
    task: sync
    inputs:
      mode: test
    outputs:
      - Create/update/delete tests
      - Bidirectional sync validation
      - Performance metrics

validation_phase:
  - id: 3.1
    agent: jira
    task: sync
    inputs:
      mode: validate
    outputs:
      - Three-way sync validation
      - Discrepancy report
      - Sync health dashboard

  - id: 3.2
    agent: pm
    task: create-integration-guide
    outputs:
      - Team onboarding guide
      - Common operations reference
      - Troubleshooting documentation

decision_points:
  - id: D1
    step: 1.1
    description: Choose whether to use existing JIRA project or create new
    impacts:
      - Project permissions requirements
      - Field configuration complexity
      - Migration needs

  - id: D2
    step: 2.2
    description: Select field mapping strategy
    options:
      - Standard BMAD fields only
      - Custom fields for full fidelity
      - Hybrid approach
    impacts:
      - Data completeness
      - Sync complexity
      - JIRA customization required

success_criteria:
  - JIRA MCP connection established and tested
  - All field mappings configured and validated
  - Bidirectional sync working for all operations
  - Three-way sync (Git-BMAD-JIRA) validated
  - Team documentation complete

rollback_plan:
  - Preserve original JIRA configuration backup
  - Document all custom field additions
  - Maintain rollback scripts for field removal
  - Keep sync disable commands ready