Originally written in French. Translated by AI — the meaning has been preserved, not the prose.
Main idea
A framework placed around software production is spontaneously read as a constraint: rules, limits, things you are not allowed to do. Applied to an assistant, that reading is wrong in most cases.
Left alone in front of a codebase it does not know, an assistant searches. It picks an internal API that is not the right one, comes in through a deprecated entry point, rebuilds a component that already existed, works around the existing architecture because it never saw it. Those detours consume time, produce code to throw away and manufacture inconsistency — not because the assistant is bad, but because the information that would have spared it the detour was available nowhere.
A catalog of usable internal APIs, functional documentation generated from the code, a mapping between business concepts and technical entry points, example requests, reusable interface components, conventions, instruction files and skills: each of these objects removes one search. The framework does not shrink the space of solutions, it removes the cost of entering it.
Why it matters
It reverses the economic argument used to discuss a platform investment. As long as rails are presented as protection, they are traded against delay and lose. Presented as the condition of speed for everything that will be produced afterwards, they change spending category.
It also says what separates a codebase that welcomes an assistant from one that is closed to it: not its beauty, but the amount of information it makes available without the assistant having to guess.
Nuances and limits
The effect assumes the framework is up to date. An out-of-date API catalog is worse than no catalog: it points confidently down the wrong path, and nothing in the output flags the error.
And the framework has a cost to build and maintain, which only pays off across repeated production. It is not justified for a one-off object.
Open questions
- Among these rails, which should be written for humans and which for an assistant, when one file cannot properly serve both readings?