workflow:
  id: design-system-build-quality
  name: Design System Build Quality Pipeline
  version: "1.0"
  description: >-
    Pipeline pós-migração para Design System. Encadeia sequencialmente as etapas de
    build, documentação, auditoria de acessibilidade e cálculo de ROI para garantir
    qualidade e mensurar valor entregue.
  type: brownfield
  project_types:
    - design-system
    - component-library
    - pattern-library
    - ui-migration

  metadata:
    elicit: true
    confirmation_required: true

  execution_modes:
    - mode: yolo
      description: Execução autônoma com mínima interação
      prompts: 0-1
    - mode: interactive
      description: Checkpoints de decisão e feedback educacional
      prompts: 5-10
      default: true
    - mode: preflight
      description: Planejamento completo antes da execução - análise upfront de todos os componentes e dependências
      prompts: "10-15"

  phases:
    - phase_1: Build & Compile
    - phase_2: Documentation
    - phase_3: Quality Assurance
    - phase_4: ROI Analysis

  sequence:
    - step: build_atomic_components
      id: build
      phase: 1
      agent: ux-design-expert
      action: Build de componentes atômicos
      notes: |
        Executa build dos componentes do Design System:
        - Compila tokens de design (cores, tipografia, espaçamentos)
        - Gera componentes atômicos (buttons, inputs, cards, etc.)
        - Valida estrutura de arquivos e nomenclatura
        - Verifica dependências e imports

        Critérios de sucesso:
        - [ ] Build completo sem erros
        - [ ] Todos os tokens compilados
        - [ ] Componentes exportados corretamente
      outputs:
        - build_report
        - compiled_tokens
        - component_bundle

    - step: generate_documentation
      id: document
      phase: 2
      agent: ux-design-expert
      action: Gerar documentação do Pattern Library
      requires: build
      notes: |
        Gera documentação completa do Pattern Library:
        - Documenta cada componente com props e variantes
        - Cria exemplos de uso e code snippets
        - Gera guia de estilo visual
        - Atualiza changelog de componentes

        Critérios de sucesso:
        - [ ] Todos os componentes documentados
        - [ ] Exemplos de código funcionais
        - [ ] Guia de estilo atualizado
      outputs:
        - pattern_library_docs
        - component_api_reference
        - style_guide

    - step: accessibility_audit
      id: a11y-check
      phase: 3
      agent: ux-design-expert
      action: Auditoria de acessibilidade (WCAG AA)
      requires: document
      notes: |
        Executa auditoria de acessibilidade WCAG 2.1 AA:
        - Verifica contraste de cores (4.5:1 texto, 3:1 UI)
        - Valida navegação por teclado
        - Checa atributos ARIA e roles
        - Testa com screen readers
        - Verifica focus states e indicadores visuais

        Critérios de sucesso:
        - [ ] Contraste de cores aprovado
        - [ ] Navegação por teclado funcional
        - [ ] ARIA labels corretos
        - [ ] Zero violações críticas WCAG AA
      outputs:
        - a11y_audit_report
        - violations_list
        - remediation_plan

    - step: calculate_roi
      id: calculate-roi
      phase: 4
      agent: ux-design-expert
      action: Cálculo de ROI e savings
      requires: a11y-check
      notes: |
        Calcula retorno sobre investimento do Design System:
        - Tempo economizado em desenvolvimento
        - Redução de inconsistências visuais
        - Velocidade de entrega de features
        - Custo de manutenção reduzido
        - Métricas de reuso de componentes

        Métricas a calcular:
        - [ ] Horas dev economizadas/mês
        - [ ] % de reuso de componentes
        - [ ] Tempo médio para nova feature
        - [ ] Redução de bugs visuais
      outputs:
        - roi_report
        - savings_metrics
        - adoption_dashboard

    - workflow_end:
      action: pipeline_complete
      notes: |
        Pipeline de qualidade completo!

        Artefatos gerados:
        - Build report e bundle de componentes
        - Documentação do Pattern Library
        - Relatório de acessibilidade WCAG AA
        - Dashboard de ROI e métricas

        Próximos passos sugeridos:
        - Revisar violações de a11y identificadas
        - Publicar nova versão do Design System
        - Compartilhar métricas de ROI com stakeholders

  flow_diagram: |
    ```mermaid
    graph TD
        A[Start: Design System Quality Pipeline] --> B[ux-design-expert: Build componentes atômicos]
        B --> C{Build OK?}
        C -->|Sim| D[ux-design-expert: Gerar documentação Pattern Library]
        C -->|Não| E[Corrigir erros de build]
        E --> B

        D --> F{Docs completas?}
        F -->|Sim| G[ux-design-expert: Auditoria a11y WCAG AA]
        F -->|Não| H[Completar documentação]
        H --> D

        G --> I{a11y aprovado?}
        I -->|Sim| J[ux-design-expert: Calcular ROI e savings]
        I -->|Não| K[Remediar violações]
        K --> G

        J --> L[Pipeline Completo]

        style L fill:#90EE90
        style B fill:#E6E6FA
        style D fill:#E6E6FA
        style G fill:#E6E6FA
        style J fill:#E6E6FA
        style E fill:#FFB6C1
        style H fill:#FFB6C1
        style K fill:#FFB6C1
    ```

  decision_guidance:
    when_to_use:
      - Após migração de Design System
      - Release de nova versão do Pattern Library
      - Auditoria periódica de qualidade
      - Validação pré-produção de componentes
      - Geração de métricas para stakeholders

  handoff_prompts:
    build_complete: |
      Build de componentes concluído com sucesso.
      Tokens compilados: {{token_count}}
      Componentes gerados: {{component_count}}
      Prosseguindo para documentação...

    docs_complete: |
      Documentação do Pattern Library gerada.
      Componentes documentados: {{documented_count}}
      Exemplos criados: {{example_count}}
      Iniciando auditoria de acessibilidade...

    a11y_complete: |
      Auditoria de acessibilidade WCAG AA concluída.
      Status: {{pass/fail}}
      Violações críticas: {{critical_count}}
      Violações menores: {{minor_count}}
      {{if pass}}: Prosseguindo para cálculo de ROI.
      {{if fail}}: Revisar remediation_plan antes de continuar.

    pipeline_complete: |
      Pipeline de qualidade finalizado!

      Resumo:
      - Build: {{build_status}}
      - Documentação: {{docs_status}}
      - Acessibilidade: {{a11y_status}}
      - ROI calculado: {{roi_value}}

      Artefatos disponíveis em outputs/design-system/

metadata:
  author: Orion (AIOX Master)
  created_date: 2025-01-30
  version: 1.0.0
  tags:
    - design-system
    - quality-assurance
    - accessibility
    - documentation
    - roi
    - brownfield