O problema
Sem contexto estável, cada interação pode redescobrir o projeto, repetir decisões e produzir mudanças desconectadas. Uma lista de tarefas concluídas também pode esconder um fluxo que ainda falha.
Um modelo aberto para
engenharia de software com IA.
Criei o modelo_projetos para organizar o trabalho com assistentes de IA nos meus projetos. Ele reúne o contexto do produto, as decisões de arquitetura e os comandos de teste e publicação. Disponibilizo essa base para você usar e adaptar.
MITGuia PT / ENIndependente de framework
01 / Contexto
Entender antes de mudar.
PATHS · PRD · ESCOPO · DECISOES
02 / Execução
Construir com limites.
QUALITY_ROADMAP · DEMANDAS · TELAS
03 / Evidência
Verificar o que funciona.
TESTES · BUGS · RUNBOOK · CHECKS
A proposta
Manter um mapa de fontes oficiais, responsabilidades explícitas e critérios de entrega. Ler o necessário, confrontar documentação com código e ligar cada requisito à sua evidência.
O resultado esperado
Uma equipe consegue explicar o que existe, o que mudou, como foi verificado e o que ainda falta. O modelo organiza essa conversa; a qualidade depende da adoção e da revisão.
Guias para usar o modelo.
Comece aqui
Comece aqui ↗
Instale com cuidado, configure o mapa e faça sua primeira entrega.
Fluxo de trabalhoFluxo de trabalho ↗
Contexto, SOLID, pacotes, lotes, revisão e operação no mesmo ciclo.
ReferênciaReferência ↗
Entenda o papel de cada documento e quando consultá-lo.
ExemplosExemplos ↗
Veja um requisito virar implementação, teste e evidência.
MateriaisMateriais ↗
Modelos, validadores, licença MIT e instruções nos dois idiomas.
Você não precisa de um conjunto específico de tecnologias.
A base pode orientar um serviço, aplicativo, sistema legado ou monorepo de um produto. Ela não define sua arquitetura automaticamente: você registra os módulos e comandos reais, preserva convenções saudáveis e adapta as políticas.
Os exemplos são didáticos. O download contém validadores reais, mas exige configuração e revisão no projeto adotante.
Baixe o modelo de projetos.
Kit 1.0.0 · 35 arquivos · MIT · 66 KB
Perguntas frequentes
É uma biblioteca ou uma aplicação?
É uma base de engenharia e governança de repositório. Os documentos definem contexto e critérios; os scripts ajudam a inventariar e validar. Não substitui seu produto ou framework.
Posso usar em projetos comerciais?
Sim. O kit está sob licença MIT: mantenha o aviso de autoria e a licença. Você pode adaptar o material às necessidades da sua equipe.
Funciona sem IA?
Sim. O processo é legível por pessoas. Um assistente pode ajudar na execução, mas não é necessário para manter documentos, decisões e testes.
Um check verde significa produto pronto?
Não. Checks comprovam somente o recorte que verificam. Publicação, integrações externas, restore, dispositivos e aceite humano continuam exigindo evidências próprias.
Preciso de acesso ao repositório privado?
Não para usar o kit. O ZIP inclui os documentos e scripts de adoção, sem credenciais ou caminhos pessoais.