# Vibe Frontend Agents v2

Pacote de instruções para orientar ferramentas de Vibe Coding e agentes de IA em projetos frontend.
A versão 2 transforma o `AGENTS.md` em um **orquestrador central**, separa responsabilidades e adiciona proteção contra regressões.

## Estrutura

```text
AGENTS.md                 Orquestrador e regras globais
agents/                   Papéis especializados
skills/                   Guias técnicos reutilizáveis
prompts/                  Entradas prontas para tarefas comuns
checklists/               Conferência antes e depois de alterações
```

## Como instalar

Copie `AGENTS.md`, `agents/`, `skills/`, `prompts/` e `checklists/` para a raiz do projeto.

> Importante: o suporte automático a `AGENTS.md` varia entre ferramentas. Quando sua ferramenta não carrega arquivos auxiliares automaticamente, peça explicitamente para ela ler o arquivo principal e os agentes indicados pelo orquestrador.

## Fluxo recomendado — projeto existente

1. `prompts/auditar-projeto.md`
2. revisar diagnóstico quando a tarefa exigir auditoria formal;
3. `prompts/melhorar-frontend.md` ou prompt especializado;
4. implementar;
5. `prompts/revisao-final.md`.

## Fluxo recomendado — dashboard

Use `prompts/criar-dashboard.md`.

## Fluxo recomendado — landing page

Use `prompts/criar-site.md`.

## Fluxo recomendado — correção mobile

Use `prompts/fix-mobile.md`.

## Filosofia

O pacote prioriza:
- análise antes de edição;
- menor mudança segura;
- preservação do backend e regras de negócio;
- consistência visual;
- estados completos de interface;
- responsividade;
- acessibilidade;
- validação e prevenção de regressões.

## Ordem dos agentes

```text
00 Project Analyzer
01 Codebase Guardian
02 UI/UX
03 Design System
04 Frontend
05 Forms
06 Dashboard
07 Landing Page
08 Responsive
09 Accessibility
10 SEO
11 Performance
12 Visual QA
13 Regression Check
```

Nem todos são usados em toda tarefa. O `AGENTS.md` explica a seleção.

## Compatibilidade

O conteúdo foi escrito de forma agnóstica a editor/agente. Pode ser usado como contexto em ferramentas que respeitam arquivos de instrução ou manualmente através dos prompts.