Soberanía de la Intención · Designio
ADN Arquitectónico
Soberanía de la Intención · Designio
ADN Arquitectónico — Web oficial designio.dev
Artefacto 01 del pipeline de intención. Conjunto de reglas que definen la identidad técnica de este proyecto: la ley que la IA constructora debe cumplir siempre (libro, cap. 2.3, pp. 55-58). De este ADN se deriva el MAP.
1. Misión y naturaleza del proyecto
Construir la web oficial de la metodología Designio y del libro «Soberanía de la Intención» (Marcos Fernández Otero, 2026), con una condición estructural: la web es, a la vez, la demostración práctica del propio método. Cada artefacto generado durante su construcción se publica en la sección «Cómo se construyó esta web».
Proyecto greenfield: no hay legado que respetar; el ADN se define en su forma ideal (libro, p. 60: en greenfield se proyecta la arquitectura ideal de la Fase 0).
2. Principios arquitectónicos
| # | Principio | Consecuencia práctica |
|---|---|---|
| P1 | Intención antes que código | Nada se construye sin EIS firmada por el Intent Director. |
| P2 | Contenido como datos | Capítulos, recursos, artefactos, regulaciones y comparativas viven en content collections tipadas, nunca incrustados en componentes. |
| P3 | Estático primero, isla después | Todo se renderiza a HTML estático en build. JavaScript solo en islas interactivas justificadas (scrollytelling, copiar/descargar recursos). |
| P4 | Rendimiento como restricción, no como deseo | Presupuestos numéricos del §7; superarlos bloquea el despliegue. |
| P5 | Accesibilidad WCAG 2.1 AA innegociable | Incluye prefers-reduced-motion en todo el efecto «WOW». |
| P6 | Coste 0 € | Solo free tiers. Cualquier componente que amenace coste se detiene y se propone sustituto gratuito. |
| P7 | Trazabilidad total | Cada commit referencia su EIS (EIS-XXX: descripción). El repositorio es el WORM práctico del proyecto. |
| P8 | Honestidad intelectual | La comparativa y la sección de cumplimiento distinguen siempre lo que Designio garantiza por diseño de lo que solo facilita. |
3. Decisión de stack (resumen — justificación completa en ADR-001)
| Capa | Elección | Versión autorizada | Por qué |
|---|---|---|---|
| Framework | Astro | 5.x (última estable) | Sitio mayormente estático con islas; 0 JS por defecto; content collections + MDX nativos; rendimiento Lighthouse ~100 de serie. |
| Contenido | MDX + Content Collections | integrado | Comparativa, regulaciones y artefactos como datos estructurados y tipados (Zod). |
| Estilos | CSS nativo con design tokens (custom properties, @layer, container queries) | — | Dirección de arte propia; prohibida estética de plantilla. Sin framework CSS. |
| Hosting + CDN | Cloudflare Pages | free tier | Ancho de banda y peticiones ilimitadas en free, CDN global, HTTPS automático (imprescindible: .dev está en la lista de precarga HSTS), 500 builds/mes. |
| CI/CD | Integración Git de Cloudflare Pages | — | push a main → build → deploy. Previews por rama. |
| Dominio | designio.dev (ya registrado en Porkbun) | — | DNS lo aplica el humano con instrucciones generadas por el agente. |
| Analítica (si se aprueba) | Cloudflare Web Analytics | free | Sin cookies, compatible RGPD sin banner. |
| PDF de artefactos | Generación en build (print CSS + @media print) o cliente (window.print() con hoja de estilo de marca) | — | Evita servicios de pago; decisión fina en construcción. |
Restricciones estructurales heredadas del encargo: gratuito y escalable (CDN global, estático/edge), HTTPS obligatorio, sin secretos en el repositorio, reproducible desde cero.
4. Stack tecnológico autorizado (lista blanca)
astro@5.x,@astrojs/mdx,@astrojs/sitemap,@astrojs/rsssharp(optimización de imágenes en build, víaastro:assets)zod(esquemas de colecciones; viene con Astro)- Tipografías self-hosted con licencia libre (OFL) — ver §8
- Node.js 22 LTS para build local y CI
- Todo lo demás está vetado salvo ADR firmado. En particular: React/Vue/Svelte como runtime global, jQuery, Bootstrap/Material/plantillas, GSAP de pago, Google Fonts por CDN (privacidad), cualquier SaaS con tarjeta de crédito.
5. Patrones de diseño obligatorios
- Arquitectura de contenido:
src/content/con coleccionesmetodologia,recursos,artefactos,comparativa,regulaciones,presentaciones. Cada entrada con frontmatter tipado (título, capítulo del libro de origen, estado, versión, fecha). - Plantilla de artefacto único: todos los documentos del pipeline se renderizan con el mismo layout de marca (cabecera: marca, título, versión, fecha, autor, estado; pie: marca y versión) y son exportables a PDF con el mismo estilo.
- Islas mínimas: un componente isla por necesidad real (p. ej.
CopyButton,ScrollStory). Animación por defecto con CSS (scroll-driven animationscon fallback) eIntersectionObserver; nada de librerías de animación pesadas. - Secciones-presentación («¿Por qué Designio?» 3a/3b/3c y Comparativa): patrón
scrollytelling con paneles
antes / ahoraenfrentados; cada afirmación ancla su capítulo del libro (componenteCitaLibrocon capítulo y página). - Cumplimiento: la matriz regulación → obligación (art./control) → artefacto Designio
→ cómo ayuda → garantiza/facilita se genera desde la colección
regulaciones, nunca a mano en HTML.
6. Linter mental consolidado
- TypeScript estricto (
strict: true) en todo.ts/.astro. - Nombres de ficheros de contenido en kebab-case y español (
adn-arquitectonico.mdx). - Componentes en PascalCase; un componente = una responsabilidad.
- HTML semántico: una
h1por página, jerarquía sin saltos,landmarksARIA solo cuando el elemento nativo no exista. - Imágenes siempre por
astro:assets(AVIF/WebP +width/heightexplícitos). - Enlaces externos con
rel="noopener"; los de fuentes oficiales citan fecha de consulta. - Prohibido
any, prohibido!important(salvo utilidades de impresión documentadas).
7. Presupuestos de rendimiento y calidad (bloqueantes)
| Métrica | Umbral |
|---|---|
| Lighthouse (móvil) Performance / A11y / Best Practices / SEO | ≥ 95 / 100 / 100 / 100 |
| LCP (móvil, 4G simulada) | < 2,0 s |
| CLS | < 0,1 |
| INP | < 200 ms |
| JS inicial por página (gzip) | < 50 KB (las páginas sin isla: 0 KB) |
| Tipografías totales (woff2, subset latín) | ≤ 120 KB |
| Health Score del sprint (libro, p. 100) | ≥ 98/100 |
8. Sistema de diseño — identidad derivada del libro
Concepto rector: «de la caja negra a la luz de la intención», fiel a la portada del
libro (decisión Q-12 del interrogatorio: la identidad gráfica es la de la portada,
docs/design/portada-libro-amazon.jpg): fondo espacial oscuro, cian luminoso como
luz de la intención (título y flujos de datos de la portada), oro en las aristas del
cubo del sprint, y el diamante EIS depositado en el cubo como imagen central del método.
8.1 Paleta (design tokens — derivados de la portada)
| Token | Valor | Rol y origen simbólico |
|---|---|---|
--tinta | #0A1018 | Fondo principal. El espacio oscuro de la portada (la «caja negra»). |
--tinta-2 | #101B26 | Superficies elevadas sobre fondo oscuro. |
--cian | #79DFE6 | Acento principal: la luz de la intención (titular y flujos de la portada). CTAs, enlaces, resaltados. |
--cian-intenso | #2BB8C9 | Subtítulos, estados activos, hilos de datos. |
--marfil | #F2F5F4 | Texto principal sobre oscuro. |
--oro | #C9A227 | Acento de soberanía: aristas del cubo, sellos, firmas. |
--azul-acero | #3E6B8F | Trazabilidad: hilos, líneas de tiempo, diagramas. |
--verde-certificado | #2E7D5B | Estados «firmado/certificado/garantiza». |
--rojo-stop | #B5443C | Puntos de control de soberanía, «STOP», «antes». |
| Contraste | — | Todo par texto/fondo cumple AA (≥ 4,5:1; ≥ 3:1 en texto grande). |
8.2 Tipografía (self-hosted, licencia OFL, coste 0 €)
| Uso | Fuente | Carácter |
|---|---|---|
| Display / títulos | Fraunces (variable) | Serif editorial con carácter: el libro, el manifiesto, la autoridad. |
| Texto / UI | Inter (variable) | Humanista, neutra, legible: la ingeniería. |
| Artefactos / EIS / código | IBM Plex Mono | El lenguaje estructurado que entienden los agentes. |
8.3 Motivos visuales (de la portada)
- El diamante EIS: la intención tallada como gema; marca las EIS y los CTAs principales.
- El cubo del sprint: cubo de aristas doradas con los días L-M-X-J-V grabados (portada); ilustra el ciclo semanal en Metodología y caso vivo.
- La chispa Designio: el asterisco-destello cian del pie de portada («✳ Metodología Designio») como base del favicon y la marca de sección.
- El sello de firma: marca circular (oro) en artefactos certificados.
- El hilo de trazabilidad: flujo de datos cian/azul (como las corrientes de la portada) que conecta requisito → EIS → interrogatorio → firma en la sección meta.
- Antes / Ahora: paneles enfrentados (rojo desaturado/oscuro vs claro/oro) en las tres secciones-presentación y en seguridad.
- Micro-interacciones: revelado al hacer scroll, contadores, subrayados animados —
siempre bajo
prefers-reduced-motion: reduce→ estado final sin animación.
8.4 Marca documental
Todo artefacto-documento lleva cabecera «Soberanía de la Intención · Designio» con título, versión, fecha, autor/Intent Director y estado (borrador / refinado / firmado), y pie con marca y número de versión — en web y en PDF exportado.
9. Restricciones negativas (cercas explícitas para la IA)
- Prohibido introducir backend, base de datos o estado de servidor: el sitio es
estático/edge. Formularios de contacto:
mailto:o servicio free aprobado por ADR. - Prohibido todo coste: ningún servicio que requiera tarjeta o plan de pago.
- Prohibido incluir secretos, tokens o claves en el repositorio o en el build.
- Prohibido el JavaScript global de frameworks UI; solo islas Astro puntuales.
- Prohibido usar plantillas o temas de terceros: la dirección de arte es propia (§8).
- Prohibido publicar el texto íntegro del libro o capítulos completos: solo extractos, citas con página y síntesis propias. El PDF del libro no entra al repo.
- Prohibido reproducir literalmente documentación de metodologías de terceros (Spec Kit, Kiro, BMAD…): parafrasear y citar fuente.
- Prohibido afirmar cumplimiento normativo garantizado: usar siempre la distinción garantiza por diseño vs facilita (el libro advierte que ninguna metodología «te hace cumplir» una norma).
- Prohibido trackers de terceros con cookies; analítica solo cookieless aprobada.
- Prohibido que el agente toque DNS, ejecute logins/OAuth o introduzca credenciales: prepara instrucciones y se detiene; ejecuta el humano.
- Prohibido animar sin respetar
prefers-reduced-motiono romper los presupuestos §7. - Prohibido inventar contenido del libro: toda afirmación sobre la metodología debe poder trazarse a capítulo/página; si no existe, se pregunta al Intent Director.
10. Reglas de gobierno (qué decide el agente, qué firma el humano)
| Nivel (Trust Thresholds del libro, pp. 50-52) | Acciones | Quién decide |
|---|---|---|
| Nivel 1 — autonomía | Formateo, refactor sin cambio de comportamiento, optimización de imágenes, correcciones de estilo dentro del ADN | Agente, con registro en commit |
| Nivel 2 — validación de intención | Contenido nuevo de páginas, cambios en EIS de presentación, estructura de navegación | Firma del Intent Director |
| Nivel 3 — soberanía (STOP obligatorio) | Creación del repositorio, despliegue, DNS, cualquier login/credencial, publicación del bloque a editoriales, puntuaciones finales de la comparativa, todo lo que toque coste | Marcos ejecuta o firma explícitamente |
Puntos de control de soberanía (libro, pp. 87-88) aplicados a este proyecto: publicar contenido que cite el libro textualmente más allá de una frase → STOP; añadir dependencia fuera de la lista blanca → STOP; cualquier acción con credenciales → STOP.
11. Deuda técnica permitida y anti-patrones aceptados
- Se acepta generar el PDF de artefactos vía CSS de impresión (no pixel-perfect respecto al render web) para mantener coste 0 €.
- Se acepta que el «Caso práctico vivo» publique artefactos en estado borrador con su estado visible — es parte de la demostración del método, no un defecto.
- Se acepta
window.print()como mecanismo de exportación si la generación en build resultara costosa en mantenimiento (decisión a registrar en ADR menor).
12. Supuestos marcados (requieren confirmación del Intent Director)
[SUPUESTO]Cuenta de Cloudflare gratuita disponible o creable por Marcos.[SUPUESTO]El contenido del libro puede citarse libremente (propiedad del autor).[SUPUESTO]Idioma inicial de la web: español (el libro solo existe en español); el bloque a editoriales menciona la traducción como oportunidad.
Soberanía de la Intención · Designio — ADN Arquitectónico v0.2 — Estado: FIRMADO por el Intent Director el 2026-06-12 (acta, artefacto 06).