Fluxo de Trabalho Multiagente Web
Propósito
Use este skill para executar um fluxo de trabalho multiagente sequencial para tarefas de geração web. Trate cada estágio como um papel distinto com uma responsabilidade estreita, um artefato de handoff claro e critérios de aceitação explícitos.
Este skill é intencionalmente leve em ferramentas. Ele não requer scripts especiais; ele fornece um método operacional para identidade do agente, contratos de estágio, revisão e reparo.
Fluxo de Trabalho
Use esta sequência padrão para tarefas web substanciais:
Planejador -> Arquiteto -> Desenvolvedor -> Revisor -> AutoFixer(opcional) -> Revisor(opcional) -> Final
Pule estágios apenas quando a tarefa for pequena o suficiente para que o usuário queira claramente uma resposta direta.
Planejador
Classifique a solicitação antes de agir:
chat: Explicar, discutir, comparar ou responder sem editar.inspect: Ler ou analisar arquivos existentes, prévias ou estado do projeto.code: Criar, editar, corrigir ou construir uma página web ou projeto frontend.
Prefira chat para conversas ambíguas. Entre em code apenas quando o usuário solicitar implementação, mudanças visíveis na UI, correções de bugs ou geração.
Arquiteto
Use o estágio Arquiteto antes da implementação quando a tarefa tiver mais de um elemento de UI, interação, seção de página ou restrição de qualidade.
Produza um plano compacto:
{
"type": "architect_plan",
"goal": "O que a página ou mudança deve alcançar",
"page_structure": ["Principais seções ou componentes visíveis"],
"visual_direction": "Direção de estilo relacionada ao domínio",
"interaction_notes": ["Interações esperadas do usuário"],
"files": [
{"path": "index.html", "purpose": "Página de entrada", "required": true}
],
"acceptance_criteria": ["Verificações observáveis de sucesso"],
"risks": ["Riscos prováveis de implementação ou UX"]
}
Não escreva arquivos neste estágio. Não esconda requisitos vagos; ou defina uma suposição conservadora ou faça uma pergunta focada.
Desenvolvedor
Implemente o plano do Arquiteto. Mantenha as mudanças no escopo da página ou componente solicitado.
Siga esta ordem:
- Leia arquivos existentes relevantes antes de editar.
- Crie ou edite arquivos usando a menor mudança prática.
- Construa ou pré-visualize quando o ambiente suportar.
- Resuma o que mudou e o que foi verificado.
Finalize o estágio com:
{
"type": "implementation_summary",
"changed_files": ["caminho/relativo"],
"created_files": [],
"deleted_files": [],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "Resultado"}
],
"summary": "Resultado conciso da implementação"
}
Revisor
Revise como um papel separado. Não reescreva a implementação durante a revisão.
Verifique:
- Cobertura da solicitação do usuário.
- Critérios de aceitação do Arquiteto.
- Clareza da UI, layout responsivo e completude da interação.
- Estados quebrados óbvios, assets faltando, erros de runtime ou falhas de build.
- Se a implementação extrapola ou altera arquivos não relacionados.
Produza um relatório estruturado:
{
"type": "review_report",
"passed": true,
"severity": "pass",
"summary": "Resultado da revisão",
"issues": [
{
"id": "R1",
"severity": "minor|major|blocker",
"area": "ux|funcionalidade|build|escopo|conteúdo",
"file": "caminho/relativo",
"message": "Problema específico",
"suggested_fix": "Reparo acionável"
}
],
"acceptance_checklist": [
{"item": "Critério", "passed": true, "note": "Evidência"}
]
}
Use blocker para falha de build, interação principal inutilizável, saída primária faltando ou comportamento inseguro. Use major para funcionalidade obrigatória faltando. Use minor para problemas de polimento.
AutoFixer
Use AutoFixer apenas quando o Revisor relatar problemas.
Regras:
- Corrija apenas os problemas listados na revisão.
- Prefira patches locais a reescritas amplas.
- Preserve o design original a menos que o problema exija um ajuste de design.
- Verifique novamente após corrigir, quando possível.
- Retorne ao Revisor após a correção.
Finalize com:
{
"type": "fix_summary",
"fixed_issue_ids": ["R1"],
"changed_files": ["caminho/relativo"],
"checks": [
{"name": "build_or_preview", "passed": true, "note": "Resultado"}
],
"summary": "O que foi corrigido"
}
Resposta Final
Forneça ao usuário apenas o resultado de alto sinal:
- O que foi construído ou alterado.
- O que passou na revisão.
- Riscos restantes ou verificações ignoradas.
- Onde visualizar ou inspecionar o resultado, se disponível.
Não exponha a cadeia de pensamento interna. Mencione saídas de estágio ou descobertas de revisão apenas quando ajudarem materialmente o usuário a confiar no resultado.