@ingeniomaps/cauce 0.2.0 → 0.4.0

package/agents/roles/system/growth-marketer/learning/sources.yaml

@@ -0,0 +1,27 @@
+version: 1
+rules:
+  require_primary_source: true
+  require_version_applicability: true
+  require_corroboration_for_major_change: true
+  reject_unsourced_claims: true
+  automatic_apply: false
+
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/growth-marketer.md dentro de cada instalación.
+sources:
+  - name: NIST Statistical Methods Handbook
+    url: https://www.itl.nist.gov/div898/handbook/
+    tier: primary-method
+    topics: [experiments, uncertainty, sampling, inference]
+  - name: ICC Advertising and Marketing Communications Code
+    url: https://iccwbo.org/business-codes/advertising-and-marketing-communications-code/
+    tier: professional-primary
+    topics: [claims, honesty, substantiation, disclosure]
+  - name: EDPB Guidelines on targeting and consent
+    url: https://www.edpb.europa.eu/our-work-tools/general-guidance/guidelines-recommendations-best-practices_en
+    tier: regulator-primary
+    topics: [privacy, consent, targeting, transfers]
+  - name: FTC Truth in Advertising
+    url: https://www.ftc.gov/business-guidance/advertising-marketing
+    tier: regulator-primary
+    topics: [claims, endorsements, substantiation, disclosure]

package/agents/roles/system/growth-marketer/references/operating-model.md

@@ -0,0 +1,76 @@
+# Modelo operativo de Growth Marketing
+
+## Contrato de embudo
+
+Antes de proponer inversión, cada etapa queda definida con la misma precisión que una métrica:
+
+- **Población**: quién entra y quién queda excluido, con la regla explícita.
+- **Etapas**: impresión, clic, visita, registro, activación y retención temprana, cada una con su
+  evento de origen y su ventana.
+- **Denominador**: contra qué se divide cada tasa. La mayoría de las discusiones de conversión son
+  desacuerdos sobre el denominador.
+- **Ventana de atribución**: declarada y constante entre comparaciones. Cambiarla a mitad de un análisis
+  invalida la serie.
+
+Una tasa sin población, ventana y denominador no es una métrica: es una opinión con decimales.
+
+## Economía unitaria
+
+Toda propuesta de inversión reporta, con supuestos visibles:
+
+- costo por resultado en la etapa que se está comprando;
+- costo de adquisición hasta el usuario activado, no hasta el registro;
+- margen de contribución y período de recuperación;
+- qué pasa si la conversión cae un tercio: si el caso sólo cierra en el escenario optimista, no cierra.
+
+El valor de vida se estima con cohortes observadas, no proyectando indefinidamente la retención del
+mejor mes.
+
+## Diseño de experimentos
+
+Antes de lanzar se escriben: hipótesis falsable, unidad de asignación, métrica primaria, métricas
+guardia, tamaño mínimo, duración y regla de decisión. Después de lanzar no se cambian.
+
+- Una sola métrica primaria. Varias métricas primarias es no tener ninguna.
+- Las métricas guardia protegen lo que el experimento podría romper: calidad del registro, carga de
+  soporte, tasa de reembolso, retención.
+- Mirar resultados antes de tiempo y cortar al ver un número favorable produce ganadores falsos.
+- Un resultado sin efecto también es un resultado: se registra, con el tamaño que se podría haber
+  detectado.
+
+## Atribución
+
+Ningún modelo de atribución es verdad. Se elige uno, se declara, y se lo trata como una lente:
+
+- Las cifras que reporta una plataforma publicitaria son de parte interesada y suelen sobreatribuir.
+- Se reconcilian contra datos propios; cuando la diferencia es grande, se reporta la diferencia en vez
+  de elegir el número conveniente.
+- Para decisiones grandes, contrastar con una prueba de incrementalidad —geo, holdout— antes que
+  discutir modelos.
+
+## Contenido y promesa
+
+Lo que se afirma en un anuncio o una landing es un compromiso del producto:
+
+- La promesa la valida quien es dueño del producto; el mensaje no crea capacidades.
+- Afirmaciones sobre resultados, seguridad, cumplimiento o comparaciones con competidores pasan por
+  legal antes de publicarse.
+- Un embudo que convierte porque promete de más traslada el costo a soporte y a la retención.
+
+## Privacidad
+
+- Minimizar datos personales: recolectar lo necesario para la decisión, no lo que sea posible.
+- Verificar base legal antes de construir audiencias, sincronizar listas o activar remarketing.
+- Coordinar con el especialista de privacidad cualquier transferencia a una plataforma externa.
+
+## Control de calidad
+
+Antes de entregar, verificar que la propuesta declara baseline, denominadores, ventana, regla de
+decisión, supuestos e incertidumbre; que el gasto tiene autorización registrada; que las métricas
+guardia existen; y que un resultado negativo también deja un aprendizaje utilizable.
+
+## Fundamento externo
+
+Los métodos de experimentación y medición se apoyan en fuentes primarias de estadística y en la
+documentación oficial de cada plataforma, con su versión y fecha. Un caso de éxito publicado por un
+proveedor es material comercial, no evidencia.

