Skip to content
My Guidelines
Guides

Guides

18 opinionated hexagonal architecture guides, grouped by category.

Architecture

Architecture

Hexagonal Architecture

Arquitectura hexagonal de cero: capas domain/application/infrastructure/bootstrap, outbox y ArchUnit.

Architecture

Architecture Document Spec

Spec de 21 secciones para un architecture document board-grade: contexto, riesgos, decisiones y deployment view.

Architecture

Architecture Diagrams & Patterns

Índice de diagramas de arquitectura: C4, runtime, ports, command flow y catálogo de patterns.

Architecture

LaTeX Architecture Docs

Pipeline LaTeX + Tectonic + Pandoc para producir architecture documents PDF board-grade desde Markdown.

Architecture

API Design

Convenciones REST: modelado de recursos, versionado, errores RFC 9457, paginación por cursor, idempotency-key y contract-first con OpenAPI.

Architecture

Messaging

Mensajería event-driven: outbox transaccional, envelope EventMessage, dispatch claim-based, consumidores idempotentes y evolución de esquemas.

Architecture

API Gateway

API gateway en el edge con KrakenD: validación JWT, claims-to-headers, rate limiting, CORS, propagación W3C Trace Context y mTLS a backends.

DDD

DDD

Domain-Driven Design

Domain-Driven Design en práctica: aggregates, bounded contexts, building blocks y cómo mapean a la capa de dominio hexagonal.

Clean Code

Clean Code

Clean Code

Principios de clean code y SOLID aplicados al backend JVM: funciones cortas, nombres claros, responsabilidades únicas.

Styles

Styles

Java Code Style

Convenciones Java 21+: records, sealed classes, pattern matching, @FunctionalInterface y mappers explícitos.

Styles

Kotlin Code Style

Convenciones Kotlin 2.x: data class, fun interface, extension functions, val por defecto y null-safety.

Framework

Framework

Spring Boot

Spring Boot en hexagonal: bean wiring, profiles, JDBC, Kafka, Redis y Async sin invadir el dominio.

Framework

Eclipse Vert.x

Servicios reactivos con Eclipse Vert.x 4.x: estilo layered N-tier + event-driven, Verticles, EventBus, Future API y testing con vertx-junit5.

Infra

Infra

Gradle Build & Quality

Gradle Kotlin DSL multi-módulo: Spotless, JaCoCo, SonarQube, ArchUnit y enforcement de boundaries hexagonales.

Infra

Liquibase Guidelines

Migraciones Liquibase forward-only: changesets atómicos, rollback strategy y reglas anti-mutación de schema.

Infra

GitHub Actions CI/CD

CI/CD con GitHub Actions: workflows reutilizables (workflow_call), orquestación de pipelines, semver desde commits, security gates y rulesets de protección.

Infra

Git Workflow & Best Practices

Buenas prácticas de Git: conventional commits, branching, pull requests, disciplina de historia y manejo seguro de secretos.

Infra

Security

Baseline de seguridad: STRIDE, AuthN/Z (OAuth2/OIDC/JWT), gestión de secretos, validación, prevención de inyección, criptografía y audit trail.

Infra

Keycloak & Identity

Keycloak como infraestructura: topologías gateway-first vs resource server, mapeo de roles, Current User Port, microservicio de auth y grant flows.

Infra

GitOps + ArgoCD

GitOps con ArgoCD: estado declarativo del clúster, Application/ApplicationSet, sync waves, secrets, promoción de entornos y Argo Rollouts.

Observability

Observability

Observability Guide

Estrategia de observabilidad: métricas Micrometer, tracing OTEL y logging estructurado correlados por traceId.

Testing

Testing

Testing Strategy

Estrategia de testing: JUnit unitarios sin mocks en dominio, Karate para BDD, Testcontainers y ArchUnit por boundaries.

ADR

ADR

Architectural Decision Records

Cuándo y cómo escribir Architectural Decision Records (MADR, Nygard, Y-Statement) y mantenerlos vivos en el repositorio.

Agents / Workflows

Agents / Workflows

Claude Code Guide

Guía paso a paso para implementar features hexagonales con Claude Code: domain, puertos, adapters, wiring y tests.

Agents / Workflows

GSD Workflow Guide

Pipeline GSD para automatizar planning y ejecución de proyectos con Claude: phases, plans, waves y SUMMARY.

Agents / Workflows

Guidelines Overview

Tabla de contenidos y orden de lectura recomendado para todas las guías de arquitectura hexagonal.

Agents / Workflows

Resources Structure

Plantillas de archivos de proyecto: README, LICENSE, CONTRIBUTING y la estructura del módulo bootstrap.