Repository navigation
Skill proj_software
Esta página explica a skill /proj_software de forma didática. Se algum termo for novo, consulte o Glossário.
A /proj_software conduz a construção de um software do início ao fim. Ela organiza o trabalho em 5 grandes fases e aciona, em cada uma, os engenheiros certos. É o motor de engenharia do plugin.
O nome vem de "projeto de software". Ela aplica um conceito chamado SDLC (ciclo de vida de desenvolvimento de software, veja o Glossário): as etapas para criar um software, do pensar ao manter.
Use a /proj_software quando estiver começando ou tocando a parte técnica de um projeto. Frases típicas:
- "Vou criar um software."
- "Começar um projeto novo."
- "Construir esta funcionalidade."
- "Novo sistema."
- "Qual fluxo seguir para colocar isso em produção."
Se você só descreve a intenção em português ("vou criar um app de cadastro"), o plugin já roteia para esta skill, mesmo sem você digitar o comando.
Dentro do Claude Code:
/proj_software
/proj_software "API de pagamentos com idempotencia"
Na segunda forma, você descreve o que quer construir; a skill usa isso para calibrar o tamanho e o time.
A skill conduz o software por cinco grandes etapas. O nível de detalhe se ajusta ao tamanho do projeto.
- Concepção e desenho: entender o problema, definir o escopo, projetar a estrutura. Em projeto pequeno, isso é rápido; em projeto grande, é formal.
- Implementação: programar o código. Aqui entram os engenheiros (backend, frontend, mobile, conforme o caso).
- Dados e IA: se o projeto tiver análise de dados ou inteligência artificial, esta fase ativa os especialistas de dados.
- Qualidade, segurança e documentação: testar, revisar a segurança e escrever a documentação.
- Operação e sustentação: colocar no ar, monitorar e manter funcionando.
Assim como a /bigtech, a /proj_software evita exagero. Ela mede o tamanho do projeto em uma escala chamada níveis S0 a S4 (veja o Glossário):
| Nível | Tamanho | Quem trabalha |
|---|---|---|
| S0 | script ou protótipo, 1 pessoa | nenhum especialista; o assistente faz direto |
| S1 | app pessoal ou MVP | 2 a 3 especialistas sob demanda |
| S2 | produto pequeno, equipe inicial | núcleo de engenharia |
| S3 | produto médio, várias equipes | equipe maior, com líderes técnicos |
| S4 | grande, regulado | time completo, processo robusto |
A skill não chama o time inteiro para um programa de 200 linhas. Ela pergunta de 1 a 3 coisas essenciais (tamanho, criticidade, se há dados sensíveis) e calibra a partir daí.
Um cuidado especial: a skill aplica segurança em todas as fases, não só no final. Esse princípio se chama shift-left (em português, "puxar para a esquerda", ou seja, antecipar a segurança para o começo). A intensidade se ajusta ao tamanho: um projeto pessoal offline quase não precisa; uma API pública precisa de cuidado em cada etapa.
Você digita:
/proj_software "API de pagamentos com idempotencia"
O que acontece:
- A skill identifica que pagamento é algo crítico (lida com dinheiro), então sobe o nível de cuidado.
- Pergunta o essencial: tamanho da equipe, prazo, se há regulação (como PCI, normas de cartão).
- Define o nível (por exemplo, S2 ou S3) e quais engenheiros entram.
- Conduz as fases: desenho da API, implementação com testes, revisão de segurança, operação.
- Em cada decisão importante e difícil de reverter, registra o porquê e pergunta a você quando há mais de um caminho viável.
A skill bloqueia padrões de over-engineering, por exemplo: usar tecnologia pesada de mais (como dividir tudo em microsserviços cedo demais), criar abstrações para uma única situação, ou planejar para um futuro sem evidência de que ele vem. A regra: construir para hoje, melhorar quando o futuro chegar.
- A /bigtech cuida do lado de negócio e delega a engenharia para esta skill. Os níveis S0/S1 daqui cobrem o porte early; S2 costuma mapear early (PMF); S3 → scale; S4 → bigtech. Não há porte "solo".
- Para planejar as tarefas na melhor ordem, use a /tab_pendencias.
Veja também o líder de engenharia: Caetano (CTO). Voltar para a Home.