package/agents/roles/system/implementation-manager/SKILL.md

@@ -10,6 +10,8 @@ Convertir una solución acordada en una adopción operable y verificable, manten
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, `organization/`, contrato/SOW aprobados, solution design, promesas autorizadas y políticas aplicables.
+   Leer también `organization/roles/implementation-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Confirmar outcomes, alcance y no alcance, entregables, criterios de aceptación, fechas comprometidas, supuestos, dependencias y change process.
 3. Mapear sponsor, decision makers, workstream owners, usuarios, Product, Engineering, Security, Privacy, Legal, Support, Success y proveedores.
 4. Inventariar entornos, versiones, configuración, integraciones, datos, accesos, ventanas de cambio, soporte y restricciones regionales.

package/agents/roles/system/implementation-manager/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/implementation-manager.md dentro de cada instalación.
 sources:
-  - name: Company contracts product policies implementation and customer context
-    url: local://implementation-management-context
-    tier: company-primary
-    topics: [contracts, product, implementation, customers, authority, evidence]
   - name: ISO 21502 project management guidance
     url: https://www.iso.org/standard/74947.html
     tier: standards-primary

package/agents/roles/system/legal-counsel/SKILL.md

@@ -10,6 +10,8 @@ Preparar análisis y opciones para que una persona profesional autorizada decida
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, estructura empresarial, producto y políticas.
+   Leer también `organization/roles/legal-counsel.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar entidad, jurisdicción, foro, fecha relevante, partes, autoridad, hechos, objetivo, plazo y consecuencias.
 3. Confirmar qué abogado o función es responsable y si existen conflictos, secreto profesional, legal hold, investigación o aseguradora.
 4. Priorizar texto oficial vigente, registros, contratos ejecutados y evidencia contemporánea. Distinguir ley, reglamento, jurisprudencia, guía, estándar y política.

package/agents/roles/system/legal-counsel/learning/sources.yaml

@@ -7,15 +7,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/legal-counsel.md dentro de cada instalación.
 sources:
-  - name: Company executed agreements entity records policies and authorized matters
-    url: local://legal-context
-    tier: company-primary
-    topics: [entities, contracts, policies, authority, matters, obligations]
-  - name: Official legislation courts and regulator registers by jurisdiction
-    url: local://official-legal-registers
-    tier: jurisdiction-primary
-    topics: [law, regulation, case-law, guidance, effective-dates]
   - name: IBA guides and international principles
     url: https://www.ibanet.org/resources
     tier: professional-primary

package/agents/roles/system/machine-learning-engineer/SKILL.md

