// Agentes e skills //

roda no Claude Code

Uma skill para o Claude Code que faz o Claude conduzir um projeto de software com método, em qualquer stack. Serve a quem nunca programou e quer tirar um produto do papel, e a dev experiente que quer rigor sem burocracia. A regra central: o estado do projeto mora em documentos de casa fixa dentro do próprio repositório. A décima sessão começa como a primeira, porque o Claude lê onde o projeto está em vez de adivinhar. Ela decide o que é de engenharia e pergunta o que é do dono: produto, produção e dinheiro. Ela sempre começa descobrindo a situação. Um script lê a pasta, sem alterar nada, e diz em qual das cinco o projeto está: do zero (entrevista, especificação, stack com registro de decisões, dados e permissões antes das telas, fases com "pronto quando"); projeto existente (levantamento só de leitura e o mínimo de documentos para começar); fase ou mudança (implementar no local, verificar, revisar, commit pequeno); ida a produção (portões, lista do que só o dono faz, ordem banco, dados e código, conferência como visitante); e retomada (lê o estado do disco, reconfere o que tem data e relata). O que ela entrega: seis documentos no projeto, criados a partir de modelos e nunca sobrescritos (metodo.ini, a especificação, o arquivo de instruções, o registro de decisões, o roteiro de fases e o estado); a escada de verificação, com os comandos do projeto em degraus (lint, tipos, testes, build, ponta a ponta) e a evidência gravada, em que o relato separa o que rodou do que foi inferido; a conferência antes do envio, que procura segredo, arquivo proibido e evidência vencida no que vai sair, e só lê, nunca envia; regras de arquitetura que viram verificação, com um conferidor que lê o código-fonte e acusa quem furou uma fronteira; 23 fichas de consulta, uma por assunto, das quais o Claude abre só a do passo em que está; e 17 modelos de documento, um projeto de exemplo fictício já preenchido e 11 moldes de código para app web com banco relacional. Limites: a skill conduz o método; ela não escreve o produto sozinha nem escolhe a stack por você sem perguntar o que é decisão sua. Nenhum script toca produção, envia código ou acessa a rede: tudo o que é remoto depende do seu ok. O conferidor de fronteiras lê o código como texto: enxerga nome restrito e texto proibido, não resolve imports nem ordem de chamadas. A procura de segredo cobre os formatos conhecidos de chave; não achar não prova que não há. Os moldes de código valem para app web com banco relacional; para outros tipos de projeto a skill dá os equivalentes, marcados como adaptação a conferir. Os scripts foram testados em macOS com Python 3.14; Linux e Python 3.8 seguem a mesma sintaxe, mas não foram rodados. Requisitos: Python 3.8 ou mais novo e git. Os seis scripts usam só a biblioteca padrão, não acessam a rede e não enviam nada. Para instalar, descompacte o .zip em ~/.claude/skills/, de modo que exista ~/.claude/skills/engenharia-do-projeto/SKILL.md.

• Roda no Claude Code
• Iniciante