Um app Rails para estudar arquitetura na era dos agentes.

Explore 28 versões do mesmo app de tarefas. Compare decisões de arquitetura, entenda suas consequências para pessoas e agentes de IA e desenvolva critério para escolher o que seu projeto precisa.

Código aberto para explorar e rodar localmente. Sem conta neste site.

Tela do Rails Whey App com uma lista de tarefas, responsáveis, status de conclusão e navegação entre as áreas do app.
Lista de tarefas do app de estudo. A interface do projeto está em inglês. Ver captura original
versões
28
famílias
7
gems de arquitetura
0

Agent-Friendliness

Seu agente também precisa entender a arquitetura.

Para mudar um comportamento, o agente precisa encontrar o código certo, entender suas dependências e prever o alcance da mudança. A organização do app muda esse trabalho.

28 versões, o mesmo app.

Role para os lados para comparar as branches. As tabelas completas estão no Gradiente. Ver os dados em tabela

Facilidade para agentes (0–25) 25 20 15 10 5 0 10 1A 15 1B 17 2A 19 2B 14 3A 15 3B 16 3C 17 3D 16 3E 20 3F 21 3G 14 4A 18 4B 17 5A 18 5B 21 5C 23 5D 19 6A 22 6B 19 6C 21 6D 22 6E 19 6F 24 6G 19 7A 19 7B 17 7C 19 7D

O que muda para o agente

Contexto
Quanto código precisa carregar para entender a tarefa.
Descoberta
Quanto precisa procurar até encontrar o arquivo certo.
Isolamento
Quanto código sem relação com a tarefa precisa entender.
Previsibilidade
Quanto os nomes e padrões ajudam a prever o próximo passo.
Alcance
Quantos arquivos uma mudança de comportamento precisa tocar.

As notas sobem e descem ao longo do Gradiente. Nomes claros ajudam a encontrar respostas; novas fronteiras podem exigir orientação para ligar as partes.

Explorar o Gradiente Ler critérios e evidências no relatório

Avaliação da estrutura deste app, baseada no código. Não é um benchmark de execução nem de consumo de tokens.

Rodrigo Serradura

Criador do Rails Whey App

Até onde o Rails Way pode ir?

A investigação começou no rails-way-app: o que acontece quando melhoramos o design de um app sem sair do Rails Way? O Rails Whey App amplia essa pergunta com um produto mais completo e versões validadas pelo mesmo contrato de testes.

O Rails Way tem mais espaço do que a maioria imagina.

Serradura quer oferecer referências práticas para quem está aprendendo, validando uma ideia ou escalando um sistema. Cada versão ajuda a examinar quanto de arquitetura um problema pede.

Com a IA, produzir código ficou mais fácil. Escolher o que serve ao projeto continua exigindo critério. O Manifesto explica por que essa investigação importa agora.

28 branches em 7 famílias

Visão geral completa. Os números abaixo identificam as famílias.

Cada barra é uma branch. Cor e altura mostram a ordem, não uma nota de qualidade.

scaffold padrão Ver cada ponto modelo de domínio articulado

O mesmo produto em todas as versões.

Tarefas, colaboração, múltiplas contas, notificações, busca full-text e API REST. As funcionalidades se mantêm enquanto a organização do código muda.