@@ -10,6 +10,8 @@ Construir sistemas cuyo comportamiento sea útil, medible y gobernable en su con
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, `organization/`, políticas de IA/datos, arquitectura, contratos, evaluaciones, incidentes y autoridades.
+   Leer también `organization/roles/machine-learning-engineer.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Definir decisión/outcome, usuarios y personas afectadas, costo de errores, alternativas, baseline sin ML y criterio para no construir.
 3. Mapear lifecycle de datos/modelo, owners, proveedores, versiones, licencias, propósito, consentimiento/base, sensibilidad, retención y restricciones.
 4. Clasificar impacto y riesgo por caso de uso, autonomía, escala, reversibilidad, exposición, poblaciones, jurisdicción y dependencia humana.

package/agents/roles/system/machine-learning-engineer/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/machine-learning-engineer.md dentro de cada instalación.
 sources:
-  - name: Company AI data product risk policies models evaluations and incident context
-    url: local://machine-learning-context
-    tier: company-primary
-    topics: [ai, data, product, risk, models, evaluations, incidents]
   - name: NIST Artificial Intelligence Risk Management Framework 1.0
     url: https://www.nist.gov/publications/artificial-intelligence-risk-management-framework-ai-rmf-10
     tier: government-primary

package/agents/roles/system/mlops-engineer/SKILL.md

@@ -10,6 +10,8 @@ Hacer que cada versión de un sistema ML sea trazable, reproducible, evaluada, d
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, `organization/`, model/system cards, data/feature contracts, SLO, políticas, riesgos, decisiones y runbooks.
+   Leer también `organization/roles/mlops-engineer.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar use case, owners, usuarios afectados, criticidad, modo batch/online/edge, autoridad, entornos, dependencias y restricciones.
 3. Inventariar datasets/snapshots, features, labels, código, parámetros, seeds, entorno, artefactos, firma, evaluaciones, imagen, infraestructura y lineage.
 4. Definir métricas técnicas, de modelo, negocio, seguridad y daño; baselines, slices, umbrales, ventanas, alertas, stops y rollback.

package/agents/roles/system/mlops-engineer/learning/sources.yaml

@@ -6,9 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/mlops-engineer.md dentro de cada instalación.
 sources:
-  - {name: Company AI inventory model cards data contracts SLO policies incidents and approved telemetry, url: "local://mlops-context", tier: company-primary, topics: [inventory, models, data, slo, policies, incidents]}
-  - {name: Approved platform framework and model official documentation, url: "local://approved-ml-platform-documentation", tier: vendor-primary, topics: [platform, framework, model, version, operations]}
   - {name: NIST AI RMF 1.0, url: "https://www.nist.gov/publications/artificial-intelligence-risk-management-framework-ai-rmf-10", tier: government-primary, topics: [ai-risk, lifecycle, monitoring, governance]}
   - {name: NIST SP 800-218A, url: "https://csrc.nist.gov/pubs/sp/800/218/a/final", tier: government-primary, topics: [secure-development, ai-models, supply-chain]}
   - {name: ISO IEC 42001 AI management systems, url: "https://www.iso.org/standard/42001", tier: standards-primary, topics: [ai-management, governance, improvement]}

package/agents/roles/system/mobile-engineer/SKILL.md

@@ -10,6 +10,8 @@ Actuar como responsable de experiencias móviles correctas, accesibles, seguras,
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json` e instrucciones de la aplicación.
+   Leer también `organization/roles/mobile-engineer.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar plataformas, lenguaje, framework, SDK, sistema de build, versiones mínimas y comandos reales. No asumir iOS, Android ni una solución multiplataforma.
 3. Leer aceptación, flujos de UX, diseño visual, contratos de API y políticas de seguridad y privacidad relevantes.
 4. Inspeccionar arquitectura, navegación, estado, persistencia, componentes y pruebas existentes antes de crear abstracciones o dependencias.

package/agents/roles/system/mobile-engineer/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/mobile-engineer.md dentro de cada instalación.
 sources:
-  - name: Project manifests and official stack docs
-    url: local://mobile-manifest
-    tier: project-primary
-    topics: [platforms, framework, sdk, minimum-versions, build]
   - name: Android Developers Core app quality
     url: https://developer.android.com/docs/quality-guidelines/core-app-quality
     tier: platform-primary

package/agents/roles/system/partnerships-manager/SKILL.md

@@ -10,6 +10,8 @@ Construir relaciones donde ambas partes aporten capacidades complementarias y ob
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, estrategia, producto, ICP, GTM, políticas, contratos y portfolio de partners de la empresa.
+   Leer también `organization/roles/partnerships-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Definir outcome, problema, segmento, geografía, motion y capacidad faltante antes de buscar un socio.
 3. Mapear tipos de relación, partners actuales, solapamientos, exclusividades, conflictos de canal, dependencias y concentración.
 4. Identificar owners y autoridad de Product, Engineering, Sales, Marketing, Success, Finance, Security, Privacy, Legal y Procurement.

package/agents/roles/system/partnerships-manager/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/partnerships-manager.md dentro de cada instalación.
 sources:
-  - name: Company strategy policies contracts product GTM and partner records
-    url: local://partnerships-context
-    tier: company-primary
-    topics: [strategy, product, gtm, contracts, partners, authority]
   - name: ISO 44001 collaborative business relationships
     url: https://www.iso.org/standard/72798.html
     tier: standards-primary

package/agents/roles/system/people-operations-manager/SKILL.md

@@ -10,6 +10,8 @@ Diseñar el sistema de personas para que quienes tienen autoridad humana decidan
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, el contexto de empresa y sus políticas vigentes.
+   Leer también `organization/roles/people-operations-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar entidades, países, tipos de relación laboral, convenios, representación, idiomas y autoridades. No asumir jurisdicción.
 3. Mapear estructura, arquitectura de cargos, headcount aprobado, ciclo de vida, HRIS, proveedores, responsables y segregación de funciones.
 4. Confirmar propósito, población, criterios, datos permitidos, retención, accesibilidad, apelación y aprobaciones de cada proceso.

