refactor(ms-ai-architect): R13 del 1 — nøytraliser Cosmo-personaen i ref-korpusets headinger, etter å ha rettet en gate som var målt usann to ganger

Ordre 20260912T193441Z-7358817909. Steg 1 var ikke transformen, men å rette
roadmapens R13-gate og få den ratifisert. Gaten `grep -rl "Cosmo"
skills/*/references -> 0` var usann på to uavhengige måter:

1. Ordren fanget den første: 451 av forekomstene er Azure Cosmos DB, ekte
   produktinnhold. Diskriminatoren er ikke bokstaven «s» — `Cosmos <norsk
   substantiv>` er genitiv av personaen (`### Cosmos tonalitet`), mens
   `Cosmos DB`/`CosmosClient`/`cosmos_ru` er produkt.
2. Denne økten fant den andre: 132 persona-forekomster ligger i prosa,
   tabeller, dialog-replikker og proveniens-linjer. Heading-nøytralisering
   kan ikke nå dem, så «0 persona» er uoppnåelig også under den ratifiserte
   formen. Operatøren ratifiserte alternativ A: gaten speiler formen, og de
   132 bokføres til R13b/R14.

Tre korreksjoner av premisser som sto i ordren og STATE:
  «ca 320 produkt»   -> 451 (case-sensitivt nett manglet 327 lowercase
                        TOC-ankre + 99 identifikatorer; sann nevner 1 638)
  «169 headinger»    -> 401. 169 var `^## For Cosmo`-prefikset (168) og var
                        internt inkonsistent med sin egen topp-variant (204)
  «417 matcher ingen
   populasjon»       -> 417 er cosmo-headinger utenfor kodefences; briefens
                        nevner var reell hele tiden

Fence-bevissthet er målt skadelig, ikke nødvendig: begge toggle-regler er
gale på dette korpuset (naiv toggle skjuler en ekte heading i
chain-of-thought-prompting.md, CommonMark-regelen ubalanserer
service-level-documentation-dr.md). Fence-agnostisk deteksjon finner 401
heading-linjer i nøyaktig de samme 40 variantene som fence-bevisst finner
400 i — ingen kodeblokk-linje er byte-identisk til en persona-heading. Derfor
nøkles transformen på 40 enumererte heading-tekster og ignorerer fences. En
ukjent variant kaster; en slug-kollisjon kaster. Ingenting auto-fikses.

TOC-en regenereres ikke, den rettes kirurgisk: alle 327 persona-lenker hadde
lenketekst lik én av de 40 heading-tekstene og anker lik slugify av den
(327/327, 0 avvik), så heading og TOC-entry skrives i samme operasjon og
ingen mellomtilstand etterlater en død lenke.

Ratifisert målform: `For Cosmo`, `For Cosmo Skyberg` og `For arkitekten
(Cosmo)` konvergerer på `For arkitekten`. To filer kolliderte og er adjudisert
ved å lese dem, ikke ved regel.

Verifisering (alle 7 kriterier fra ordren):
  G1 persona på heading-linjer   401 -> 0
  G2 døde fragmentlenker         1 -> 1 (pre-eksisterende, unntatt)
  G3 produkt-forekomster         451 -> 451; `Cosmos DB|Azure Cosmos` 308 = 308
  de 3 kun-produkt-filene        byte-identiske
  nettet validert begge veier    injisert persona feller G1; genitiv feller G1;
                                 produkt-heading og de 3 filene passerer
  hele diffen                    802 heading-linjer + 654 TOC-linjer, ANNET = 0
  linjeantall                    728 lagt til = 728 slettet
  suite                          1120/1120 (1097 + 23 nye)
  validate-plugin                250 PASS / 0 FAIL
  stikkprøve                     10 filer, alle 5 skills, inkl. de 3 mest
                                 produkt-tunge (26/20/19) — kun heading+TOC

Utenfor scope, urørt: de 4 SKILL.md, de 23 commands, CLAUDE.md, README.md,
NOTICE.md, docs/ (alt R14).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-09-12 22:12:28 +02:00
commit 3a73eeafdc
380 changed files with 1711 additions and 729 deletions

View file

