Reference · SAVED · the five an auditor can see
Referencia · SAVED · las cinco que un auditor puede ver
SAVED, and the Layer Beneath
SAVED, y la Capa Debajo
A machine can build a system in an afternoon now. The question that moved is whether you can show it is sound, without asking anyone to take your word. So I grade every codebase against seven properties that can actually be checked. Five are the ones a non-engineer can care about, because they are what let a system survive scrutiny. They spell SAVED. Two more are the engineering layer that keeps them true. That is the standard most teams start with. The paid Readiness Assessment extends these seven into a fuller ten-property standard, the decagon, adding how a system behaves at runtime and improves over time.
Una máquina hoy construye un sistema en una tarde. La pregunta que se movió es si podés mostrar que es sólido, sin pedirle a nadie que te crea. Por eso califico cada base de código contra siete propiedades que se pueden chequear de verdad. Cinco son las que un no-ingeniero puede mirar, porque son las que dejan que un sistema sobreviva al escrutinio. Deletrean SAVED. Dos más son la capa de ingeniería que las mantiene ciertas. Ese es el estándar con el que la mayoría de los equipos empieza. El Reporte de Preparación pago extiende estas siete a un estándar más completo de diez propiedades, el decágono, sumando cómo se comporta el sistema en runtime y cómo mejora con el tiempo.
Two of these do the most work. A specification that is Self-describing and Bounded narrows the model to the region of what it already knows that actually applies here, rather than the average of every similar project it has seen. Every other property builds on that activation.
Dos de estas hacen la mayor parte del trabajo. Una especificación que es Self-describing y Bounded acota el modelo a la región de lo que ya sabe que realmente aplica acá, en lugar del promedio de cada proyecto parecido que vio. Cada otra propiedad se apoya en esa activación.
The audit-facing fiveLas cinco que ve el auditor
SAVEDSAVED
If you could only ask five questions of an AI-built system, these are the five. They deal with the software as an artifact standing in the world it is deployed in, and they decide whether you can stand behind it.Si solo pudieras hacerle cinco preguntas a un sistema construido con IA, son estas. Tratan al software como un artefacto parado en el mundo donde se despliega, y deciden si podés respaldarlo.
Self-describingSelf-describing
S · SAVED
The system explains itself. A stranger, human or AI, can pick it up and understand it from the surface, without the one engineer who built it.
El sistema se explica solo. Un extraño, humano o IA, puede tomarlo y entenderlo desde la superficie, sin el único ingeniero que lo construyó.
In practiceEn la práctica
Its interfaces, names, tests, and decision records tell you what it does and why, with no person narrating it. SPEC.md, CLAUDE.md (or AGENTS.md), and STATUS.md exist and are current, and the AI derives intent, constraints, and architecture at session start without extra prompting.Sus interfaces, nombres, pruebas y registros de decisión te dicen qué hace y por qué, sin una persona narrándolo. SPEC.md, CLAUDE.md (o AGENTS.md) y STATUS.md existen y están al día, y la IA deriva intención, restricciones y arquitectura al inicio de la sesión sin prompting extra.
When it is missingCuando falta
Empty Map. Intent lives in the original author's head. A new AI session cannot determine what the system is supposed to do or why constraints exist, so it fills in the blanks from training data. It is a single point of failure with a person's name on it.Mapa Vacío. La intención vive en la cabeza del autor original. Una nueva sesión de IA no puede determinar qué se supone que hace el sistema ni por qué existen las restricciones, así que llena los blancos desde el training data. Es un punto único de falla con el nombre de una persona.
→ Empty Map — full disease card→ Mapa Vacío — tarjeta completa
AuditableAuditable
A · SAVED
The decisions are on the record. Not only what the system does, but why it was built this way, what was ruled out, and what changed.
Las decisiones están registradas. No solo qué hace el sistema, sino por qué se construyó así, qué se descartó y qué cambió.
In practiceEn la práctica
Conventional Commits on every commit, and an ADR directory with decision records for the architectural choices. When someone asks "why does it do that," the answer is retrievable, not folklore. It is the property that turns a codebase from something you defend in a meeting into something you can hand to an auditor.Conventional Commits en cada commit, y un directorio de ADRs con registros de decisión para las elecciones arquitectónicas. Cuando alguien pregunta "por qué hace eso", la respuesta es recuperable, no folklore. Es la propiedad que convierte una base de código de algo que defendés en una reunión a algo que podés entregarle a un auditor.
When it is missingCuando falta
Amnesia Stack. No commit discipline, no ADRs. The AI meets a constraint that looks suboptimal and "corrects" it, because the rationale exists nowhere it can read. Over many sessions, every intentional tradeoff gets normalized away.Pila Amnésica. Sin disciplina de commits, sin ADRs. La IA encuentra una restricción que parece subóptima y la "corrige", porque la justificación no existe en ningún lugar que pueda leer. A lo largo de muchas sesiones, cada tradeoff intencional se normaliza y desaparece.
→ Amnesia Stack — full disease card→ Pila Amnésica — tarjeta completa
VerifiableVerifiable
V · SAVED
Correctness is computed, not claimed. "The tests pass" is a fact a machine produces on demand, not a promise a person makes.
La corrección se computa, no se afirma. "Las pruebas pasan" es un hecho que produce una máquina a pedido, no una promesa que hace una persona.
In practiceEn la práctica
A complete test pyramid: unit at function boundaries, integration at module boundaries, end-to-end at use case boundaries. Every feature in the spec has at least one passing acceptance test, and the AI runs the tests and verifies output before closing a session.Una pirámide de pruebas completa: unitarias en fronteras de función, integración en fronteras de módulo, end-to-end en fronteras de caso de uso. Cada funcionalidad de la spec tiene al menos una prueba de aceptación pasando, y la IA corre las pruebas y verifica el output antes de cerrar una sesión.
When it is missingCuando falta
Unbound Spec. No executable tests, or tests that cover implementation details rather than behavior. The AI generates, the output looks plausible, the session closes, and defects surface in production or not at all. If the only evidence that something is correct is that someone said so, it is not verifiable.Spec Sin Límites. Sin pruebas ejecutables, o pruebas que cubren detalles de implementación en lugar de comportamiento. La IA genera, el output parece plausible, la sesión cierra, y los defectos aparecen en producción o no aparecen. Si la única evidencia de que algo es correcto es que alguien lo dijo, no es verificable.
→ Unbound Spec — full disease card→ Spec Sin Límites — tarjeta completa
ExecutableExecutable
E · SAVED
The specification is bound to the running system, not a document describing an older version of it. What you read is what actually runs.
La especificación está atada al sistema en ejecución, no es un documento que describe una versión anterior. Lo que leés es lo que realmente corre.
In practiceEn la práctica
The spec is live: every claim maps to a passing test, CI runs on every commit to the main branch, and the project runs from a clean clone with only the manifest as setup guide. The description and the behavior are forced to match, so spec and implementation stay in sync.La spec está viva: cada afirmación mapea a una prueba pasando, CI corre en cada commit a la rama main, y el proyecto se ejecuta desde un clone limpio con solo el manifiesto como guía de setup. La descripción y el comportamiento están forzados a coincidir, así spec e implementación quedan sincronizadas.
When it is missingCuando falta
Frozen Spec. The spec describes behavior the system no longer exhibits. The AI reads the spec and believes it, generating correct code for a fiction, and the two diverge further with every session. If the contract and the code can drift apart in silence, the contract is decoration.Spec Congelada. La spec describe comportamiento que el sistema ya no exhibe. La IA lee la spec y la cree, generando código correcto para una ficción, y las dos divergen más con cada sesión. Si el contrato y el código pueden separarse en silencio, el contrato es decoración.
→ Frozen Spec — full disease card→ Spec Congelada — tarjeta completa
DefendedDefended
D · SAVED
The rules are enforced, not suggested. A quality gate that can be skipped when the deadline is tight is not a gate, it is a suggestion.
Las reglas se aplican, no se sugieren. Un quality gate que se puede saltar cuando el plazo aprieta no es un gate, es una sugerencia.
In practiceEn la práctica
The constraints fail the build when they are violated, so the standard holds on the worst day and not only the calm one. Security rules are enforced the same way: a declared trust boundary, input validation at every boundary, secrets in environment only. The AI observes these enforced patterns and replicates them in new code.Las restricciones hacen fallar el build cuando se violan, así el estándar se sostiene el peor día y no solo el tranquilo. Las reglas de seguridad se aplican igual: un trust boundary declarado, validación de input en cada boundary, secretos solo en el entorno. La IA observa estos patrones aplicados y los replica en el código nuevo.
When it is missingCuando falta
Open Gates. The gates are advisory. A failing check can be merged past when the deadline is tight, so the constraint holds only when no one is under pressure. Secrets leak into source, error responses expose internals, and the AI replicates the undefended patterns it observes.Puertas Abiertas. Los gates son consultivos. Un check que falla se puede mergear igual cuando el plazo aprieta, así la restricción se sostiene solo cuando nadie está bajo presión. Los secretos se filtran al código fuente, las respuestas de error exponen internos, y la IA replica los patrones no defendidos que observa.
→ Open Gates — full disease card→ Puertas Abiertas — tarjeta completa
The engineering layer beneathLa capa de ingeniería debajo
What keeps SAVED trueLo que mantiene SAVED cierto
An auditor sees SAVED. Underneath, engineering properties keep it that way. These do not spell a word for a non-engineer, but they are what a system needs so the five above can hold under change.Un auditor ve SAVED. Debajo, propiedades de ingeniería lo mantienen así. No deletrean una palabra para un no-ingeniero, pero son lo que un sistema necesita para que las cinco de arriba se sostengan bajo cambio.
BoundedBounded
Engineering · activation pairIngeniería · par de activación
Every module and function has a single declared responsibility, with explicit size limits. A bounded unit loads only its own slice, so it fits any reader's window, human or AI.
Cada módulo y función tiene una responsabilidad única declarada, con límites de tamaño explícitos. Una unidad acotada carga solo su porción, así entra en la ventana de cualquier lector, humano o IA.
In practiceEn la práctica
Explicit size limits declared in the spec (max file, max function) and enforced in CI. Every module has a single declared responsibility. Files fit within any AI's read window, with no silent truncation.Límites de tamaño explícitos declarados en la spec (máximo de archivo, máximo de función) y aplicados en CI. Cada módulo tiene una responsabilidad única declarada. Los archivos entran en la ventana de lectura de cualquier IA, sin truncación silenciosa.
When it is missingCuando falta
Spreading Boundary. Responsibilities creep outward, files exceed the AI's read budget and are silently truncated, and the AI edits against an incomplete view, adding code that contradicts what it could not see.Frontera Expansiva. Las responsabilidades se expanden, los archivos superan el presupuesto de lectura de la IA y se truncan en silencio, y la IA edita contra una vista incompleta, agregando código que contradice lo que no pudo ver.
→ Spreading Boundary — full disease card→ Frontera Expansiva — tarjeta completa
ComposableComposable
EngineeringIngeniería
Clean module interfaces and a declared dependency direction. A change stays local instead of cascading.
Interfaces de módulo limpias y una dirección de dependencias declarada. Un cambio queda local en lugar de propagarse en cascada.
In practiceEn la práctica
Dependency direction declared in the spec (for example domain → application → infrastructure, never reversed). No circular imports. A change in one module does not force changes in others unless the interface changes.Dirección de dependencias declarada en la spec (por ejemplo dominio → aplicación → infraestructura, nunca invertido). Sin importaciones circulares. Un cambio en un módulo no fuerza cambios en otros a menos que cambie la interfaz.
When it is missingCuando falta
Tangled Web. Circular imports, and a single change that cascades to five other modules. The AI cannot model the blast radius without reading the whole codebase, and hallucinated side effects proliferate.Red Enmarañada. Importaciones circulares, y un solo cambio que se propaga a otros cinco módulos. La IA no puede modelar el radio de impacto sin leer toda la base de código, y los efectos secundarios alucinados proliferan.
→ Tangled Web — full disease card→ Red Enmarañada — tarjeta completa
The rest of the decagon. Three more properties complete the fuller ten: Observable and Reproducible (how the system behaves and can be rebuilt at runtime) and Evolvable (how safely it changes over time). These need runtime and history evidence, not a static read, so the paid Readiness Assessment scores them while the free self-audit above scores the seven. The full treatment of the ten is in the white paper. SAVED plus the engineering layer is what most teams need to start.
El resto del decágono. Tres propiedades más completan las diez: Observable y Reproducible (cómo se comporta el sistema y cómo se reconstruye en runtime) y Evolvable (con cuánta seguridad cambia con el tiempo). Necesitan evidencia de runtime e historia, no una lectura estática, así que el Reporte de Preparación pago las califica mientras la auto-auditoría gratis de arriba califica las siete. El tratamiento completo de las diez está en el white paper. SAVED más la capa de ingeniería es lo que la mayoría de los equipos necesita para empezar.
Quick Reference
Referencia Rápida
| PropertyPropiedad |
LayerCapa |
Failure modeModo de falla |
AnchorAncla |
| Self-describingSelf-describing |
SAVED |
Empty MapMapa Vacío |
#self-describing |
| AuditableAuditable |
SAVED |
Amnesia StackPila Amnésica |
#auditable |
| VerifiableVerifiable |
SAVED |
Unbound SpecSpec Sin Límites |
#verifiable |
| ExecutableExecutable |
SAVED |
Frozen SpecSpec Congelada |
#executable |
| DefendedDefended |
SAVED |
Open GatesPuertas Abiertas |
#defended |
| BoundedBounded |
EngineeringIngeniería |
Spreading BoundaryFrontera Expansiva |
#bounded |
| ComposableComposable |
EngineeringIngeniería |
Tangled WebRed Enmarañada |
#composable |
Workshop · 30 minTaller · 30 min
Run the Full Audit →Corre la Auditoría Completa →
A SAVED report card: a letter grade per property, an overall grade, and what to fix first. One prompt, no tools required.Un boletín SAVED: una nota por propiedad, una nota global, y qué arreglar primero. Un prompt, sin herramientas.
ReferenceReferencia
The Disease Cards →Las Tarjetas de Enfermedad →
Deep dives into each failure mode and the cure.Análisis profundo de cada modo de falla y la cura.
Foundation · 90 minFundación · 90 min
Generate Your Specification →Genera tu Especificación →
Full sentinel tree: SPEC.md, constitutions, STATUS.md, ADR-000.Árbol sentinel completo: SPEC.md, constituciones, STATUS.md, ADR-000.
ReferenceReferencia
The Forge Cycle →El Ciclo de La Fragua →
6 stages + why structural disciplines help the AI mechanically.6 etapas + por qué las disciplinas estructurales ayudan mecánicamente a la IA.