package/agents/roles/system/people-operations-manager/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/people-operations-manager.md dentro de cada instalación.
 sources:
-  - name: Company people policies agreements roles and approved aggregate data
-    url: local://people-operations-context
-    tier: company-primary
-    topics: [policies, agreements, roles, authority, lifecycle, aggregate-metrics]
   - name: ILO Fundamental Principles and Rights at Work
     url: https://www.ilo.org/topics-and-sectors/fundamental-principles-and-rights-work
     tier: international-primary

package/agents/roles/system/privacy-compliance-specialist/SKILL.md

@@ -10,6 +10,8 @@ Actuar como puente entre producto, tecnología, operaciones y responsables legal
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, contexto de empresa, políticas y contratos disponibles.
+   Leer también `organization/roles/privacy-compliance-specialist.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar entidades, jurisdicciones, sector, usuarios, productos, roles legales y autoridades relevantes. No asumir que una ley o rol aplica.
 3. Mapear categorías de datos, titulares, fuentes, finalidades, sistemas, accesos, destinatarios, ubicaciones, retención y borrado.
 4. Leer avisos, consentimientos, acuerdos, evaluaciones, incidentes y evidencia de controles antes de concluir cumplimiento.

package/agents/roles/system/privacy-compliance-specialist/learning/sources.yaml

@@ -6,15 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/privacy-compliance-specialist.md dentro de cada instalación.
 sources:
-  - name: Company entities data maps contracts policies and decisions
-    url: local://privacy-compliance-context
-    tier: company-primary
-    topics: [entities, jurisdictions, data, vendors, controls, evidence]
-  - name: Applicable official authorities and legislation
-    url: local://jurisdiction-official-sources
-    tier: legal-primary
-    topics: [laws, regulations, guidance, effective-dates]
   - name: NIST Privacy Framework
     url: https://www.nist.gov/privacy-framework
     tier: primary-framework

package/agents/roles/system/procurement-manager/SKILL.md

@@ -10,6 +10,8 @@ Optimizar valor total, resiliencia e impacto responsable mediante procesos compa
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, contexto empresarial y políticas de compras.
+   Leer también `organization/roles/procurement-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar entidad, jurisdicción, categoría, presupuesto, autoridad, umbrales, partes relacionadas, restricciones y fechas.
 3. Confirmar necesidad, usuarios, requisitos, alternativas internas, demanda, contrato vigente y coste de cambio.
 4. Mapear mercado, concentración, subproveedores, ubicaciones, datos, seguridad, continuidad, IP, sostenibilidad y obligaciones.

package/agents/roles/system/procurement-manager/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/procurement-manager.md dentro de cada instalación.
 sources:
-  - name: Company procurement policy contracts suppliers and approved aggregate spend
-    url: local://procurement-context
-    tier: company-primary
-    topics: [policy, authority, suppliers, contracts, spend, performance]
   - name: ISO 20400 sustainable procurement
     url: https://www.iso.org/standard/63026.html
     tier: standards-primary

package/agents/roles/system/product-manager/SKILL.md

@@ -11,6 +11,8 @@ Actuar como responsable del **qué** y el **por qué** del producto. Optimizar r
 
 1. Localizar la raíz operativa del proyecto.
 2. Leer `AGENTS.md`, `ops.config.json` y `organization/README.md` si existen.
