The system runs and ships, but a stateless reader cannot rebuild it without guessing. Behaviour is under-pinned by tests in places and unguarded in others, and the decisions that hold it together live only in people's heads. Safe to run, not yet safe to hand to an AI at speed.El sistema corre y despliega, pero un lector sin estado no puede reconstruirlo sin adivinar. El comportamiento está respaldado por tests en partes y desprotegido en otras, y las decisiones que lo sostienen viven solo en la cabeza de la gente. Seguro para correr, todavía no para entregárselo a una IA a velocidad.
| PropertyPropiedad | FindingHallazgo | |
|---|---|---|
| SAVED — what a reviewer readsSAVED — lo que lee quien revisa | ||
| Self-describing | D | Names do not announce the domain; a newcomer maps the code by reading it.Los nombres no anuncian el dominio; un recién llegado mapea el código leyéndolo. |
| Auditable | F | No decision records. "When it fails there is no substance" to check against.Sin registros de decisión. "Cuando falla no hay sustancia" contra qué chequear. |
| Verifiable | C | Tests exist, but the gate counted files, not violations: green meant nothing.Hay tests, pero el gate contaba archivos, no violaciones: el verde no significaba nada. |
| Executable | B | It runs and ships. The one property this codebase has always had.Corre y despliega. La única propiedad que este código siempre tuvo. |
| Defended | D | Few guards, no gate on the real branch; regressions reach production.Pocos guardas, sin gate en la rama real; las regresiones llegan a producción. |
| Engineering layerCapa de ingeniería | ||
| Bounded | C | Two God-methods and a 600-line file carry most of the logic.Dos God-methods y un archivo de 600 líneas cargan la mayor parte. |
| Composable | C | Layers blur: routes reach the database directly in three places.Las capas se mezclan: las rutas llegan a la base directo en tres lugares. |
| Runtime + evolution — scored from runtime and history evidenceRuntime + evolución — desde evidencia de runtime e historia | ||
| Observable | D | Little runtime signal; a failure is a mystery until someone reproduces it.Poca señal de runtime; una falla es un misterio hasta que alguien la reproduce. |
| Reproducible | C | Builds, but environment setup is tribal knowledge, not a spec.Compila, pero armar el entorno es conocimiento tribal, no una spec. |
| Evolvable | D | Every change risks a silent break; the team edits carefully and slowly.Cada cambio arriesga una ruptura silenciosa; el equipo edita con cuidado y lento. |
Passing 5 of 10 honestly. The point of the score is not the number; it is that two low grades tell you exactly where to move next.Pasa 5 de 10 con honestidad. El punto de la nota no es el número; es que dos notas bajas te dicen exactamente dónde moverte primero.
Auditable (F) → Capture the load-bearing decisions. Write the handful of architectural decision records that today live only in memory, and make the merge gate require one for any structural change. This is the move that turns "no substance when it fails" into a system you can reason about.Capturá las decisiones que cargan peso. Escribí el puñado de registros de decisión arquitectónica que hoy viven solo en la memoria, y que el gate de merge exija uno para cualquier cambio estructural. Este es el movimiento que convierte "sin sustancia cuando falla" en un sistema sobre el que se puede razonar.
Verifiable (C) → Make the gate count what matters. The gate counted files instead of violations, so green was meaningless. Point it at real signals (mutation score, layer-boundary checks, coverage of the critical paths) and the ratchet can only go up from there.Hacé que el gate cuente lo que importa. El gate contaba archivos en vez de violaciones, así que el verde no significaba nada. Apuntalo a señales reales (mutation score, chequeos de límite de capa, cobertura de los caminos críticos) y el trinquete solo puede subir desde ahí.
This is the report. Get one for your own code, free, or have us run the full assessment.Este es el reporte. Conseguí uno para tu propio código, gratis, o que corramos el assessment completo.
Score your codebase free →Puntuá tu código gratis → Book a Readiness AssessmentReservá un Readiness Assessment