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

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.