+   Leer también `organization/roles/product-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 3. Leer `organization/company.md` y `organization/product.md`. Consultar otros documentos de `organization/` sólo cuando sean relevantes.
 4. Leer el estado necesario en `planning/`: primero `FLOW.md`; después roadmap, `INBOX.md`, `BACKLOG.md` o `DONE.md` según la tarea.
 5. Distinguir explícitamente entre hechos, evidencia, supuestos y preguntas abiertas. No inventar clientes, métricas, restricciones ni decisiones.

package/agents/roles/system/product-manager/learning/sources.yaml

@@ -5,6 +5,8 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/product-manager.md dentro de cada instalación.
 sources:
   - name: SVPG
     url: https://www.svpg.com/articles/

package/agents/roles/system/product-marketing-manager/SKILL.md

@@ -10,6 +10,8 @@ Actuar como responsable de que el mercado correcto entienda por qué el producto
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, contexto de empresa, producto, marca y planificación.
+   Leer también `organization/roles/product-marketing-manager.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar etapa, mercado, geografía, categoría, modelo comercial, canales, ciclo de compra, usuarios, compradores e influenciadores. No asumir B2B, B2C o self-service.
 3. Leer investigación, uso, ventas, soporte, churn, win/loss, roadmap aprobado, precios, claims, marca y campañas anteriores.
 4. Probar el producto o inspeccionar evidencia actual antes de describir capacidades, integración, seguridad o resultados.

package/agents/roles/system/product-marketing-manager/learning/sources.yaml

@@ -6,15 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/product-marketing-manager.md dentro de cada instalación.
 sources:
-  - name: Company product research sales support brand claims and performance
-    url: local://product-marketing-context
-    tier: company-primary
-    topics: [product, customers, positioning, claims, launches, metrics]
-  - name: Applicable advertising consumer and sector authorities
-    url: local://marketing-official-sources
-    tier: legal-primary
-    topics: [advertising, claims, endorsements, privacy, sector]
   - name: Product Marketing Alliance
     url: https://www.productmarketingalliance.com/
     tier: professional-primary

package/agents/roles/system/project-manager/SKILL.md

@@ -10,6 +10,8 @@ Crear un sistema de entrega transparente y adaptable. Coordinar decisiones y evi
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, contexto empresarial, roadmap y reglas de planificación.
+   Leer también `organization/roles/project-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar sponsor, outcome, beneficios, usuarios, alcance, exclusiones, restricciones, presupuesto, fecha objetivo y autoridad.
 3. Mapear equipo, ownership, capacidad, zonas horarias, proveedores, dependencias, decisiones y criterios de aceptación.
 4. Elegir enfoque predictivo, iterativo, incremental, adaptativo o híbrido según incertidumbre, riesgo y coste de cambio; no imponer un framework.

package/agents/roles/system/project-manager/learning/sources.yaml

@@ -5,11 +5,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/project-manager.md dentro de cada instalación.
 sources:
-  - name: Company strategy roadmap governance project records and delivery evidence
-    url: local://project-management-context
-    tier: company-primary
-    topics: [strategy, projects, governance, delivery, finance, risks, benefits]
   - name: ISO 21502 project management guidance
     url: https://committee.iso.org/sites/tc258/home/projects/published/iso-21502.html
     tier: standards-primary

package/agents/roles/system/qa-engineer/SKILL.md

@@ -10,6 +10,8 @@ Actuar como facilitador de calidad y proveedor de evidencia independiente. Busca
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, planificación e instrucciones del sistema bajo prueba.
+   Leer también `organization/roles/qa-engineer.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar producto, usuarios, criticidad, stack, entornos, integraciones, datos y comandos reales. No asumir herramientas.
 3. Leer criterios de aceptación, diseños, contratos, incidentes, métricas y políticas relevantes.
 4. Inspeccionar pruebas existentes, cobertura útil, pipeline, fixtures y defectos conocidos antes de añadir automatización.

package/agents/roles/system/qa-engineer/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/qa-engineer.md dentro de cada instalación.
 sources:
-  - name: Project requirements manifests tests and incidents
-    url: local://quality-context
-    tier: project-primary
-    topics: [acceptance, risks, stack, tests, incidents]
   - name: ISTQB CTFL
     url: https://www.istqb.org/certifications/certified-tester-foundation-level-ctfl-v4-0/
     tier: professional-primary

package/agents/roles/system/release-manager/SKILL.md

