otaku@manifesto:~$ cat OTAKU.md
La estructura es una decisión,
no un accidente.
OTAKU es una filosofía para el software orientado a objetos. Cinco restricciones deciden qué código puede existir; tres formas deciden cómo se organizan los repositorios. Nada aquí pertenece a un lenguaje: solo al paradigma.
Por qué existe
Los frameworks son excelentes hasta que necesitas reemplazar una pieza, y entonces exigen que reemplaces todas. La salida habitual es reescribir, lo que cambia un conjunto de restricciones accidentales por otro. OTAKU apuesta a lo contrario: arquitectura hecha de piezas lo bastante pequeñas para entender de una vez, y reemplazables sin pedir permiso.
El nombre es un acrónimo y también un temperamento: obsesión técnica por el dominio, la disciplina y la pureza estructural; la disposición a borrar una abstracción ingeniosa porque no cabe en una frase.
Cómo leer este libro
El manifiesto
Cinco pilares, cuarenta reglas medibles, una métrica principal.
02Las tres formas
Átomo, ensamblaje, aplicación. Cada repositorio es exactamente una.
03La guía
Cómo aplicarlo, con código en PHP, C#, Java, C++ y TypeScript.
Lo que rechaza
- Frameworks filtrándose en la capa de dominio.
- Repositorios que no pueden clasificarse como átomo, ensamblaje o aplicación.
- Abstracciones creadas antes del segundo caso de uso real.
- Métodos con complejidad ciclomática superior a 5.
- Interfaces publicadas sin contrato.
Escribe código que nunca necesite «arreglos» porque fue construido bajo restricción absoluta.
Alcance
OTAKU nació dentro de PHPRise, pero PHP es solo donde empezó. Las reglas miden indentación, complejidad, dependencias, contratos y nombres: conceptos que todo lenguaje orientado a objetos expresa. La guía cubre PHP, C#, Java, C++ y TypeScript.
Si tu lenguaje tiene clases, interfaces, excepciones y un gestor de paquetes, la filosofía aplica. Si no, esta no es la herramienta correcta, y esa es una respuesta legítima.
Este capítulo está disponible solo en inglés por ahora.