Manual do Vibe Jera

Jera Capital — Autor: Iury Almeida, CTO — Abril 2026

1. Bem-vindo ao Programa

Você foi convidado a participar do Vibe Jera, o programa interno de citizen development da Jera Capital. Isso significa que você vai poder construir aplicações internas para resolver problemas da sua área — dashboards, ferramentas, automações — sem depender de uma fila na área de tecnologia.

O que você vai fazer

Você vai descrever o que precisa em linguagem natural, e uma IA (Claude Code Desktop) vai implementar a solução técnica. Seu papel é dirigir o problema: explicar o que precisa ser feito, para quem, e por quê. A IA dirige a implementação.

O que você não precisa saber

Não precisa saber programar.
Não precisa entender a stack técnica em detalhe.
Não precisa configurar servidores, bancos de dados ou infraestrutura.

Tudo isso é feito automaticamente pela plataforma e pelas ferramentas que a área de tecnologia preparou.

O que se espera de você

Que siga as regras do programa (estão neste manual).
Que trabalhe dentro das ferramentas aprovadas (sem atalhos).
Que peça ajuda quando tiver dúvida, em vez de improvisar.

2. Antes de Começar

O que a área de tecnologia configura para você

Quando seu projeto for aprovado, a área de tecnologia vai preparar tudo:

Uma conta no GitHub (onde o código do seu projeto fica).
Uma licença do Claude Premium com acesso ao Claude Code Desktop.
O repositório do seu projeto, já com tudo configurado.
O banco de dados, autenticação, deploy e monitoramento.

Você não precisa criar conta em nenhum serviço. Isso é responsabilidade exclusiva da área de tecnologia.

O que você precisa ter no seu computador

Claude Code Desktop

O aplicativo da Anthropic onde você vai trabalhar

Git

Controle de versão (onde seu código é salvo)

Node.js 24+

O motor que roda o projeto

Se Git ou Node.js não estiverem instalados, não se preocupe. Quando você abrir o Claude Code Desktop pela primeira vez no projeto, ele vai detectar o que falta e te guiar na instalação passo a passo.

Seu contato na área de tecnologia

Para qualquer solicitação relacionada ao programa, envie um e-mail para dev-requests@jeracapital.com.br.

Use esse canal para: tirar dúvidas sobre o programa, pedir novas variáveis de ambiente, solicitar acesso a dados corporativos, pedir reclassificação do tier do seu projeto, ou reportar problemas técnicos.

3. Como Propor um Projeto

Antes de começar a desenvolver, seu projeto precisa ser aprovado pela área de tecnologia. O processo é simples.

O que incluir na proposta

Envie um e-mail para dev-requests@jeracapital.com.br explicando:

Qual problema você quer resolver

"Hoje a equipe preenche uma planilha manual de despesas toda semana, com erros frequentes."

Quem vai usar a aplicação

"Toda a equipe de operações, 8 pessoas."

Qual o benefício esperado

"Eliminar retrabalho manual e ter visibilidade em tempo real."

Qual líder da sua área apoia o projeto

"João da Silva, head de operações."

Não precisa de documento formal. Os quatro pontos acima são suficientes.

O que acontece depois

A área de tecnologia avalia a proposta em até 2 dias úteis e responde com uma das opções:

Aprovado — com a classificação de risco (tier) do projeto definida.
Aprovado com ajustes — o escopo precisa de alguma mudança.
Recusado — com justificativa.

Após a aprovação, a área de tecnologia provisiona toda a infraestrutura em até 3 dias úteis. Quando tudo estiver pronto, você recebe os acessos e pode começar.

4. Como Desenvolver

Abrindo o projeto

Abra o Claude Code Desktop no seu computador.
Selecione a pasta do seu projeto.

O Claude Code Desktop já vem configurado com todas as regras do programa.

O ciclo de desenvolvimento

Passo 1 — Descreva o que você quer

Explique o comportamento desejado em linguagem natural. Exemplo:

"Quero uma tela onde o admin pode cadastrar uma nova despesa 
com valor, categoria e data. A lista de despesas deve mostrar 
todas as entradas para todos os usuários autorizados."

Passo 2 — O Claude Code propõe um plano

Ele vai listar os comportamentos e pedir sua confirmação:

Vou construir:
1. Admin pode cadastrar uma nova despesa
2. Lista de despesas mostra todas as entradas
3. Cada entrada mostra valor, categoria e data
4. Estado vazio mostra mensagem quando não há despesas

Vou construir um de cada vez, com testes. Pode seguir?

Passo 3 — Ele implementa, um comportamento por vez

Para cada item do plano, o Claude Code: escreve um teste, implementa o código mínimo para o teste passar, verifica se tudo está correto, e salva o progresso com uma mensagem clara.

Passo 4 — Você valida

Após cada comportamento, verifique se o resultado está correto. Se precisar de ajustes, descreva o que precisa mudar.

Vendo o projeto no navegador

Para ver a aplicação funcionando, peça ao Claude Code:

"Rode o projeto para eu ver no navegador."