@ -17,7 +17,7 @@
- [Hybrid Cloud Fallback Mechanisms](#hybrid-cloud-fallback-mechanisms)
- [Data Residency and Sovereignty Compliance](#data-residency-and-sovereignty-compliance)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -535,7 +535,7 @@ assert capacity_region == "norwayeast", \
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder har data i flere skyplattformer og trenger a integrere dem for AI-formaal uten a kopiere alt til Azure.
- **OneLake shortcuts er primaerstrategien** for krysssky-dataintegrasjon. De unngaar dataduplisering, reduserer egress-kostnader med caching, og er enklere a vedlikeholde enn ETL-pipelines.

View file

@ -17,7 +17,7 @@
- [Right-to-Be-Forgotten Implementation](#right-to-be-forgotten-implementation)
- [Privacy Impact Assessments](#privacy-impact-assessments)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -571,7 +571,7 @@ def privacy_check_before_deployment(model_artifacts_path: str) -> dict:
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder behandler personopplysninger i AI-systemer og trenger anonymiserings- og personvernstrategier.
- **Azure Language PII-deteksjon er forstevalget** for a identifisere og maskere personopplysninger i tekst -- bade for treningsdata og RAG-dokumenter. Stotter norsk sprak.

View file

@ -17,7 +17,7 @@
- [Data Owner and Steward Assignments](#data-owner-and-steward-assignments)
- [Usage Analytics and Popularity Metrics](#usage-analytics-and-popularity-metrics)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -787,7 +787,7 @@ def calculate_discovery_metrics(purview_endpoint, token, domain_id):
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren trenger hjelp med å sette opp datakatalogisering, organisere data for AI-prosjekter, eller etablere informasjonsforvaltning med Purview Unified Catalog.
- For norsk offentlig sektor: **Governance Domains** mapper naturlig til avdelinger/seksjoner i etaten. Anbefal å opprette domener som speiler organisasjonsstrukturen (f.eks. "AI og Maskinlæring", "Veiforvaltning", "Trafikkstyring").

View file

@ -17,7 +17,7 @@
- [Integrasjon med Microsoft-stakken](#integrasjon-med-microsoft-stakken)
- [Offentlig sektor (Norge)](#offentlig-sektor-norge)
- [Kostnad og lisensiering](#kostnad-og-lisensiering)
- [For arkitekten (Cosmo)](#for-arkitekten-cosmo)
- [For arkitekten](#for-arkitekten)
- [Kilder og verifisering](#kilder-og-verifisering)
## Introduksjon
@ -459,7 +459,7 @@ Scenario: Daglig batch inference (1M records, 50 GB data, 30 dager)
---
## For arkitekten (Cosmo)
## For arkitekten
### Systemkarakteristikk

View file

@ -18,7 +18,7 @@
- [Scaling to 50+ Domains with OneLake](#scaling-to-50-domains-with-onelake)
- [Anti-patterns og fallgruver](#anti-patterns-og-fallgruver)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -430,7 +430,7 @@ def get_domain_health_metrics():
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder planlegger data mesh-arkitektur i Fabric, spesielt naar de har flere avdelinger/team som trenger a dele data for AI-formaal.
- **Start med domener i Fabric** som den primaere mekanismen -- ikke overkompliser med ekstern tooling. Fabric har innebygd stotte for domener, foderert governance og cross-domain shortcuts.

View file

@ -18,7 +18,7 @@
- [SLAs and Timeliness Guarantees](#slas-and-timeliness-guarantees)
- [Apache Airflow i Fabric](#apache-airflow-i-fabric)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -616,7 +616,7 @@ with DAG(
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder planlegger datapipeline-arkitektur for AI-arbeidsbelastninger, inkludert scheduling, avhengighetsstyring og feilhindtering.
- **Fabric Data Factory er forstevalget** for organisasjoner pa Fabric-plattformen. Azure Data Factory (klassisk) anbefales kun naar det trengs hybrid-stotte eller Self-Hosted IR.

View file

@ -17,7 +17,7 @@
- [Integrasjon med Microsoft-stakken](#integrasjon-med-microsoft-stakken)
- [Offentlig sektor (Norge)](#offentlig-sektor-norge)
- [Kostnad og lisensiering](#kostnad-og-lisensiering)
- [For arkitekten (Cosmo)](#for-arkitekten-cosmo)
- [For arkitekten](#for-arkitekten)
- [Kilder og verifisering](#kilder-og-verifisering)
## Introduksjon
@ -468,7 +468,7 @@ def trigger_purview_profiling(data_asset_id, connection_id):
---
## For arkitekten (Cosmo)
## For arkitekten
### Key takeaways

View file

@ -17,7 +17,7 @@
- [Quality Control and Inter-Rater Agreement](#quality-control-and-inter-rater-agreement)
- [Feedback Loops for Continuous Labeling](#feedback-loops-for-continuous-labeling)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -517,7 +517,7 @@ def detect_label_drift(historical_labels_df, recent_labels_df, columns):
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder planlegger datamerkings-prosjekter for ML-modeller, eller naar de trenger strategier for a hondtere ubalanserte datasett.
- **Azure ML Data Labeling er forstevalget** for merkingsprosjekter i Microsoft-stakken. ML-assistert merking kan redusere manuelt arbeid med 50-80% etter initiell opplaering.

View file

@ -19,7 +19,7 @@
- [Upstream/Downstream Dependency Mapping](#upstreamdownstream-dependency-mapping)
- [Rollback and Recovery Strategies](#rollback-and-recovery-strategies)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -453,7 +453,7 @@ display(changes.select("customer_id", "_change_type", "_commit_version", "_commi
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren trenger reproduserbarhet for ML-modeller, audit trail for AI-beslutninger, eller impact-analyse for dataendringer.
- For norsk offentlig sektor: **Versjonskontroll er ikke valgfritt** for AI-systemer som påvirker borgere. EU AI Act krever sporbarhet for høyrisiko-systemer, og Utredningsinstruksen krever dokumentasjon av beslutningsgrunnlag.

View file

@ -17,7 +17,7 @@
- [Power Platform Data Integration](#power-platform-data-integration)
- [RLS Propagation from Dataverse to Fabric](#rls-propagation-from-dataverse-to-fabric)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -373,7 +373,7 @@ CONTAINS(
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar brukeren har Dynamics 365, Power Apps, eller Power Platform-data som skal brukes i AI-losninger, eller naar de trenger a skrive AI-prediksjoner tilbake til forretningsapplikasjoner.
- Anbefal **Link to Fabric** som forstevalg for enkel integrasjon -- ingen ETL, ingen ekstra infrastruktur, data forblir i Dataverse med shortcuts.

View file

@ -18,7 +18,7 @@
- [Small File Handling and Garbage Collection](#small-file-handling-and-garbage-collection)
- [Best Practices for AI-arbeidsbelastninger](#best-practices-for-ai-arbeidsbelastninger)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -400,7 +400,7 @@ history.select("version", "timestamp", "operation", "operationMetrics").show(tru
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder spor om ytelsesoptimalisering av Delta Lake-tabeller, Parquet-filformat, eller filvedlikehold i Fabric Lakehouse.
- **V-Order er det forste du bor anbefale** for lesekrevende arbeidsbelastninger som Power BI-rapporter, Direct Lake-modeller og AI-inferens. For skrivekrevende pipelines (ETL/streaming), behold standard deaktivert V-Order.

View file

@ -17,7 +17,7 @@
- [Data Staging and Incremental Processing](#data-staging-and-incremental-processing)
- [Compute Cost Allocation: ETL vs ELT](#compute-cost-allocation-etl-vs-elt)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -411,7 +411,7 @@ spark.conf.set("spark.microsoft.delta.optimizeWrite.enabled", "true")
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren evaluerer dataintegrerings-strategier for AI, vurderer kostnader og ytelse, eller trenger å håndtere sensitive data i pipelines.
- For norsk offentlig sektor: Anbefal **hybrid ETL/ELT** som standard -- ETL for kilder med personopplysninger (Dataflow Gen2 med PII-filtrering), ELT for alle andre kilder (Copy Job + Spark).

View file

@ -17,7 +17,7 @@
- [Integrasjon med Microsoft-stakken](#integrasjon-med-microsoft-stakken)
- [Offentlig sektor (Norge)](#offentlig-sektor-norge)
- [Kostnad og lisensiering](#kostnad-og-lisensiering)
- [For arkitekten (Cosmo)](#for-arkitekten-cosmo)
- [For arkitekten](#for-arkitekten)
- [Kilder og verifisering](#kilder-og-verifisering)
## Introduksjon
@ -272,7 +272,7 @@ Bruk **Fabric Capacity Metrics App** for:
- Track bursting/smoothing events
- Set up proactive alerts (via Power Automate)
## For arkitekten (Cosmo)
## For arkitekten
### Spørsmål å stille kunden

View file

@ -17,7 +17,7 @@
- [Data Wrangler for Exploratory Feature Engineering](#data-wrangler-for-exploratory-feature-engineering)
- [Feature Monitoring and Drift Detection](#feature-monitoring-and-drift-detection)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -450,7 +450,7 @@ def calculate_psi(reference, current, buckets=10):
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren planlegger ML-infrastruktur, trenger feature-gjenbruk på tvers av prosjekter, eller ønsker å operasjonalisere feature engineering.
- Anbefal **Azure ML Managed Feature Store** for organisasjoner med flere ML-team som trenger å dele features. For enkeltprosjekter er **Delta-tabeller i Silver layer** ofte tilstrekkelig.

View file

@ -18,7 +18,7 @@
- [Lakehouse Performance Tuning](#lakehouse-performance-tuning)
- [Medallion Architecture Deployment](#medallion-architecture-deployment)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -403,7 +403,7 @@ Lakehouse (Bronze + Silver) Data Warehouse (Gold)
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren planlegger en ny dataarkitektur på Fabric, vurderer lakehouse vs warehouse, eller trenger mønstre for SCD, MERGE og Delta Lake-optimalisering for AI-treningsdata.
- Anbefal **medallion architecture** (bronze/silver/gold) som standard for alle AI-prosjekter. Bronze for rådata, Silver for validert/denormalisert data, Gold for ML-features og aggregater.

View file

@ -17,7 +17,7 @@
- [Reference Data Versioning](#reference-data-versioning)
- [Data Quality SLAs for MDM Entities](#data-quality-slas-for-mdm-entities)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -531,7 +531,7 @@ def alert_on_sla_breach(results: dict, webhook_url: str):
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder trenger a sikre datakvalitet i stamdata for bruk i AI/ML-modeller, eller naar de planlegger MDM-strategi for Microsoft-plattformen.
- **Dataverse er det naturlige valget** for operativ MDM i organisasjoner som allerede bruker Dynamics 365 eller Power Platform. For analytisk MDM, bruk Fabric Lakehouse med SCD Type 2.

View file

@ -18,7 +18,7 @@
- [GDPR/HIPAA Compliance Auditing](#gdprhipaa-compliance-auditing)
- [Purview Governance for Fabric Copilots og Agenter *(Verified MCP 2026-04)*](#purview-governance-for-fabric-copilots-og-agenter-verified-mcp-2026-04)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -372,7 +372,7 @@ Microsoft Purview gir nå governance-dekning for Fabric Copilots og agenter —
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren trenger datahersking for AI-prosjekter, compliance-støtte (GDPR, HIPAA), eller oversikt over datasensitivitet i treningsdata.
- For norsk offentlig sektor: Purview er kritisk for å oppfylle **Forvaltningslovens** krav til dokumentasjon og **Personopplysningslovens** krav til behandlingsprotokoll. Anbefal alltid Purview som del av AI-arkitekturen.

View file

@ -17,7 +17,7 @@
- [Integrasjon med Microsoft-stakken](#integrasjon-med-microsoft-stakken)
- [Offentlig sektor (Norge)](#offentlig-sektor-norge)
- [Kostnad og lisensiering](#kostnad-og-lisensiering)
- [For arkitekten (Cosmo)](#for-arkitekten-cosmo)
- [For arkitekten](#for-arkitekten)
- [Kilder og verifisering](#kilder-og-verifisering)
## Introduksjon
@ -597,7 +597,7 @@ OneLake security RBAC er en **native Fabric-funksjon** som bør foretrekkes over
---
## For arkitekten (Cosmo)
## For arkitekten
### Når skal du anbefale shortcuts?
@ -660,7 +660,7 @@ START: "Trenger vi unified data access?"
---
### Shortcut Design Patterns (Cosmo's Checklist)
### Shortcut Design Patterns
#### Pattern 1: Federated Data Mesh
**Scenario:** 5 domains (HR, Finance, Marketing, Sales, Operations) — hver har egen Lakehouse.

View file

@ -20,7 +20,7 @@
- [Streaming SLAs and Backpressure Handling](#streaming-slas-and-backpressure-handling)
- [Arkitekturmonstre for AI med sanntidsdata](#arkitekturmonstre-for-ai-med-sanntidsdata)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -401,7 +401,7 @@ Event Source ──> Eventstream ──> Spark Structured Streaming
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren trenger sanntidsdatabehandling for AI-modeller, IoT-integrasjon, eller hendelsesdrevet arkitektur på Microsoft Fabric.
- Anbefal **Eventstream + KQL Database** for tidsserieanalyse og anomalideteksjon med sub-sekund latens, og **Eventstream + Lakehouse** for historisk ML-trening.

View file

@ -17,7 +17,7 @@
- [Deprecated Column Handling](#deprecated-column-handling)
- [Schema Registration and Validation](#schema-registration-and-validation)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -483,7 +483,7 @@ class SchemaVersionManager:
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** naar kunder haandterer skjemaendringer i Delta Lake-tabeller, eller naar de trenger strategier for skjemaversjonering i ML-pipelines.
- **Schema enforcement + evolution er komplementaere**: Enforcement hindrer daarlig data, evolution lar skjemaet vokse. Aktiver begge for AI-datatabeller.

View file

@ -17,7 +17,7 @@
- [Privacy-Preserving Synthetic Data](#privacy-preserving-synthetic-data)
- [Validation of Synthetic Data Quality](#validation-of-synthetic-data-quality)
- [Referanser](#referanser)
- [For Cosmo](#for-cosmo)
- [For arkitekten](#for-arkitekten)
## Introduksjon
@ -429,7 +429,7 @@ for metric, result in validation.items():
---
## For Cosmo
## For arkitekten
- **Bruk denne referansen** når brukeren har begrensede treningsdata, klasseimbalanser, eller personvernkrav som hindrer bruk av reelle data for AI-trening.
- For norsk offentlig sektor: Syntetisk data er ofte **den eneste lovlige veien** til å bygge ML-modeller med sensitive data (helse, NAV, politi). Fremhev at syntetiske data aldri inneholder reelle personopplysninger.

View file

@ -17,13 +17,13 @@
- [Integrasjon med Microsoft-stakken](#integrasjon-med-microsoft-stakken)
- [Offentlig sektor (Norge)](#offentlig-sektor-norge)
- [Kostnad og Lisensiering](#kostnad-og-lisensiering)
- [For arkitekten (Cosmo)](#for-arkitekten-cosmo)
- [For arkitekten](#for-arkitekten)
- [Tekniske Detaljer](#tekniske-detaljer)
- [Praktisk Eksempel: End-to-End Setup](#praktisk-eksempel-end-to-end-setup)
- [Vanlige Feil og Løsninger](#vanlige-feil-og-løsninger)
- [Fremtidige Utvidelser (Roadmap)](#fremtidige-utvidelser-roadmap)
- [Kilder og Verifisering](#kilder-og-verifisering)
- [Oppsummering for Cosmo](#oppsummering-for-cosmo)
- [Oppsummering](#oppsummering)
## Introduksjon
@ -447,7 +447,7 @@ Mirroring har **særegne kostnadsfortrinn** for offentlige virksomheter:
---
## For arkitekten (Cosmo)
## For arkitekten
### Key Decision Points
@ -635,7 +635,7 @@ ALTER TABLE orders OWNER TO fabric_user; -- fabric_user must own tables
---
## Oppsummering for Cosmo
## Oppsummering
**Zero-ETL med Fabric Mirroring er riktig valg når:**
- Kilden er en støttet database (SQL, Cosmos, Snowflake, PostgreSQL)