01Skills
Como eu trabalho.
Os princípios por trás das minhas decisões de engenharia, as skills que uso no Claude Code e os arquivos que mantenho no dia a dia. Cada princípio diz o que eu faço, por que faço e o que isso custa. Os arquivos estão abertos: copie o que servir.
02Princípios
- 01
Isolamento de dados no banco
Em sistema com vários clientes, quem separa os dados de cada um é o banco, com RLS no PostgreSQL. O app conecta com uma role que não ignora as regras, e o cliente ativo vem da sessão, validado no banco, nunca de um campo do formulário.
- Por quê
- Um bug na aplicação não vaza dado de um cliente para outro.
- Custo aceito
- Toda tabela nova precisa de policy, e toda query roda dentro de uma transação com o contexto do usuário.
- 02
Deploy que se protege
Só vai para produção o commit aprovado no CI. As migrations rodam antes da troca da versão, e uma migration que falha barra o deploy. Se a versão nova não responde ao health check, o servidor volta sozinho para a anterior.
- Por quê
- Deploy vira rotina: dá para publicar várias vezes por dia sem medo.
- Custo aceito
- Um pipeline mais elaborado do que copiar arquivo para o servidor.
- 03
Verificação do tamanho do risco
O pré-commit formata e confere só os arquivos alterados. O CI verifica o projeto inteiro quando mudam dependências, configuração ou schema, e compara sempre com o último deploy que deu certo.
- Por quê
- Resposta rápida no dia a dia, sem deixar passar a mudança que afeta tudo.
- Custo aceito
- Regras de CI mais cuidadosas, que precisam de manutenção.
- 04
IA com critério
Uso agentes de código o dia todo, com regras claras: o agente não commita, não publica e não mexe em produção sem permissão, não pula o pré-commit e não diz que algo está pronto sem verificar. Chave de API nunca passa pelo chat.
- Por quê
- Ganho a velocidade da IA sem perder o controle do que chega em produção.
- Custo aceito
- Mais pontos de confirmação durante o trabalho.
- 05
Interface que evita erro
Formulário já vem preenchido com o padrão mais provável, e ação crítica (excluir, pagar, enviar) nunca vem pré-escolhida. A validação acontece no navegador, para responder rápido, e de novo no servidor, que decide. Tela nova já nasce com os estados de carregando, erro e vazio.
- Por quê
- Menos trabalho para quem usa, e menos erro que dava para evitar.
- Custo aceito
- Mais estados para desenhar e implementar em cada tela.
- 06
Decisão registrada
Regra de negócio, decisão de interface e armadilha descoberta ficam documentadas no repositório, com data e motivo, na mesma alteração do código. O README diz como rodar o projeto e onde fica cada chave.
- Por quê
- Quem chega ao projeto, pessoa ou agente de IA, entende o contexto sem depender de quem já estava lá.
- Custo aceito
- Atualizar a documentação junto com o código, sempre.
03Skills que uso
- impeccable · Paul Bakaus: desenha, revisa e audita interfaces, da hierarquia ao acabamento.
- frontend-design · Anthropic: direção visual e tipografia com identidade, longe do visual de template.
- emil-design-eng · Emil Kowalski: acabamento de componentes e animações, os detalhes que fazem a interface parecer boa.
- humanizer · blader: tira do texto as marcas de escrita de IA. Todo texto deste site passou por ela.
- copywriting · Corey Haines: texto de landing page, home e páginas de venda.
- graphify · Graphify Labs: transforma um código em grafo para responder perguntas de arquitetura.
04Arquivos
As versões completas das regras acima e as configurações do meu terminal e do editor. São genéricas e servem em qualquer projeto: ajuste o idioma e a stack ao seu caso.
Instruçõesclaude-md.md
Instruções globais do Claude
O que o Claude Code segue em todos os meus projetos: permissões do agente, documentação, interfaces, migrations, seeds e variáveis de ambiente.
Abrir →
Instruçõespreferencias.md
Como trabalhar com agentes de código
Conversa, ritmo, o que nunca fazer sem permissão, produção e documentação: como trabalhar com um agente de código.
Abrir →
Instruçõespadroes-projeto.md
Padrões de projeto
Git, pré-commit, CI, deploy, banco, variáveis, seeds e documentação. Pensado para Next.js com PostgreSQL, adaptável a outra stack.
Abrir →
Instruçõespadroes-frontend.md
Padrões de frontend
Formulários, textos de interface, listas, estados, URL, acessibilidade e layout, com os princípios por trás de cada regra.
Abrir →
Configconfig.fish
fish
O shell, com Starship, zoxide e as cores do tema Vesper no realce de sintaxe.
Abrir →
Configstarship.toml
Starship
O prompt do terminal: pasta, branch, status do git e versão do Node, nas cores do Vesper.
Abrir →
Configvscode-settings.json
VS Code
Tema Vesper, JetBrains Mono com ligaduras, réguas em 80 e 120 e ESLint ao salvar.
Abrir →