Ele vai iniciar o servidor local e te informar o endereço (geralmente http://localhost:3000).

5. Como Enviar seu Trabalho para Revisão

Quando terminar uma funcionalidade, você precisa enviá-la para revisão antes que ela vá para produção. Isso é feito através de um Pull Request (PR).

O processo

Passo 1 — Peça ao Claude Code para criar o PR

"Crie um PR com tudo que fizemos."

Ele vai revisar o código, verificar se tudo está passando, e criar o PR automaticamente.

Passo 2 — Aguarde a revisão

Tier	O que acontece	Prazo
Tier 1 (primeiro deploy)	Revisão leve	1 dia útil
Tier 1 (deploys seguintes)	Automático	Imediato
Tier 2	Revisão de pontos críticos	1 dia útil
Tier 3	Revisão completa (2 engenheiros)	2 dias úteis

Passo 3 — Se houver feedback, ajuste

Use o Claude Code para implementar as correções e atualizar o PR.

Preview: Toda vez que você envia código, um preview da aplicação é gerado automaticamente. Use isso para validar com colegas antes da aprovação final.

6. Regras do Programa

Estas regras existem para proteger a Jera, proteger você e manter a qualidade. Elas são aplicadas automaticamente na maioria dos casos.

Regras de infraestrutura

Nunca crie contas em serviços externos. Não contrate, assine ou crie contas em Supabase, Firebase, AWS, Google Cloud, ou qualquer outro serviço.

Nunca instale ferramentas que substituam a stack aprovada. O Claude Code vai bloquear automaticamente se você tentar.

Nunca modifique arquivos de configuração de autenticação ou deploy. Esses arquivos são gerenciados por engenharia.

Regras de segurança

Nunca coloque senhas, chaves ou tokens no código. Peça à área de tecnologia para configurar como variável de ambiente.

Nunca manipule dados sensíveis sem aprovação. Dados financeiros com escrita e dados pessoais (PII) elevam seu projeto para Tier 3.

Regras de desenvolvimento

Sempre trabalhe em uma branch separada. Nunca faça mudanças diretamente na main.
Sempre tenha testes. O Claude Code escreve os testes junto com o código.
PRs devem ter menos de 1.000 linhas. Se for grande, divida em partes menores.

Se uma regra te impedir de fazer algo: Não tente contornar. Envie um e-mail para dev-requests. Se fizer sentido, engenharia vai encontrar o caminho correto.

7. Classificação de Risco do Seu Projeto

Cada projeto tem um nível de risco que define quanta supervisão de engenharia é necessária.

Tier 1 — Baixo Risco

Só mostra dados, não mexe com dados financeiros ou pessoais, não se conecta a sistemas externos.

Exemplos: dashboard de indicadores, calculadora interna

Tier 2 — Risco Médio

Grava dados, conecta com APIs externas, usado por vários departamentos, ou mostra dados financeiros.

Exemplos: ferramenta de cadastro, integração com fornecedor

Tier 3 — Alto Risco

Escreve dados financeiros, manipula dados pessoais, visível para clientes, ou dispara pagamentos.

Exemplos: registra movimentações financeiras, app para clientes

Quando o tier muda: Se durante o desenvolvimento o escopo mudar, pare e avise a área de tecnologia. O tier precisa ser reclassificado antes de você continuar.

8. Quando Falar com a Área de Tecnologia

Nem tudo pode ser resolvido dentro do Claude Code. Aqui está um guia rápido:

Situação	O que fazer
Preciso de uma variável de ambiente ou credencial	E-mail para dev-requests
Preciso de dados que estão em outro sistema	E-mail para dev-requests — engenharia constrói uma API
Quero usar um serviço que não está na lista aprovada	E-mail para dev-requests — nunca crie contas por conta própria
O Claude Code diz que algo precisa de aprovação	E-mail para dev-requests
Meu projeto mudou de escopo	E-mail para dev-requests antes de continuar
O preview ou o deploy não está funcionando	E-mail para dev-requests
Não sei se o que quero fazer é permitido	Pergunte ao Claude Code primeiro; se ele não souber, e-mail
Quero desativar meu projeto	E-mail para dev-requests

Regra geral: Na dúvida, pergunte. É sempre melhor perguntar antes do que corrigir depois.

9. Depois do Deploy

Quando seu projeto for aprovado e entrar em produção:

Você é o dono da aplicação. Se algo parar de funcionar ou usuários reportarem problemas, você é o primeiro ponto de contato.
Engenharia cuida da infraestrutura. Servidores, banco de dados e monitoramento são responsabilidade da área de tecnologia.
Para projetos Tier 2+, você terá check-ins mensais com engenharia para acompanhar a saúde do projeto.
Para adicionar novas funcionalidades, siga o mesmo processo: descreva para o Claude Code, implemente, crie um PR, aguarde revisão.

Se o projeto não for mais necessário, envie um e-mail para dev-requests. Ele será desativado de forma organizada — o código fica arquivado, a infraestrutura é desligada.

10. Referência Rápida

Exemplos de coisas que você pode pedir ao Claude Code

“Crie uma tela para cadastrar despesas.”

“Adicione um filtro por data na lista.”

“O que esse erro significa?”

“Rode o projeto para eu ver no navegador.”

“Crie um PR com tudo que fizemos.”

“Rode os testes para ver se está tudo certo.”

Checklist antes de criar um PR

Todos os comportamentos do plano foram implementados.
Eu validei a aplicação no navegador.
O Claude Code confirmou que testes, tipos e formatação estão passando.

Contato

dev-requests@jeracapital.com.br

O que nunca fazer

Criar contas em serviços externos (Supabase, Firebase, AWS, etc.).

Colocar senhas ou chaves no código.

Modificar arquivos de autenticação ou configuração de deploy.

Tentar contornar uma regra que o Claude Code bloqueou.

Fazer mudanças diretamente na branch main.