@@ -10,6 +10,8 @@ Orquestar la decisión y el recorrido de una versión sin convertirse en dueño
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, políticas de cambio, arquitectura, SLO, runbooks y calendario.
+   Leer también `organization/roles/release-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar servicios/plataformas, usuarios, entornos, regiones, tiendas, canales, owners, on-call, aprobadores, ventanas y restricciones.
 3. Fijar candidato inmutable: versión, commit, artefacto/digest, configuración, migraciones, flags, dependencias y procedencia.
 4. Mapear cambios, compatibilidad, riesgos, blast radius, señales, soporte, comunicación, rollout y rollback/roll-forward.

package/agents/roles/system/release-manager/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/release-manager.md dentro de cada instalación.
 sources:
-  - name: Company release policies pipelines artifacts incidents SLOs and approved metrics
-    url: local://release-management-context
-    tier: company-primary
-    topics: [policy, pipelines, artifacts, services, incidents, slo, metrics]
   - name: DORA continuous delivery
     url: https://dora.dev/capabilities/continuous-delivery/
     tier: primary-research

package/agents/roles/system/revenue-operations-manager/SKILL.md

@@ -10,6 +10,8 @@ Construir una vista coherente del recorrido desde demanda hasta retención y exp
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, estrategia, segmentos, oferta, contratos, políticas y definiciones financieras.
+   Leer también `organization/roles/revenue-operations-manager.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar entidades, monedas, canales, motions, productos, ICP, cuentas, contactos, oportunidades, contratos, suscripciones e invoices.
 3. Mapear sistemas y owners: marketing automation, CRM, product analytics, support, billing, ERP y warehouse.
 4. Confirmar definiciones, grain, IDs, timestamps, source of truth, calidad, permisos, retención y reconciliación de cada métrica.

package/agents/roles/system/revenue-operations-manager/learning/sources.yaml

@@ -7,11 +7,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/revenue-operations-manager.md dentro de cada instalación.
 sources:
-  - name: Company go to market policies systems contracts and approved metrics
-    url: local://revenue-operations-context
-    tier: company-primary
-    topics: [gtm, lifecycle, crm, contracts, billing, finance, metrics]
   - name: ISO 8000-61 data quality management
     url: https://www.iso.org/standard/63086.html
     tier: standards-primary

package/agents/roles/system/sales-representative/SKILL.md

@@ -10,6 +10,8 @@ Actuar como responsable de descubrir si existe un problema importante, un fit ho
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, contexto de empresa, producto, mercado y políticas comerciales.
+   Leer también `organization/roles/sales-representative.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar modelo de venta, ICP, territorios, canales, producto disponible, pricing aprobado, autoridad de descuento, CRM y etapas reales. No asumir proceso.
 3. Leer investigación de cuenta, interacciones consentidas, uso, soporte, oportunidades, pérdidas, claims, contratos y materiales vigentes.
 4. Verificar capacidades, integraciones, seguridad, disponibilidad, referencias y condiciones antes de mencionarlas.

package/agents/roles/system/sales-representative/learning/sources.yaml

@@ -6,15 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/sales-representative.md dentro de cada instalación.
 sources:
-  - name: Company ICP product pricing CRM stages claims and sales policies
-    url: local://sales-context
-    tier: company-primary
-    topics: [icp, product, pricing, crm, qualification, claims]
-  - name: Applicable direct marketing consumer and sector authorities
-    url: local://sales-official-sources
-    tier: legal-primary
-    topics: [outreach, privacy, consumer, contracts, sector]
   - name: ICC Marketing Communications Code
     url: https://iccwbo.org/business-solutions/the-icc-advertising-and-marketing-communications-code/
     tier: primary-code

package/agents/roles/system/security-engineer/SKILL.md

@@ -10,6 +10,8 @@ Actuar como responsable de identificar riesgos reales y proponer controles propo
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, políticas, arquitectura e instrucciones aplicables.
+   Leer también `organization/roles/security-engineer.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar activos, actores, datos, límites de confianza, superficies expuestas, dependencias, entornos y ownership. No asumir stack ni amenaza.
 3. Leer contratos, flujos de identidad, clasificación de datos, incidentes, controles y tolerancia al riesgo vigentes.
 4. Inspeccionar código, configuración, manifests, lockfiles, pipelines y pruebas antes de recomendar tecnología o controles nuevos.

package/agents/roles/system/security-engineer/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/security-engineer.md dentro de cada instalación.
 sources:
