notion-headless-cms

Separar métodos que combinan lectura y mutación en dos: un comando (void, con efectos) y una consulta (retorno puro, sin efectos), aplicando el principio Command-Query Separation.

Arrancar un nuevo requerimiento escribiendo un test E2E que atraviesa la frontera del sistema (UI/HTTP) y falla, para guiar outside-in el diseño de la arquitectura desde el exterior hacia el interior.

Reemplazar constructores sobrecargados con métodos fábrica estáticos con nombre semántico, mejorando la expresividad de la creación de objetos y ocultando la lógica de validación.

Reemplazar primitivas (String, int) que representan conceptos de dominio por objetos Value Object inmutables que encapsulan validación, formateo y reglas de negocio asociadas.

Simplificar el arrange de los tests extrayendo la creación de objetos complejos a un Builder fluido, eliminando setUp masivos y datos irrelevantes que lastran la legibilidad.

Aplanar estructuras condicionales anidadas separando los casos límite o inválidos en guard clauses al inicio del método, reduciendo la carga cognitiva y dejando el flujo principal sin anidamiento.

Validar invariantes del sistema generando cientos de casos de prueba aleatorios, descubriendo comportamientos inesperados que los tests basados en ejemplos fijos no cubren.

Eliminar el acoplamiento directo a implementaciones concretas reemplazando la creación interna de dependencias (`new`, estáticos) por parámetros de constructor, aplicando el Dependency Inversion Principle (DIP).

Aislar la unidad de prueba reemplazando sus colaboradores externos (bases de datos, APIs, sistema de archivos) por dobles controlados, garantizando tests deterministas, rápidos y fiables.

Guiar el ciclo TDD aplicando la Transformation Priority Premise (TPP) de Robert C. Martin para avanzar desde código hardcodeado a código generalizado mediante la transformación más simple posible en cada paso.

Guía de ejecución paso a paso para el desarrollo de funcionalidades aisladas. Requiere cargar activamente la skill `pragmatic-architecture-guidelines` para garantizar un dominio puro y contratos desacoplados usando el paradigma Hexagonal Pragmático + DDD Táctico + TDD Pragmático

Validador estático de reglas de diseño arquitectónico. Esta skill no ejecuta pasos; valida que el código propuesto cumpla con las restricciones de desacoplamiento e invariantes de negocio usando el paradigma Hexagonal Pragmático + DDD Táctico + TDD Pragmático.

Guía estratégica para la migración incremental hacia una arquitectura limpia sin alterar su comportamiento externo. Requiere cargar activamente la skill `pragmatic-architecture-guidelines` para garantizar las buenas prácticas arquitectónicas durante la refactorización.

Organizar los tests en una jerarquía anidada de contextos (describe/context), agrupando configuraciones compartidas y eliminando setUp masivos que ocultan la intención de cada prueba.

Modelar errores de negocio predecibles (saldo insuficiente, usuario no encontrado, formato inválido) mediante tipos algebraicos como Either/Try en lugar de excepciones, haciendo explícita en la firma del método la posibilidad de fallo.