# ALTHEIA Sector Blueprint Architect 1.6 ## Propósito Sector Blueprint Architect convierte un briefing de negocio y research en el paquete de especificaciones necesario para habilitar un nuevo sector en ALTHEIA. El módulo no genera perfiles finales: crea, audita y versiona el contrato que consumirán Profiles Generator, Archetyping, Master Farm y los módulos de simulación. ## Decisión arquitectónica ALTHEIA Core 2.5.1 se organiza en tres capas: 1. **Registro canónico**: 45 capacidades conductuales con identidad estable independiente de los slots. 2. **Core multisector**: identidad, gobierno, evidencia, procedencia, calidad, escala 1–10 y slots operativos `D01–D45`. 3. **Sector Pack**: clasificación core/adapted/sector, medición, evidencia, aplicabilidad, relaciones, arquetipos y adaptadores. Las 45 posiciones son estables, pero su alcance queda declarado explícitamente: - `core`: conserva literalmente ID, etiqueta, definición y anclajes del registro. - `adapted`: conserva `canonical_dimension_id`, capacidad y dirección, y exige `adaptation_rationale`. - `sector`: no tiene identidad canónica y exige `sector_rationale` que demuestre un gap. No se permite inferir el significado de una dimensión solo por su código `Dxx`. Cada consumidor debe resolverla mediante el Sector Pack activo. ## Artefactos de salida - `sector-research-brief.md`: briefing consolidado y preguntas de investigación. - `sector-prompt-pack.md`: secuencia de prompts para discovery, ficha, dimensiones, relaciones, arquetipos e impacto. - `sector-blueprint-draft.json`: scaffold trazable previo a investigación. - `sector-pack.json`: resultado final conforme a `altheia_sector_pack_1.1`. - `validation-report.json`: controles de estructura, 45 dimensiones, unicidad, taxonomías, fuentes e impacto. - `architect-configuration.json`: configuración portátil del asistente, briefing, artefactos, Sector Pack importado y validación. - `sector-pack.xlsx`: vista documental en doce hojas, incluidas Medición y Aplicabilidad. - `archetype-catalog.json`: catálogo derivado y trazable para Taxonomy y Archetyping; referencia siempre el `sector_id` y `pack_version` de origen. El JSON del Sector Pack continúa siendo la fuente maestra. Excel y el catálogo de arquetipos son vistas derivadas y no deben editarse como contratos independientes. Todas las descargas utilizan el `sector_id` efectivo e incorporan un timestamp local `AAAAMMDD_HHMMSS`. El patrón es `altheia___v1_6_.`. ## Asistente inicial de briefing El asistente recoge cinco bloques de conocimiento: sector, objetivo de investigación, actores, oferta/conocimiento disponible y restricciones. Genera un prompt reproducible cuya única salida admitida es un JSON de briefing inicial. Ese JSON no se considera investigación validada ni Sector Pack. Su función es rellenar la primera configuración para que el usuario la revise antes de construir el blueprint. La configuración completa cumple `altheia_sector_blueprint_architect_configuration_1.6` y puede: - guardarse y recuperarse localmente en el navegador; - exportarse como JSON portátil; - importarse para continuar el trabajo en otra sesión; - conservar los artefactos construidos y el último informe de validación. Al importar directamente un Sector Pack, el módulo reconstruye además la configuración disponible en el contrato: identidad y descripción del sector, mercados, idiomas, modelos de negocio, actores derivados de la relación, oferta, lifecycle, canales, decisiones, relación, regulación, método, fuentes, cobertura core y estrategia de arquetipos. El Sector Pack no contiene las respuestas originales del asistente ni todos los artefactos intermedios; para restaurar una sesión con fidelidad completa debe importarse `architect-configuration.json`. ## Organización de la interfaz 1.6 La pestaña **Briefing** es el punto de entrada. Reúne el contexto que delimita qué debe investigar y modelar el Sector Pack: alcance, actores, oferta, ciclo de relación, canales, decisiones, relación con marcas o proveedores, regulación, objetivos y fuentes. El Asistente de Configuración Inicial se presenta plegado para no competir con el briefing. La ayuda contextual de arquetipos explica las estrategias general, sectorial e híbrida sin sacar al usuario de la tarea. Las acciones globales Guardar, Importar configuración, Exportar configuración y Nuevo se mantienen visibles en una botonera horizontal; las acciones especializadas permanecen en la columna lateral. El indicador de progreso representa tres fases: Definir, Generar Sector Pack y Revisar y aprobar. Los artefactos técnicos permanecen accesibles como vistas auxiliares, pero ya no se presentan como pasos independientes. ## Normalización tolerante de resultados LLM La versión 1.6 mantiene una capa determinista entre el LLM y el contrato oficial. Reconoce alias habituales y conserva los bloques técnicos nuevos cuando están presentes. El normalizador construye las claves oficiales de `altheia_sector_pack_1.1`, registra las conversiones y ejecuta el validador. No inventa medición, evidencia, aplicabilidad o razones ausentes: esos huecos quedan como errores explícitos. La normalización reduce la dependencia del cumplimiento literal por parte del LLM, pero no sustituye la revisión metodológica, de dominio, evidencia, privacidad o gobierno. ## Exportaciones derivadas La exportación Excel se habilita cuando el Sector Pack no contiene errores estructurales. El libro organiza la información en doce pestañas: Resumen, Definición general, Ficha de perfil, Catálogos, Dimensiones, Medición, Aplicabilidad, Relaciones, Arquetipos, Adaptadores, Fuentes y Quality Gate. La taxonomía de arquetipos vive dentro del Sector Pack en `archetype_taxonomy`. El botón **Exportar catálogo de arquetipos** genera `altheia_archetype_catalog_1.0` como adaptador de consumo, evitando mantener taxonomías duplicadas o desincronizadas. ## Packs generales y configuraciones de cliente Un sector debe disponer de un Sector Pack canónico, por ejemplo `insurance`. Las particularidades de DKV, Sanitas u otra organización deben modelarse preferentemente como una extensión de marca o cliente que referencia una versión concreta del pack general. La extensión puede especializar catálogos, canales, vocabulario, relaciones, campos y reglas de activación, pero no debe redefinir silenciosamente las dimensiones core ni romper su comparabilidad. Mientras no exista un contrato formal de overlays, una configuración de cliente debe exportarse como un Sector Pack completo con identificador propio —por ejemplo `insurance-dkv`—, documentando en procedencia el pack base y la versión de la que deriva. ## Flujo de mejora y aprobación Una validación `review` permite generar un prompt de mejora basado únicamente en los controles fallidos o advertidos. Las advertencias sobre cobertura core exigen decisión metodológica; las de fuentes exigen referencias verificables y no pueden resolverse inventando procedencia. La mejora utiliza un contrato de parche para evitar los límites de lectura y generación de los LLM: 1. ALTHEIA conserva localmente el Sector Pack completo. 2. Genera un único paquete compacto con las instrucciones para el LLM, los controles, los metadatos y un resumen metodológico de D01–D45. 3. El LLM devuelve únicamente `altheia_sector_pack_improvement_patch_1.0`, con cambios de scope, fuentes verificadas y cuestiones no resueltas. 4. ALTHEIA valida y aplica el parche sobre el pack completo y ejecuta automáticamente el Quality Gate. El LLM nunca debe reconstruir ni devolver las 45 dimensiones, arquetipos, adaptadores o gobierno durante una mejora. Esto elimina el truncamiento observado en adjuntos grandes y conserva intactos los bloques ya validados. La aprobación solo se habilita cuando: 1. no existen errores ni advertencias estructurales; 2. research ha revisado método, evidencia y comparabilidad; 3. un responsable de dominio ha revisado contenido, regulación y riesgos; 4. medición ha revisado reglas, inputs, missingness y evidencia mínima; 5. aplicabilidad ha revisado intenciones, keywords, tipos de pregunta y relaciones; 6. existe un responsable de aprobación identificado. Al aprobar, el módulo actualiza el Sector Pack a `status: approved`, establece `quality_gate.status: passed` e incorpora checks trazables de revisión humana. ## Quality gate mínimo Un Sector Pack solo puede pasar a `approved` cuando: 1. contiene exactamente `D01–D45`, sin huecos ni duplicados; 2. conserva como `core` las dimensiones cuya semántica no cambia; 3. documenta cada adaptación y dimensión sectorial; 4. diferencia estado, rol, tipo e intensidad de relación con la marca/proveedor; 5. define al menos cuatro arquetipos con elegibilidad, evidencia y exclusiones; 6. cita fuentes con fecha y distingue hechos, supuestos y decisiones de diseño; 7. declara el impacto en Profiles Generator, Archetyping, Master Farm y cada simulador; 8. ha sido revisado por research, dominio, medición y aplicabilidad. ## Compatibilidad con Banca Banca 1.2 es el primer pack canonizado contra `altheia_dimension_registry_1.0`. Conserva la semántica, anclajes y reglas de Banca 1.1, clasifica 39 dimensiones core y 6 adapted y añade linaje, medición, evidencia y aplicabilidad. Tras completar la migración de consumidores, es el baseline activo de Core 2.5.1; Banca 1.1 se conserva sin alteraciones como histórico. ## Flujo operativo 1. Responder el asistente inicial o completar directamente el briefing. 2. Ejecutar el prompt inicial y cargar su JSON, cuando se utilice el asistente. 3. Revisar el briefing y construir el blueprint. 4. Generar y ejecutar el prompt pack con investigación trazable. 5. Importar el Sector Pack propuesto. 6. Resolver errores y advertencias del validador. 7. Aprobar el Sector Pack y ejecutar las pruebas de los módulos consumidores. ## Versionado - Aplicación: `sector_blueprint_architect_1.6`. - Configuración portátil: `altheia_sector_blueprint_architect_configuration_1.6`. - Parche de mejora: `altheia_sector_pack_improvement_patch_1.0`. - Catálogo derivado de arquetipos: `altheia_archetype_catalog_1.0`. - Registro: `altheia_dimension_registry_1.0`. - Schema: `altheia_sector_pack_1.1`. - Suite: Core 2.5.1. Todos los consumidores activos resuelven capacidades por `canonical_dimension_id`; Banca 1.2 es el pack operativo y Banca 1.1 queda limitada a compatibilidad histórica. - Un cambio semántico en una dimensión o taxonomía exige nueva versión del Sector Pack.