---
title: "O Manifesto Vibe Coding"
summary: "Uma declaração de princípios para construir software com agentes de IA sem abrir mão de direção humana, validação e simplicidade."
slug: "manifesto-vibe-coding"
language: "pt"
publishedAt: "2026-05-20"
updatedAt: null
tags:
  - "manifesto"
  - "vibe coding"
  - "processo"
translationOf: null
translationStatus: "original"
---

Nós estamos descobrindo maneiras melhores de desenvolver software em parceria com agentes de Inteligência Artificial.

Através deste trabalho, passamos a valorizar:

- **A direção clara e o contexto estruturado** mais do que a simples geração passiva de código.
- **O avanço incremental validado** mais do que entregas monolíticas desenfreadas.
- **A compreensão humana e a simplicidade** mais do que as abstrações prematuras da máquina.
- **A rastreabilidade e a documentação viva** mais do que a velocidade sem controle.

Mesmo que os itens à direita tenham seu valor, nós priorizamos os itens à esquerda.

## Nossos princípios

### I. Assumimos a cadeira de diretor

Nós não pedimos apenas código. Nós dirigimos agentes muito rápidos.

Estabelecemos o ambiente. Definimos as regras. Delimitamos as fronteiras de atuação.

### II. Respeitamos o ritmo do pensamento

Nós não misturamos exploração, planejamento e implementação.

Primeiro exploramos a ideia. Depois planejamos as etapas. Só então damos a ordem de construir.

### III. Celebramos a etapa única

Recusamos o impulso de criar o sistema inteiro de uma vez.

Preferimos implementar, revisar e validar uma pequena etapa por ciclo.

### IV. Exigimos explicabilidade

Não aceitamos código que não conseguimos explicar.

Se a arquitetura se torna ininteligível para a mente humana, a velocidade deixou de ajudar.

### V. Validamos incessantemente

Nenhuma linha de código está pronta sem prova de funcionamento.

Validação não é burocracia. É o contrato mínimo entre intenção e realidade.

### VI. Protegemos o histórico

Usamos Git desde o primeiro ciclo.

Commits pequenos e bem descritos preservam contexto, reduzem medo e tornam o avanço reversível.

### VII. Governamos pelo contexto

Reconhecemos o arquivo `AGENTS.md` como a constituição do projeto.

Ele registra regras, critérios, limites e modo de trabalho.

### VIII. Modelamos antes de persistir

Respeitamos a estrutura dos dados.

Antes de escrever lógica de negócio, documentamos entidades, campos, relações e regras.

### IX. Restringimos para libertar

Limitamos a criatividade técnica da máquina para proteger a manutenção do produto.

A solução mais simples que funciona costuma ser a melhor primeira solução.

### X. Cultivamos a memória do projeto

Documentação viva preserva o porquê das decisões.

Sem memória, cada nova sessão tenta reconstruir o projeto do zero.

## Um exemplo de ciclo

```txt
1. Escreva o objetivo da etapa.
2. Diga quais arquivos podem mudar.
3. Implemente pouco.
4. Rode lint, teste e build.
5. Revise o diff.
6. Registre riscos e próximos passos.
```

Vibe coding não é abdicar da engenharia.

É usar IA sem abandonar direção, critério e responsabilidade.