Soberanía de la Intención · Designio
Documento de Requisitos Iniciales (Requisitos Maestros)
Soberanía de la Intención · Designio
Documento de Requisitos Iniciales — Web oficial designio.dev
Artefacto 03 del pipeline. Primer artefacto de requisitos — no son las EIS. De aquí se destilan las EIS atómicas (artefacto 04). Incluye requisitos explícitos, implícitos y la búsqueda de huecos funcionales (§5): el sistema propone, el humano decide.
0. Glosario de lenguaje ubicuo (extracto operativo)
| Término | Definición (del libro) |
|---|---|
| EIS | Especificación Ejecutable de Intenciones: unidad mínima de intención, ejecutable por agente y auditable por humano (pp. 24-27). |
| Intent Director | Rol humano que dirige la intención; aquí: Marcos Fernández Otero. |
| BO | Business Owner, guardián del valor; aquí: el mismo. |
| ADN Arquitectónico / MAP | Ley técnica del proyecto / prompt maestro derivado (pp. 55-59). |
| Agente Interrogador (AI-Refiner) | Confronta los requisitos contra su ambigüedad hasta ~5 % residual (pp. 84-86). |
| Caso práctico vivo | Sección de la web que publica los artefactos de su propia construcción. |
| Antes / Ahora | Patrón visual de las secciones-presentación (SDLC, seguridad). |
| Garantiza vs facilita | Distinción obligatoria del análisis de cumplimiento (deontología del libro, p. 33). |
1. Anclajes técnicos
Stack y restricciones fijados en ADN §3-§7 y ADR-001:
Astro 5 + Cloudflare Pages free, dominio designio.dev (Porkbun, HTTPS/HSTS obligatorio),
coste 0 €, CSS propio con tokens del ADN §8, despliegue continuo desde GitHub (repo privado),
acciones de Nivel 3 siempre humanas.
2. Requisitos funcionales (RF) — explícitos del prompt fundacional
| ID | Título | Descripción | Origen | Prioridad |
|---|---|---|---|---|
| RF-01 | Home con hero «WOW» | Portada con identidad del libro, síntesis (fin de la era del código → soberanía de la intención) y CTAs a libro, metodología y recursos. | §6.1 | P1 |
| RF-02 | Página «El Libro» | Sinopsis, índice, a quién va dirigido, autor, argumentos de venta y CTA. | §6.2 | P1 |
| RF-03 | Bloque para editoriales | Dentro de «El Libro»: propuesta de publicación y traducción (hoy solo en español; abrir puerta a edición internacional). | §6.2 | P1 |
| RF-04 | Presentación 3a — SDLC antes/ahora | Scrollytelling: SDLC tradicional vs SDLC agéntico Designio, anclado a caps. 0.1, 7 y 8. | §6.3a | P1 |
| RF-05 | Presentación 3b — Seguridad antes/ahora | Scrollytelling: caja negra vs modelo Designio (Guardián, egress proxy, lista blanca, WORM, identidades, Sentinel, certificación). Caps. 0.2, 4 y fase 5. | §6.3b | P1 |
| RF-06 | Análisis de cumplimiento por regulación | Para EU AI Act, DORA, RGPD, ISO 27001/17/18, PCI y OWASP (incl. Top 10 LLM): obligaciones concretas (art./control) → artefacto/paso Designio → cómo ayuda → garantiza vs facilita. Fuentes oficiales con fecha de consulta; AI Act con vigencias escalonadas. | §6.3c | P1 |
| RF-07 | Presentación 3c — Cumplimiento | Render visual del RF-06 como matriz navegable por regulación + scrollytelling. Publicado además como artefacto en el caso vivo. | §6.3c | P1 |
| RF-08 | Página «La Metodología Designio» | Fundamentos y fases del libro: pilares, Fase 0, sprint semanal, ecosistema técnico, infra del cliente, jerarquía de inteligencia/fallback, dividendo de la intención. | §6.4 | P1 |
| RF-09 | Sección «Recursos» | Plantillas descargables y copiables: System Prompt/ADN, MAP, plantilla maestra de EIS, carta AIGB, RoE, Matriz de Umbrales de Confianza, checklist de readiness, plantilla de sprint semanal. Botón copiar + descarga por recurso. | §6.5 | P1 |
| RF-10 | Sección «Cómo se construyó esta web» | Caso práctico vivo: todos los artefactos del pipeline publicados en orden (ADN → MAP → Requisitos → EIS → interrogatorio → certificación/firma → plan → comparativa → ADRs → log de sprint), con registro que se actualiza. | §6.6 | P1 |
| RF-11 | Generación de la comparativa | Comparativa Designio vs metodologías más usadas (verificar con búsqueda web: Spec Kit, Kiro, BMAD, DDD, Agile+IA…), categorías decididas por el modelo, 0-100 por categoría + final 0-100, sin adopción/madurez (motivo explicado), lectura exhaustiva del libro por categoría documentando capítulos, honestidad intelectual. | §7 | P1 |
| RF-12 | Render de la comparativa como presentación | Resumen primero (tabla de puntuaciones + final, Designio destacada), detalle después una vista por categoría (porqué, capítulos del libro, fuentes, dónde gana/pierde cada una). Prompt exacto y modelo (nombre y versión) visibles en la página. | §7 | P1 |
| RF-13 | Página «Autor / Contacto» | Bio de Marcos Fernández Otero y vía de contacto. | §6.8 | P2 |
| RF-14 | Plantilla documental de marca | Todo artefacto con cabecera (marca, título, versión, fecha, autor, estado) y pie (marca, versión); render web + exportable a PDF con el mismo estilo. | §9 | P1 |
| RF-15 | Repositorio GitHub privado + CI/CD | Repo privado en la cuenta de Marcos (GitHub vía Google marcos.socram@gmail.com), README, historial limpio (commits por artefacto/EIS), deploy continuo push→build→deploy. Login/OAuth lo ejecuta el humano. | §4 | P1 |
| RF-16 | Conexión del dominio | Instrucciones DNS exactas para Porkbun; los registros los aplica Marcos. HTTPS automático operativo. | §5 | P1 |
| RF-17 | Capítulo de muestra descargable | PDF gratuito con el capítulo 3 (el sprint, pp. 83-114) maquetado con marca, con CTA de compra al final. (Origen: hueco H-02 aprobado por el BO, Q-01.) | Interrogatorio s.1 | P2 |
| RF-18 | Puesta en producción (release final) | Última EIS del último sprint: verificación integral del Definition of Done (§10) con evidencias, release v1.0.0, despliegue definitivo en designio.dev, smoke tests y UAT en producción, cierre del Traceability Log/WORM (todas las EIS «Satisfechas»), reporte final, retrospectiva y OK Final firmado por el BO. (Origen: feedback BO sesión 2, Q-14.) | Interrogatorio s.2 | P1 |
3. Requisitos no funcionales (RNF)
| ID | Categoría | Métrica / umbral | Origen |
|---|---|---|---|
| RNF-01 | Coste | 0 € totales; solo free tiers; si algo amenaza coste → STOP y alternativa. | §2 |
| RNF-02 | Rendimiento | Presupuestos del ADN §7 (Lighthouse ≥95 móvil, LCP <2 s, CLS <0,1, INP <200 ms, JS <50 KB/página). | §8 |
| RNF-03 | Accesibilidad | WCAG 2.1 AA; prefers-reduced-motion en todas las animaciones; navegable por teclado. | §8 |
| RNF-04 | Seguridad | HTTPS (HSTS preload por .dev); sin secretos en repo; cabeceras: CSP, X-Content-Type-Options, Referrer-Policy, Permissions-Policy. | §2 |
| RNF-05 | Escalabilidad | Estático en CDN global; tráfico alto sin cambio de paradigma. | §2 |
| RNF-06 | Privacidad (RGPD) | Sin cookies de seguimiento ni trackers de terceros; analítica solo cookieless (si se aprueba). | implícito §2/§6.3c |
| RNF-07 | Propiedad intelectual | Libro: uso libre (autor = BO); terceros: parafrasear y citar; no reproducir docs literales. | §2 |
| RNF-08 | Reproducibilidad | README con instrucciones para reconstruir y desplegar desde cero. | §2 |
| RNF-09 | Trazabilidad | Cada commit referencia su EIS; artefactos versionados y publicados. | §1/§6.6 |
| RNF-10 | SEO | Sitemap, metadatos OG/Twitter, canonical, robots.txt; HTML semántico. | implícito RF-01/02 |
| RNF-11 | Idioma | Español (única edición del libro). Ver hueco H-01. | implícito |
| RNF-12 | Responsive | Diseño correcto de 360 px a 1920 px. | §8 |
4. Requisitos implícitos detectados (RI) — con resolución por defecto
| ID | Título | Resolución [ASUMIDA POR DEFECTO] | Riesgo si se ignora |
|---|---|---|---|
| RI-01 | Página 404 de marca | Crear 404 con navegación de vuelta. | Fuga de visitantes; imagen pobre. |
| RI-02 | Favicon + iconos + manifest | Derivados del motivo «sello» del ADN §8. | Marca incompleta en pestañas/compartidos. |
| RI-03 | Imágenes Open Graph | OG por defecto + específica para Libro y Comparativa. | Compartidos en redes sin atractivo. |
| RI-04 | Enlace de compra del libro | RESUELTO (Q-04): https://www.amazon.es/dp/B0H4X2QQCK (URL canónica; 19,95 €, 9-jun-2026, ISBN-13 979-8180875228, 170 pp.). | — |
| RI-05 | Email público de contacto | RESUELTO (Q-05): sin email público por ahora; contacto vía LinkedIn del autor. Revisable. | Canal menos directo para editoriales (mitigado con LinkedIn). |
| RI-06 | Redirección www→apex | Configurar en Cloudflare al conectar dominio. | URLs duplicadas, SEO diluido. |
| RI-07 | Licencia del repositorio | RESUELTO (Q-11): todos los derechos reservados. | — |
| RI-08 | Fecha de versión en análisis de cumplimiento | Cada análisis normativo lleva «versión consultada el AAAA-MM-DD». | Contenido normativo caduco sin aviso (AI Act evoluciona). |
| RI-09 | Aviso legal / nota de IA | Nota al pie estilo libro: contenidos elaborados con asistencia de IA bajo dirección del autor. | Coherencia con la transparencia que el libro practica. |
| RI-10 | Robots / crawlers de IA | RESUELTO (Q-09): permitir buscadores y crawlers de IA. | — |
5. Huecos funcionales detectados (gap analysis) — PROPUESTOS, pendientes de decisión del BO
El sistema propone, el humano decide (libro, p. 162). Nada de esto se construye sin tu OK.
| ID | Hueco | Por qué importa | Coste estimado |
|---|---|---|---|
| H-01 | Versión en inglés de la web (o al menos de la página de editoriales) | El bloque a editoriales busca traducción internacional; un mínimo en inglés multiplica su alcance. | Medio (contenido ×2) |
| H-02 | Capítulo de muestra descargable (PDF gratuito) | APROBADO por el BO (Q-01) → promovido a RF-17 / EIS-023. Alcance: el capítulo del sprint. | — |
| H-03 | Kit de prensa (portada en alta, bio, sinopsis, datos del libro, contacto) | Editoriales y medios lo esperan; refuerza RF-03. | Bajo |
| H-04 | Glosario público del lenguaje Designio | El libro define un vocabulario propio; un diccionario ubicuo navegable refuerza marca y SEO. | Bajo-medio |
| H-05 | Newsletter / lista de correo | Captación de lectores antes/después de comprar. | Servicio externo free (evaluar RGPD) |
| H-06 | Blog / novedades | SEO continuo y canal del autor; sin él la web queda congelada en el tiempo. | Medio (compromiso editorial) |
| H-07 | FAQ con datos estructurados (schema.org) | Responde objeciones y mejora resultados enriquecidos. | Bajo |
| H-08 | Selector claro/oscuro | La identidad es oscura por concepto; algunos lectores prefieren claro en textos largos. | Bajo |
| H-09 | Formulario de contacto real (vs mailto:) | Más profesional para editoriales; requiere servicio externo free → evaluar contra RNF-01/06. | Bajo |
| H-10 | OG images por página | Cada artefacto/recurso compartible con su tarjeta propia. | Medio |
6. Requisitos derivados del Blueprint (RB)
| ID | Título | Origen |
|---|---|---|
| RB-01 | Contenido como colecciones tipadas (metodologia, recursos, artefactos, regulaciones, comparativa, presentaciones). | ADN P2 / ADR-001 |
| RB-02 | Islas JS mínimas y justificadas; resto 0 KB JS. | ADN P3 |
| RB-03 | Tipografías OFL self-hosted (Fraunces, Inter, IBM Plex Mono) subsetted ≤120 KB. | ADN §8.2 |
| RB-04 | Cabeceras de seguridad vía _headers de Cloudflare Pages. | RNF-04 |
| RB-05 | Previews por rama para validación del Intent Director antes de merge a main. | ADR-001 |
| RB-06 | Verificación automática en build: enlaces internos, tipos de colecciones, presupuestos de peso. | ADN §7 |
7. Histórico de cambios
| Fecha | Versión | Cambio | Autor |
|---|---|---|---|
| 2026-06-12 | 0.1 | Versión inicial para interrogatorio y firma. | Agente Ingeniero de Intenciones |
| 2026-06-12 | 0.2 | Refinado con respuestas del interrogatorio sesión 1 (Q-01…Q-12): +RF-17 (capítulo de muestra), RI-04/05/07/10 resueltos, H-02 aprobado, resto de huecos a backlog. | Agente Ingeniero de Intenciones |
| 2026-06-12 | 0.3 | Sesión 2 (Q-14): +RF-18 — puesta en producción como release final verificado (EIS-024, EIS de cierre del último sprint). | Agente Ingeniero de Intenciones |
Soberanía de la Intención · Designio — Requisitos v0.3 — Estado: FIRMADO por el Intent Director el 2026-06-12 (acta, artefacto 06).