# Brownfield Fullstack Workflow - Claude Native Format
workflow:
  name: brownfield-fullstack
  description: "Enhance existing full-stack application with new features or improvements"
  type: brownfield
  category: fullstack
  
metadata:
  version: "1.0.0"
  author: "BMAD System"
  last_updated: "2024-01-01"
  
requirements:
  - Existing full-stack application codebase
  - Enhancement specification document
  - System documentation (optional but recommended)
  
sequence:
  - step: 1
    name: "Enhancement Scope Classification"
    agent: analyst
    task: classify_enhancement
    inputs:
      - "enhancement_spec.md"
    creates: ".claude/context/artifacts/enhancement-classification.json"
    validators:
      - schema: ".claude/schemas/enhancement_classification.schema.json"
    render:
      renderer: "enhancement-classification"
      from: ".claude/context/artifacts/enhancement-classification.json"
      to: ".claude/context/artifacts/enhancement-classification.md"
    description: "Determine enhancement complexity and appropriate workflow path"
    instructions: |
      Load the Analyst agent prompt from .claude/agents/analyst/prompt.md
      Analyze the enhancement request to determine scope:
      - Single story (< 4 hours): Simple bug fix or minor feature
      - Small feature (1-3 stories): Focused feature addition
      - Major enhancement (multiple epics): Significant changes requiring architecture
      Ask user: "Can you describe the enhancement scope? Is this a small fix, a feature addition, or a major enhancement requiring architectural changes?"
      Document the classification and recommended workflow path
      Save output to .claude/context/artifacts/enhancement-classification.md
    
  - step: 2
    name: "Existing System Analysis"
    agent: architect
    task: analyze_existing_system
    template: project_documentation
    inputs:
      - ".claude/context/artifacts/enhancement-classification.md"
    creates: ".claude/context/artifacts/system-analysis.md"
    depends_on: [1]
    condition: major_enhancement
    description: "Analyze existing full-stack application and current state"
    instructions: |
      Load the Architect agent prompt from .claude/agents/architect/prompt.md
      Examine the existing full-stack codebase, architecture, and technologies
      Analyze frontend components, backend services, database schemas, and integrations
      Review system documentation, API specifications, and coding standards
      Identify technical debt, performance issues, and architectural constraints
      Document current state, integration dependencies, and enhancement opportunities
      Save output to .claude/context/artifacts/system-analysis.md
    
  - step: 3
    name: "Enhancement Requirements"
    agent: pm
    task: create_brownfield_prd
    template: brownfield_prd
    inputs:
      - ".claude/context/artifacts/system-analysis.md"
    creates: ".claude/context/artifacts/prd.json"
    validators:
      - schema: ".claude/schemas/product_requirements.schema.json"
    on_fail:
      retry: 1
      escalate_to: "analyst"
    render:
      renderer: "prd"
      from: ".claude/context/artifacts/prd.json"
      to: ".claude/context/artifacts/prd.md"
    depends_on: [1, 2]
    description: "Create enhancement-focused Product Requirements Document"
    instructions: |
      Load the PM agent prompt from .claude/agents/pm/prompt.md
      Reference system analysis and enhancement classification from previous steps
      Apply the brownfield PRD template from .claude/templates/brownfield-prd.md
      Generate requirements that account for existing system constraints and dependencies
      Include migration strategies, backward compatibility, and integration considerations
      Define user stories that respect existing user workflows and data structures
      Save output to .claude/context/artifacts/prd.md
    
  - step: 4
    name: "UI/UX Enhancement Planning"
    agent: ux-expert
    task: plan_ui_enhancements
    template: ui_spec
    inputs:
      - ".claude/context/artifacts/prd.json"
    creates: ".claude/context/artifacts/ux-spec.json"
    validators:
      - schema: ".claude/schemas/ux_spec.schema.json"
    on_fail:
      retry: 1
      escalate_to: "architect"
    render:
      renderer: "ux-spec"
      from: ".claude/context/artifacts/ux-spec.json"
      to: ".claude/context/artifacts/ui-spec.md"
    depends_on: [2, 3]
    optional: true
    condition: frontend_changes_required
    description: "Plan UI/UX enhancements that integrate with existing design"
    instructions: |
      Load the UX Expert agent prompt from .claude/agents/ux-expert/prompt.md
      Reference system analysis and PRD from previous steps
      Apply the UI spec template from .claude/templates/ui-spec.md
      Design enhancements that maintain consistency with existing UI patterns
      Plan component updates, new interactions, and design system integration
      Consider user experience implications of changes to existing workflows
      Save output to .claude/context/artifacts/ui-spec.md
    
  - step: 5
    name: "Integration Architecture"
    agent: architect
    task: design_integration_architecture
    template: brownfield_architecture
    inputs:
      - ".claude/context/artifacts/prd.json"
      - ".claude/context/artifacts/ui-spec.md"
    creates: ".claude/context/artifacts/architecture.json"
    validators:
      - schema: ".claude/schemas/system_architecture.schema.json"
    on_fail:
      retry: 1
      escalate_to: "pm"
    render:
      renderer: "architecture"
      from: ".claude/context/artifacts/architecture.json"
      to: ".claude/context/artifacts/architecture.md"
    depends_on: [2, 3, 4]
    condition: architectural_changes_needed
    description: "Design integration strategy for full-stack enhancements"
    instructions: |
      Load the Architect agent prompt from .claude/agents/architect/prompt.md
      Reference system analysis, PRD, and UI enhancement spec from previous steps
      Apply the brownfield architecture template from .claude/templates/brownfield-architecture.md
      Design safe integration strategy for both frontend and backend changes
      Plan database migrations, API updates, and component integration
      Include deployment strategy, rollback plans, and monitoring considerations
      Address security, performance, and scalability implications
      Save output to .claude/context/artifacts/architecture.md
    
  - step: 6
    name: "Frontend Enhancement Implementation"
    agent: developer
    task: implement_frontend_enhancements
    creates: "src/frontend-enhanced/"
    depends_on: [4, 5]
    condition: frontend_changes_required
    description: "Implement frontend enhancements and component updates"
    instructions: |
      Load the Developer agent prompt from .claude/agents/developer/prompt.md
      Reference UI enhancement spec and architecture from previous steps
      Implement enhanced UI components while maintaining existing patterns
      Update or create new pages, routes, and state management
      Ensure backward compatibility with existing data structures and APIs
      Include proper testing and documentation for new components
      Save outputs to src/frontend-enhanced/, src/components-enhanced/
    
  - step: 7
    name: "Backend Enhancement Implementation"
    agent: developer
    task: implement_backend_enhancements
    creates: "src/backend-enhanced/"
    depends_on: [3, 5]
    condition: backend_changes_required
    description: "Implement backend enhancements and API updates"
    instructions: |
      Load the Developer agent prompt from .claude/agents/developer/prompt.md
      Reference PRD and architecture documents from previous steps
      Implement enhanced API endpoints while maintaining existing contracts
      Update business logic, data models, and database schemas with migrations
      Ensure backward compatibility and proper versioning
      Include enhanced error handling, validation, and security measures
      Save outputs to src/backend-enhanced/, src/api-enhanced/
    
  - step: 8
    name: "Integration Testing Strategy"
    agent: qa
    task: create_integration_test_plan
    template: test_plan
    inputs:
      - ".claude/context/artifacts/architecture.md"
      - "src/frontend-enhanced/"
      - "src/backend-enhanced/"
    creates: ".claude/context/artifacts/test-plan.json"
    validators:
      - schema: ".claude/schemas/test_plan.schema.json"
    on_fail:
      retry: 1
      escalate_to: "architect"
    render:
      renderer: "test-plan"
      from: ".claude/context/artifacts/test-plan.json"
      to: ".claude/context/artifacts/test-plan.md"
    depends_on: [6, 7]
    description: "Create comprehensive testing strategy for full-stack enhancements"
    instructions: |
      Load the QA agent prompt from .claude/agents/qa/prompt.md
      Reference all implementation artifacts from previous steps
      Apply the test plan template from .claude/templates/test-plan.md
      Generate testing strategy that ensures existing functionality remains intact
      Include frontend testing, API testing, integration testing, and e2e testing
      Create test scenarios for backward compatibility and migration procedures
      Plan regression testing and user acceptance testing
      Save output to .claude/context/artifacts/test-plan.md
    
  - step: 9
    name: "Implementation Review"
    agent: architect
    task: review_fullstack_integration
    creates: ".claude/context/artifacts/review-notes.json"
    validators:
      - schema: ".claude/schemas/review_notes.schema.json"
    render:
      renderer: "review-notes"
      from: ".claude/context/artifacts/review-notes.json"
      to: ".claude/context/artifacts/review-notes.md"
    depends_on: [6, 7, 8]
    description: "Review full-stack enhancements and integration safety"
    instructions: |
      Load the Architect agent prompt again from .claude/agents/architect/prompt.md
      Review all generated artifacts and full-stack enhancement implementation
      Validate that enhancements integrate safely with existing system
      Check frontend-backend integration, data flow, and API compatibility
      Verify security measures, performance impacts, and deployment readiness
      Provide recommendations for rollout, monitoring, and maintenance
      Save output to .claude/context/artifacts/review-notes.md

outputs:
  documents:
    - enhancement-classification.md
    - system-analysis.md
    - prd.json
    - prd.md
    - ux-spec.json (optional)
    - ui-spec.md (optional)
    - architecture.json (conditional)
    - architecture.md (conditional)
    - test-plan.json
    - test-plan.md
    - review-notes.md
  frontend_code:
    - src/frontend-enhanced/
    - src/components-enhanced/
    - src/styles-enhanced/
    - src/hooks-enhanced/
  backend_code:
    - src/backend-enhanced/
    - src/api-enhanced/
    - src/models-enhanced/
    - src/services-enhanced/
  configuration:
    - package.json (updated)
    - docker-compose.yml (updated)
    - migration-scripts/
  testing:
    - tests/integration-enhanced/
    - tests/regression/
    - tests/e2e-enhanced/

project_types:
  - feature-addition
  - refactoring
  - modernization
  - integration-enhancement

when_to_use:
  - Enhancement requires coordinated stories
  - Architectural changes are needed
  - Significant integration work required
  - Risk assessment and mitigation planning necessary
  - Multiple team members will work on related changes