-  - name: Project architecture code policies incidents and inventories
-    url: local://security-context
-    tier: project-primary
-    topics: [assets, trust-boundaries, data, controls, dependencies]
   - name: NIST Secure Software Development Framework
     url: https://csrc.nist.gov/pubs/sp/800/218/final
     tier: primary-standard

package/agents/roles/system/site-reliability-engineer/SKILL.md

@@ -10,6 +10,8 @@ Actuar como responsable de convertir expectativas de usuario en objetivos de con
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, arquitectura, runbooks y límites de cada entorno.
+   Leer también `organization/roles/site-reliability-engineer.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar servicios, usuarios, recorridos críticos, dependencias, ownership, telemetría, despliegue y comandos reales. No asumir plataforma.
 3. Leer SLI/SLO, incidentes, alertas, capacidad, RTO/RPO, políticas y decisiones de riesgo vigentes.
 4. Inspeccionar dashboards, consultas, instrumentación y automatización existentes antes de crear señales nuevas.

package/agents/roles/system/site-reliability-engineer/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/site-reliability-engineer.md dentro de cada instalación.
 sources:
-  - name: Project architecture telemetry SLO incidents and runbooks
-    url: local://reliability-context
-    tier: project-primary
-    topics: [services, slo, alerts, incidents, recovery]
   - name: Google Site Reliability Engineering
     url: https://sre.google/sre-book/table-of-contents/
     tier: primary-practice

package/agents/roles/system/software-architect/SKILL.md

@@ -10,6 +10,8 @@ Actuar como responsable de decisiones técnicas de alto impacto, explícitas y r
 ## Construir contexto
 
 1. Localizar la raíz operativa y leer `AGENTS.md`, `ops.config.json`, contexto de empresa, producto y planificación.
+   Leer también `organization/roles/software-architect.md` si existe: son las restricciones
+   reales de esta empresa para este cargo.
 2. Identificar sistemas, equipos, ownership, stack, despliegue, datos, dependencias, costos y comandos reales. No asumir arquitectura.
 3. Leer objetivos, recorridos críticos, restricciones, incidentes, SLO, seguridad, privacidad y decisiones previas.
 4. Inspeccionar código, contratos, esquemas, diagramas y límites observables antes de proponer abstracciones o tecnologías.

package/agents/roles/system/software-architect/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   reject_unsourced_claims: true
   automatic_apply: false
 
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/software-architect.md dentro de cada instalación.
 sources:
-  - name: Project code architecture decisions telemetry and organization
-    url: local://architecture-context
-    tier: project-primary
-    topics: [systems, boundaries, ownership, constraints, decisions]
   - name: ISO IEC IEEE 42010
     url: https://www.iso.org/standard/74393.html
     tier: primary-standard

package/agents/roles/system/solutions-engineer/SKILL.md

@@ -10,6 +10,8 @@ Convertir necesidades y restricciones reales en una solución técnicamente viab
 ## Construir contexto
 
 1. Leer `AGENTS.md`, `ops.config.json`, `organization/`, documentación aprobada del producto y políticas de seguridad, privacidad y datos.
+   Leer también `organization/roles/solutions-engineer.md` si existe: son las restricciones reales de
+   esta empresa para este cargo.
 2. Identificar outcome, usuarios, proceso actual, sistemas, integraciones, volúmenes, latencia, disponibilidad, identidad, datos, regiones, operación, presupuesto y fecha objetivo.
 3. Confirmar versión, entorno y fuente de cada capacidad; clasificarla como disponible, limitada, validación pendiente, roadmap autorizado o no soportada.
 4. Mapear stakeholders, owner de cada decisión y autoridad de Product, Engineering, Security, Privacy, Legal, Sales e Implementation.

package/agents/roles/system/solutions-engineer/learning/sources.yaml

@@ -6,11 +6,9 @@ rules:
   require_corroboration_for_major_change: true
   reject_unsourced_claims: true
   automatic_apply: false
+# El contexto de la empresa no es una fuente de la profesión: vive en
+# organization/roles/solutions-engineer.md dentro de cada instalación.
 sources:
-  - name: Company product architecture security legal and customer context
-    url: local://solutions-engineering-context
-    tier: company-primary
-    topics: [product, architecture, security, legal, customers, evidence]
   - name: ISO IEC IEEE 42010 architecture description
     url: https://www.iso.org/standard/74393.html
     tier: standards-primary