FERRAMENTA ABERTA
O arquivo que a IA lê antes de gerar código
Um ARCHITECTURE.md na raiz é o menor passo com maior efeito: é ele que ensina o sistema inteiro para qualquer agente. O gerador monta o esqueleto a partir do seu repositório real.
atualizado em
Gerar
exemplos:
Por que ele vem com perguntas dentro
O gerador preenche o que a árvore de arquivos permite observar: a stack, o mapa de diretórios, os módulos com contagem de arquivos. Tudo o mais vira uma pergunta em comentário — quais são as fronteiras, o que não pode depender do quê, o que já foi decidido e não deve ser reaberto.
Isso é deliberado. Um arquivo gerado que adivinha a arquitetura é pior que arquivo nenhum: o agente passa a ler ficção com autoridade de documento, e o erro fica mais difícil de encontrar do que a ausência.
O que fazer com o arquivo
Baixe, responda as perguntas com o seu time, e faça o commit na raiz. É o primeiro artefato do que chamamos de Sistema Operacional de Engenharia — e o único que dá para começar sozinho hoje.
Para ver quanto o repositório já tem de contexto legível, o auditor usa a mesma leitura e mostra a evidência de cada ponto.