Fluxo de Trabalho de Desenvolvimento de Recursos Multiplataforma

Crie e implante o mesmo recurso de forma consistente em plataformas web, móveis e desktop usando arquitetura API-first e estratégias de implementação paralelas.

[Pensamento expandido: Este fluxo de trabalho orquestra múltiplos agentes especializados para garantir a paridade de recursos entre as plataformas, mantendo otimizações específicas de cada plataforma. A estratégia de coordenação enfatiza contratos compartilhados e desenvolvimento paralelo com pontos de sincronização regulares. Ao estabelecer contratos de API e modelos de dados antecipadamente, as equipes podem trabalhar de forma independente, garantindo a consistência. Os benefícios do fluxo de trabalho incluem um tempo de lançamento no mercado mais rápido, redução de problemas de integração e bases de código multiplataforma manteníveis.]

Use esta habilidade quando

• Trabalhando em tarefas ou fluxos de trabalho de desenvolvimento de recursos multiplataforma
• Precisando de orientação, melhores práticas ou checklists para o fluxo de trabalho de desenvolvimento de recursos multiplataforma

Não use esta habilidade quando

• A tarefa não está relacionada ao fluxo de trabalho de desenvolvimento de recursos multiplataforma
• Você precisa de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.
• Se exemplos detalhados forem necessários, abra resources/implementation-playbook.md.

Fase 1: Arquitetura e Design de API (Sequencial)

1. Definir Requisitos de Recurso e Contratos de API

• Use a ferramenta Tarefa com subagent_type="backend-architect"
• Prompt: "Projete o contrato de API para o recurso: $ARGUMENTS. Crie a especificação OpenAPI 3.1 com:
  • Endpoints RESTful com métodos HTTP e códigos de status adequados
  • Esquema GraphQL, se aplicável para consultas de dados complexas
  • Eventos WebSocket para recursos em tempo real
  • Esquemas de solicitação/resposta com regras de validação
  • Requisitos de autenticação e autorização
  • Estratégias de limitação de taxa e cache
  • Formatos e códigos de resposta de erro Defina modelos de dados compartilhados que todas as plataformas consumirão."
• Saída esperada: Especificação completa da API, modelos de dados e diretrizes de integração

2. Projetar Consistência de Sistema e UI/UX

• Use a ferramenta Tarefa com subagent_type="ui-ux-designer"
• Prompt: "Crie um sistema de design multiplataforma para o recurso usando a especificação da API: [saída anterior]. Inclua:
  • Especificações de componentes para cada plataforma (Material Design, iOS HIG, Fluent)
  • Layouts responsivos para web (abordagem mobile-first)
  • Padrões nativos para iOS (SwiftUI) e Android (Material You)
  • Considerações específicas para desktop (atalhos de teclado, gerenciamento de janelas)
  • Requisitos de acessibilidade (WCAG 2.2 Nível AA)
  • Especificações de temas claro/escuro
  • Diretrizes de animação e transição"
• Contexto anterior: endpoints da API, estruturas de dados, fluxos de autenticação
• Saída esperada: Documentação do sistema de design, especificações da biblioteca de componentes, diretrizes de plataforma

3. Arquitetura de Lógica de Negócios Compartilhada

• Use a ferramenta Tarefa com subagent_type="comprehensive-review::architect-review"
• Prompt: "Projete a arquitetura de lógica de negócios compartilhada para o recurso multiplataforma. Defina:
  • Modelos e entidades de domínio principais (agnósticos de plataforma)
  • Regras de negócios e lógica de validação
  • Padrões de gerenciamento de estado (MVI/Redux/BLoC)
  • Estratégias de cache e offline
  • Políticas de tratamento de erros e retentativa
  • Padrões de adaptador específicos da plataforma Considere Kotlin Multiplatform para compartilhamento móvel ou TypeScript para web/desktop."
• Contexto anterior: contratos de API, modelos de dados, requisitos de UI
• Saída esperada: Arquitetura de código compartilhado, camadas de abstração de plataforma, guia de implementação

Fase 2: Implementação Paralela de Plataforma

4a. Implementação Web (React/Next.js)

• Use a ferramenta Tarefa com subagent_type="frontend-developer"
• Prompt: "Implemente a versão web do recurso usando:
  • React 18+ com Next.js 14+ App Router
  • TypeScript para segurança de tipos
  • TanStack Query para integração de API: [especificação da API]
  • Zustand/Redux Toolkit para gerenciamento de estado
  • Tailwind CSS com o sistema de design: [especificações de design]
  • Capacidades de Progressive Web App
  • Otimização SSR/SSG onde apropriado
  • Otimização de Web Vitals (LCP < 2,5s, FID < 100ms) Siga a lógica de negócios compartilhada: [documento de arquitetura]"
• Contexto anterior: contratos de API, sistema de design, padrões de lógica compartilhada
• Saída esperada: Implementação web completa com testes

4b. Implementação iOS (SwiftUI)

• Use a ferramenta Tarefa com subagent_type="ios-developer"
• Prompt: "Implemente a versão iOS usando:
  • SwiftUI com recursos do iOS 17+

…