Rails Whey badge Rails Whey

A Rails app to study architecture in the age of agents.

Explore 28 versions of the same task app. Compare architectural decisions, understand their consequences for people and AI agents, and build the judgment to choose what your project needs.

Explore the app on GitHub

Open code to explore and run locally. No account on this site required.

Rails Whey App task list with assignees, completion states, and navigation between the app's sections.
A task list in the study app. The project interface is in English. View the original screenshot
versions
28
families
7
architecture gems
0

Agent-Friendliness

Your agent needs to understand the architecture, too.

To change a behavior, an agent must find the right code, understand its dependencies, and anticipate what the change will affect. The app's structure shapes that work.

28 versions, the same app.

Scroll sideways to compare branches. Find the complete tables in the Gradient. Read the data tables

Agent-friendliness (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

What changes for the agent

Context
How much code it must load to understand the task.
Discoverability
How much searching it takes to find the right file.
Isolation
How much unrelated code it must understand.
Predictability
How well names and patterns help it anticipate the next step.
Reach
How many files a change in behavior needs to touch.

Scores rise and fall along the Gradient. Clear names make answers easier to find; new boundaries can require guidance to connect the parts.

Explore the Gradient Read the criteria and evidence in the report

A code-based evaluation of this app's structure. It is not a benchmark of agent runs or token usage.

Rodrigo Serradura

Creator of Rails Whey App

How far can the Rails Way go?

The exploration began with rails-way-app: what happens when we improve an app's design without leaving the Rails Way? Rails Whey App takes that question further with a richer product and versions validated by the same behavioral test contract.

The Rails Way has more room in it than most people think.

Serradura wants to offer practical references for people learning, validating an idea, or scaling a system. Each version helps examine how much architecture a problem needs.

AI has made producing code easier. Choosing what serves a project still takes judgment. The Manifesto explains why this exploration matters now.

Read the origin in the README Explore the earlier project
28 branches in 7 families

Complete overview. The numbers below identify the families.

Each bar is a branch. Color and height show order, not a quality score.

default scaffold See every point fully articulated domain model
Read the Manifesto

The same product in every version.

Tasks, collaboration, multiple accounts, notifications, full-text search, and a REST API. The features stay the same as the code's structure changes.

See features and screenshots in the repository Run the app locally