SOLID, hexagonal architecture, TDD, ADRs, intentional naming — these existed for 30 years and were never fully adopted because humans couldn't sustain them under pressure. The AI reader that benefits from them is also the executor that enforces them. The friction of adoption disappeared. The benefit doubled. SOLID, arquitectura hexagonal, TDD, ADRs, naming intencional — estas existieron 30 años y nunca se adoptaron completamente porque los humanos no las podían sostener bajo presión. El lector de IA que se beneficia de ellas es también el ejecutor que las hace cumplir. La fricción de adopción desapareció. El beneficio se duplicó.
These disciplines were invented to make intent legible to the next human reader. An AI reader has the same problem: it arrives knowing nothing about what you meant. The disciplines reduce the token cost of understanding, eliminate traversals, and make the AI's first search deterministic. Estas disciplinas fueron inventadas para hacer la intención legible para el siguiente lector humano. Un lector IA tiene el mismo problema: llega sin saber nada de lo que quisiste decir. Las disciplinas reducen el costo en tokens de entender, eliminan traversals, y hacen que la primera búsqueda del AI sea determinista.
| DisciplineDisciplina | Mechanical advantage for the AI readerVentaja mecánica para el lector IA |
|---|---|
| SOLID — interfaces + DI | AI reads the contract (N lines), not the implementation (N×10). Hallucinations about private state = structurally impossible. El AI lee el contrato (N líneas), no la implementación (N×10). Alucinaciones sobre estado privado = imposibles. |
| Single Responsibility Responsabilidad Única | AI acts on the class without exploring the call graph. The class is its own complete spec. El AI actúa sobre la clase sin explorar el call graph. La clase es su propia spec completa. |
| Hexagonal + consistent structure Hexagonal + estructura consistente |
controllers/ always has controllers. First search hits. No discovery traversals.
controllers/ siempre tiene controllers. La primera búsqueda acierta. Sin traversals de descubrimiento.
|
| DDD — ubiquitous language DDD — lenguaje ubicuo | Names in code map to the AI's training data about the same domain. Higher generation quality. Nombres en código mapean al training data del AI sobre el mismo dominio. Calidad de generación más alta. |
| Conventional Commits | Git log is queryable by type and scope. Cascade triggers fire from parseable types. El git log es consultable por tipo y scope. Cascade triggers se activan desde tipos parseables. |
| TDD — tests as spec TDD — tests como spec | Each test is a behavioral declaration the AI reads before the implementation. Cada test es una declaración de comportamiento que el AI lee antes de la implementación. |
| ADRs | AI reads the why behind decisions. Can't "optimize" intentional tradeoffs that look suboptimal without context. El AI lee el por qué de las decisiones. No puede "optimizar" tradeoffs intencionales que parecen subóptimos. |
| Doc-first cascade Cascada doc-first | AI receives intent before implementation. Generating from spec is execution; from code without spec is reverse engineering. El AI recibe la intención antes que la implementación. Generar desde spec es ejecución; desde código sin spec es ingeniería inversa. |
| Intentional naming Naming intencional |
calculateMonthlyCost(userId: UserId, period: BillingPeriod): Result<Money, Error> — domain, operation, inputs, output, error contract, all in the signature. Zero implementation reading.
calculateMonthlyCost(userId: UserId, period: BillingPeriod): Result<Money, Error> — dominio, operación, inputs, output, contrato de error, todo en la firma. Cero lectura de implementación.
|
These disciplines existed for 30 years and were never fully adopted. Not because they were wrong. Because humans couldn't sustain them under pressure. The sprint ends, the deadline moves, the senior engineer leaves, and the architecture degrades toward what's fastest to write, not what's clearest to read. Estas disciplinas existieron 30 años y nunca se adoptaron completamente. No porque estuvieran equivocadas. Porque los humanos no las podían sostener bajo presión. El sprint termina, el deadline se mueve, el ingeniero senior se va, y la arquitectura degrada hacia lo más rápido de escribir, no lo más claro de leer.
The AI reader that benefits from these disciplines is also the AI executor that enforces them. SOLID isn't a style preference anymore — it's a constraint the AI applies on every file it touches. TDD isn't a discipline that requires willpower — it's the entry condition for every fix. The friction disappeared. The benefit compounded. El lector de IA que se beneficia de estas disciplinas es también el ejecutor de IA que las hace cumplir. SOLID ya no es una preferencia de estilo — es una restricción que el AI aplica en cada archivo que toca. TDD ya no es una disciplina que requiere fuerza de voluntad — es la condición de entrada para cada fix. La fricción desapareció. El beneficio se compuso.
The structural disciplines are enforced by the harness, not by willpower. The sentinel tree (CLAUDE.md) names the standards. The manifest enforces them. The pre-commit hooks reject violations before they land. Las disciplinas estructurales las hace cumplir el harness, no la fuerza de voluntad. El árbol sentinel (CLAUDE.md) nombra los estándares. El manifest los hace cumplir. Los pre-commit hooks rechazan violaciones antes de que lleguen.