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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.