Guides
55 opinionated hexagonal architecture guides, grouped by category.
filter --category=
Architecture
Hexagonal Architecture
Arquitectura hexagonal de cero: capas domain/application/infrastructure/bootstrap, outbox y ArchUnit.
ArchitectureArchitecture Document Spec
Spec de 21 secciones para un architecture document board-grade: contexto, riesgos, decisiones y deployment view.
ArchitectureArchitecture Diagrams & Patterns
Índice de diagramas de arquitectura: C4, runtime, ports, command flow y catálogo de patterns.
ArchitectureLaTeX Architecture Docs
Pipeline LaTeX + Tectonic + Pandoc para producir architecture documents PDF board-grade desde Markdown.
ArchitectureAPI Design
Convenciones REST: modelado de recursos, versionado, errores RFC 9457, paginación por cursor, idempotency-key y contract-first con OpenAPI.
ArchitectureMessaging
Mensajería event-driven: outbox transaccional, envelope EventMessage, dispatch claim-based, consumidores idempotentes y evolución de esquemas.
ArchitectureAPI 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.
ArchitectureArchitecture Overview
Vista de alto nivel de la arquitectura: capas hexagonales, estructura de módulos y cómo encajan domain, application e infrastructure.
ArchitecturePorts & Commands
Convenciones de nombres de puertos, patrón command y la cadena de mapeo de tres capas entre REST, use case y dominio.
ArchitectureData Flow & Transformations
Ciclo de vida completo de un request y las transformaciones commands vs entidades de dominio a través de las capas.
ArchitectureDesign Patterns Catalog
Catálogo de patrones arquitectónicos, de comportamiento y estructurales aplicados en la arquitectura hexagonal.
ArchitecturePackage & Component Diagrams
Diagramas C4 de paquete y componente en runtime, más el diagrama de flujo de eventos del outbox.
ArchitectureBest Practices & Recommendations
Reglas de diseño por capa, roadmap de mejoras y troubleshooting para mantener sanas las fronteras hexagonales.
ArchitectureFunctional Specification Anatomy
Anatomía de un funcional de módulo: identificadores estables, criterios verificables, matriz de trazabilidad y supuestos vs bloqueos.
ArchitectureSpecification Traceability
De un funcional externo al código: cobertura criterio a criterio, reglas de auditoría, delta entre versiones y huecos con dueño.
ArchitectureMobile Architecture (React Native)
Hexagonal en React Native: cuándo frente a FSD, puertos y adapters, DI, outbox offline y límites con ESLint.
DDD
Clean Code
Styles
Java Code Style
Convenciones Java 21+: records, sealed classes, pattern matching, @FunctionalInterface y mappers explícitos.
StylesKotlin Code Style
Convenciones Kotlin 2.x: data class, fun interface, extension functions, val por defecto y null-safety.
StylesTypeScript Code Style
Flags estrictos, branded types, errores como uniones discriminadas y Result en lugar de throw.
StylesTailwind CSS v4
Tailwind v4: namespaces de @theme, shadowing de max-w-*, @source en monorepo, dark mode y adopción de kits de componentes.
Framework
Spring Boot
Spring Boot en hexagonal: bean wiring, profiles, JDBC, Kafka, Redis y Async sin invadir el dominio.
FrameworkEclipse 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.
Frameworkapplication.yml Standard
Estándar de application.yml en Spring Boot: orden de bloques, ${VAR:default}, perfiles, secret store, actuator y checklist pre-merge.
FrameworkReact Native & Expo
Expo por defecto, New Architecture, Expo Router, estado de servidor vs cliente y rendimiento en React Native.
FrameworkMobile UI
UI móvil: motor de estilos, design tokens, dark mode, los cuatro estados de pantalla, accesibilidad e i18n.
Infra
Gradle Build & Quality
Gradle Kotlin DSL multi-módulo: Spotless, JaCoCo, SonarQube, ArchUnit y enforcement de boundaries hexagonales.
InfraLiquibase Guidelines
Migraciones Liquibase forward-only: changesets atómicos, rollback strategy y reglas anti-mutación de schema.
InfraGitHub 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.
InfraGit Workflow & Best Practices
Buenas prácticas de Git: conventional commits, branching, pull requests, disciplina de historia y manejo seguro de secretos.
InfraSecurity
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.
InfraKeycloak & Identity
Keycloak como infraestructura: topologías gateway-first vs resource server, mapeo de roles, Current User Port, microservicio de auth y grant flows.
InfraGitOps + ArgoCD
GitOps con ArgoCD: estado declarativo del clúster, Application/ApplicationSet, sync waves, secrets, promoción de entornos y Argo Rollouts.
InfraMobile Security
Seguridad móvil: SecureStore vs MMKV, nada de secretos en el bundle, PKCE, deep links y certificate pinning.
InfraMobile Release
Release móvil con EAS Build/Submit: fingerprint de runtimeVersion, límites de OTA, rollout gradual y rollback.
Observability
Observability Guide
Estrategia de observabilidad: métricas Micrometer, tracing OTEL y logging estructurado correlados por traceId.
ObservabilityObservability — Metrics
Métricas con Micrometer y Prometheus: métricas custom vía decorator y convenciones de nombres.
ObservabilityObservability — Tracing
Tracing con OpenTelemetry: bridge de Micrometer y exporter a NewRelic.
ObservabilityObservability — Structured Logging
Logging estructurado en JSON con SLF4J + Logback y correlación por traceId.
ObservabilityObservability — Recipes & Dashboards
Receta paso a paso de observabilidad con dashboards, alerting y checklist final.
Testing
ADR
Agents / Workflows
Claude Code Guide
Guía paso a paso para implementar features hexagonales con Claude Code: domain, puertos, adapters, wiring y tests.
Agents / WorkflowsGSD Workflow Guide
Pipeline GSD para automatizar planning y ejecución de proyectos con Claude: phases, plans, waves y SUMMARY.
Agents / WorkflowsGuidelines Overview
Tabla de contenidos y orden de lectura recomendado para todas las guías de arquitectura hexagonal.
Agents / WorkflowsResources Structure
Plantillas de archivos de proyecto: README, LICENSE, CONTRIBUTING y la estructura del módulo bootstrap.
Agents / WorkflowsClaude Code Guide — Domain, Ports & Use Cases
Pasos 1-3 con Claude Code: modelo de dominio, puertos y use case en un proyecto hexagonal.
Agents / WorkflowsClaude Code Guide — Adapters & Bootstrap Wiring
Pasos 4-5 con Claude Code: adapters REST/JDBC/Kafka/métricas y wiring en el módulo bootstrap.
Agents / WorkflowsClaude Code Guide — Bug Fixing & Testing Patterns
Workflow de bug-fixing con Claude Code y patrones de tests unitarios e integración.
Agents / WorkflowsClaude Code Guide — Tasks, Anti-Patterns & Checklists
Tareas comunes, anti-patrones y checklist pre-merge para trabajar con Claude Code.
Agents / WorkflowsAI-Native SDLC
Cadena de artefactos intent → spec → plan → diff → PR → incidente: cada etapa deja un artefacto que la siguiente lee, con métricas de proceso.
Agents / WorkflowsEvals for Agent Config
Evals como tests de regresión para CLAUDE.md, reglas, skills y hooks: formato de casos, runner, gate en CI y de incidente a eval.
Agents / WorkflowsHooks — Deterministic Controls
Hooks como único control que el agente no puede saltarse: tres niveles de control, build hooks vs gates de deploy e inventario clasificado.