full-stack-orchestration-full-stack-feature

Use esta habilidade quando

• Trabalhando em tarefas ou fluxos de trabalho de recursos de orquestração full stack
• Precisando de orientação, melhores práticas ou checklists para recursos de orquestração full stack

Não use esta habilidade quando

• A tarefa não estiver relacionada a recursos de orquestração full stack
• Você precisar 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.

Orquestre o desenvolvimento de recursos full-stack entre as camadas de backend, frontend e infraestrutura com uma abordagem moderna API-first:

[Pensamento estendido: Este fluxo de trabalho coordena múltiplos agentes especializados para entregar um recurso full-stack completo, desde a arquitetura até a implantação. Ele segue os princípios de desenvolvimento API-first, garantindo desenvolvimento orientado por contrato onde a especificação da API direciona tanto a implementação do backend quanto o consumo do frontend. Cada fase se baseia nas saídas anteriores, criando um sistema coeso com separação adequada de responsabilidades, testes abrangentes e implantação pronta para produção. O fluxo de trabalho enfatiza práticas modernas como desenvolvimento de UI baseado em componentes, feature flags, observabilidade e estratégias de rollout progressivo.]

Fase 1: Fundação de Arquitetura e Design

1. Design da Arquitetura do Banco de Dados

• Use a ferramenta Task com subagent_type="database-design::database-architect"
• Prompt: "Projete o esquema do banco de dados e os modelos de dados para: $ARGUMENTS. Considere escalabilidade, padrões de consulta, estratégia de indexação e requisitos de consistência de dados. Inclua estratégia de migração se estiver modificando o esquema existente. Forneça modelos de dados lógicos e físicos."
• Saída esperada: Diagramas de relacionamento de entidade, esquemas de tabela, estratégia de indexação, scripts de migração, padrões de acesso a dados
• Contexto: Requisitos iniciais e modelo de domínio de negócios

2. Arquitetura do Serviço de Backend

• Use a ferramenta Task com subagent_type="backend-development::backend-architect"
• Prompt: "Projete a arquitetura do serviço de backend para: $ARGUMENTS. Usando o design do banco de dados da etapa anterior, crie limites de serviço, defina contratos de API (OpenAPI/GraphQL), projete a estratégia de autenticação/autorização e especifique padrões de comunicação entre serviços. Inclua padrões de resiliência (circuit breakers, retries) e estratégia de cache."
• Saída esperada: Diagrama de arquitetura de serviço, especificações OpenAPI, fluxos de autenticação, arquitetura de cache, design de fila de mensagens (se aplicável)
• Contexto: Esquema do banco de dados da etapa 1, requisitos não funcionais

3. Arquitetura de Componentes de Frontend

• Use a ferramenta Task com subagent_type="frontend-mobile-development::frontend-developer"
• Prompt: "Projete a arquitetura de frontend e a estrutura de componentes para: $ARGUMENTS. Com base nos contratos de API da etapa anterior, projete a hierarquia de componentes, a abordagem de gerenciamento de estado (Redux/Zustand/Context), a estrutura de roteamento e os padrões de busca de dados. Inclua requisitos de acessibilidade e estratégia de design responsivo. Planeje a documentação de componentes com Storybook."
• Saída esperada: Diagrama de árvore de componentes, design de gerenciamento de estado, configuração de roteamento, plano de integração de design system, checklist de acessibilidade
• Contexto: Especificações de API da etapa 2, requisitos de UI/UX

Fase 2: Implementação Paralela

4. Implementação do Serviço de Backend

• Use a ferramenta Task com subagent_type="python-development::python-pro" (ou "golang-pro"/"nodejs-expert" com base na stack)
• Prompt: "Implemente os serviços de backend para: $ARGUMENTS. Usando a arquitetura e as especificações de API da Fase 1, construa endpoints RESTful/GraphQL com validação adequada, tratamento de erros e logging. Implemente a lógica de negócios, a camada de acesso a dados, o middleware de autenticação e a integração com serviços externos. Inclua observabilidade (logging estruturado, métricas, tracing)."
• Saída esperada: Código do serviço de backend, endpoints de API, middleware, jobs em background, testes unitários, testes de integração
• Contexto: Designs de arquitetura da Fase 1, esquema do banco de dados

5. Implementação de Frontend

• Use a ferramenta Task com subagent_type="frontend-mobile-development::frontend-developer"
• Prompt: "Implemente o aplicativo frontend para: $ARGUMENTS. Construa componentes React/Next.js usando a arquitetura de componentes da Fase 1. Implemente o gerenciamento de estado, a integração de API com tratamento de erros e estados de carregamento adequados, validação de formulários e layouts responsivos. Crie histórias do Storybook para os componentes. Garanta a acessibilidade (conformidade WCAG 2.1 AA)."

…