docs(ms-ai-architect): fler-sesjons-roadmap etter Fase 0-gaten (S1-S4 kritisk sti + side-spor + Cosmo-resolusjon) [skip-docs]
Kritisk sti: S1 type-tag -> S2 backfill+frontmatter -> S3 judge+bake-off -> S4 integrasjon. Side-spor: SH (TOC, 1c foer 1b), S-Cosmo (sist, absorberer advisor-strukturarbeid), S-OKF. Hver sesjon har kjoerbar gate. Cosmo-kollisjon loest: bake-off bruker frosset gull-sett (uavhengig av frontmatter); advisor produksjons-frontmatter folder inn i S-Cosmo. Gating-valg 1 (maal-foerst vs bygg-begge) loest av gaten.
This commit is contained in:
parent
49fd18c6d2
commit
54b203eae7
1 changed files with 37 additions and 3 deletions
|
|
@ -126,12 +126,46 @@ Lav risiko, forbedrer workflowen uansett senere valg. **NB: koordiner advisor-fi
|
|||
- **Versjonsbump for `83fd9b5`?** Ref-fil-innhold er user-facing flate, men dette er label-ærlighet (ikke kapabilitet). Anbefaling: ingen bump nå; batch release med neste substansielle endring (Fase 0-utfall / Cosmo). Operatør avgjør.
|
||||
|
||||
## Gating-valg for operatør (avklares før relevante faser)
|
||||
1. **Mål-først (anbefalt) vs bygg-begge-direkte.** Begge krever gull-settet (Fase 0) først.
|
||||
1. **Mål-først (anbefalt) vs bygg-begge-direkte.** ✅ LØST av Fase 0-gaten: bygg-begge-og-mål på volatil populasjon i **S3** (se roadmap under). Begge krevde gull-settet — nå levert (373 påstander, frosset).
|
||||
2. **Cosmo-sekvensering.** Struktur-/tag-arbeid på `ms-ai-advisor` (lavest score 91 + hjem til `adr-template`) kolliderer med godkjent Cosmo-utfasing (samme skill). Vente til Cosmo er ute, eller koordinere? Påvirker Fase 1b/1c/2 for advisor-filer.
|
||||
3. **N4-revekting.** Håndheve TOC-regelen reelt (re-vekt N4 / skaler med filstørrelse)? Drar 91–96 midlertidig under 90 → Spor D-alarm. Policy, ikke defekt.
|
||||
|
||||
## Premiss reconciled (AVKLART 2026-06-26)
|
||||
«Navngitt 169 / mappe 220» (audit) vs «151 navngitt / 238 mappe-only» (workflow akse 1). **Løst:** `ref-file-audit.py` kjørt på nytt gir reproduserbart **169 / 220 / 0 orphans** — autoritativt (transparent heuristikk: `basename ∈ SKILL.md + agents/*.md`). 151/238 var et ikke-reproduserbart engangs-agentanslag med strammere «named»-definisjon; forkastet. Begge summerer 389 og er enige om **0 orphans** — avviket er kun named/folder-grensen og er **immaterielt**: intet tiltak (Fase 0–3) kjører på den grensen, kun «0 død vekt» (begge bekrefter).
|
||||
|
||||
## Anbefalt inngangspunkt (neste sesjon)
|
||||
**Fase 0 (gull-testsett + base-rate)** er den tunge, retnings-avgjørende jobben og bør gjøres uthvilt — den avgjør om Fase 3 i det hele tatt skal bygges. **Fase 1a (registry-herding) + 1b/1c (TOC + generator)** er trygt håndverk som kan gjøres uavhengig. Velg: start med Fase 0 (avgjør retning), eller ta Fase 1 trygge grep først. Begge tjener kjernen.
|
||||
## Fler-sesjons-eksekveringsplan (roadmap — etablert 2026-06-26, etter Fase 0-gaten)
|
||||
|
||||
Fase 0 ✅ lukket; gaten sa **BYGG Fase 3 (scoped)**. Gjenstående arbeid har **én kritisk sti** (Fase 2 → Fase 3-forutsetninger → judge/bake-off → Fase 4) + **to uavhengige side-spor** (TOC-håndverk, Cosmo) + **ett lav-prio** (OKF). Hver sesjon har en **kjørbar gate** (autonomi-vennlig — gå ikke videre før kriteriet er grønt). Premiss-tall (389/306/83) er recon-funn over; eksekverende sesjon **re-verifiserer mot ground truth FØR den muterer** (premiss-verifiseringsplikt).
|
||||
|
||||
**Dependensgraf (kort):**
|
||||
- `1c → 1b` (ellers reverserer generatoren TOC-arbeidet ved neste KB-update).
|
||||
- Fase 2 type-tag `→` full frontmatter `→` produksjons-judge.
|
||||
- **Bake-off bruker det FROSNE gull-settet (373)** ⇒ ikke blokkert av frontmatter-arbeidet.
|
||||
- Fase 3-mekanisme `→` Fase 4.
|
||||
- Cosmo berører `ms-ai-advisor` ⇒ kolliderer med strukturarbeid på advisor-filer (løses ved scoping, se beslutning 2).
|
||||
|
||||
### Kritisk sti
|
||||
|
||||
**S1 — Fase 2: minimal type-tag.** Klassifiser alle ~389 filer `reference|template|methodology|regulatory` (sidecar-manifest el. mappekonvensjon — IKKE full YAML ennå). Skiller de ~83 kildeløse legitimt (mal/metodikk: `decision-trees`, `cost-models`) fra MS-fakta-uten-kilde (maskin-detekterbart defekt). NY `scripts/kb-eval/classify-ref-type.mjs` (TDD-først). **Scope:** klassifiser advisor-filer, men MUTÉR dem ikke (Cosmo-kollisjon). **Gate (kjørbar):** hver fil har én type; de kildeløse delt i to bøtter; reproduserbar (samme input → samme output); suite grønn.
|
||||
|
||||
**S2 — Fase 3-forutsetning (a)+(b): autoritets-backfill + full frontmatter.** Gi hver verifiserbar fil (~306 som siterer ≥1 MS Learn-URL, **EKSKL. advisor**) en `authority_source` + bygg full frontmatter (`type/source/verified`, OKF-form). Advisor-filenes frontmatter/backfill folder inn i **S-Cosmo** (unngår dobbeltarbeid). **Gate:** hver ikke-advisor verifiserbar fil har `authority_source`; frontmatter validerer; suite grønn.
|
||||
|
||||
**S3 — Fase 3-kjerne: judge-bygg + «bygg begge og mål».** Per-fil groundedness-judge (Opus 4.8 xhigh), scoped til fetchbare claim_types (`taxonomy/status/version/tpm/sku/region`; `price` → flagg «ikke maskinverifiserbar», operatør-gated). Mål **staleness vs judge vs hybrid** på det frosne gull-settet (volatil populasjon — der feilene bor; ikke kår vinner på stabile påstander). **Gate:** judge presisjon/recall mot gull ≥ avtalt terskel; bake-off-tabell kårer mekanisme; kjent felle adressert (invertert leverage — judgen «vinner» ikke ved å auto-score stabile lav-risiko-påstander). Kostnad: ~2700 ikke-batchbare `microsoft_docs_fetch`/full-pass (ikke «$20–40 Batch»). **Beslutning:** velg mekanisme.
|
||||
|
||||
**S4 — Fase 4: integrasjon & styring.** Fold valgt mekanisme inn i KB-refresh-kadens (IKKE SessionStart — for dyrt). Rapporterende gulv (Spor D peker, ikke hard gate, før kalibrert). CT5 (sourcedness) **ERSTATTER** K8s rolle. **Gate:** SessionStart surfacer innholds-signal uten falske regresjons-alarmer; operatør-waiver-sti finnes.
|
||||
|
||||
### Side-spor (uavhengig — interleaves når kritisk sti venter)
|
||||
|
||||
**SH — Fase 1b/1c: TOC + generator-guard.** Trygt håndverk. **1c FØR 1b** (ellers reverserer neste KB-update headerne — write-path-regresjon). ~20–29 filer >800 linjer. Ekskluder advisor-filer (Cosmo). Avhenger av operatør-beslutning 3 (N4-revekting). **Gate:** `eval.mjs checkN4 hasToc=true` på målfilene; generator føder TOC + kanonisk header; ingen diff-churn på små filer.
|
||||
|
||||
**S-Cosmo — Cosmo-utfasing (GODKJENT, gjøres SIST).** Fjern persona helt. Absorbér i samme pass: 1a-C (44+3 redirects), advisor-filenes frontmatter/backfill (fra S2) + TOC (fra SH). LES `docs/cosmo-removal-brief-2026-06.md`. Aldri ny Cosmo-innhold. **Gate:** 0 Cosmo-referanser igjen; advisor judged etter Cosmo.
|
||||
|
||||
**S-OKF — OKF auto-inbox-pipeline (LAV PRIO).** Skjul OKF fra bruker. `docs/okf-second-brain-brief-2026-06.md`.
|
||||
|
||||
### Operatør-beslutninger låst inn av denne planen
|
||||
1. **Mål-først vs bygg-begge** → ✅ LØST av gaten: bygg-begge-og-mål på volatil populasjon (S3).
|
||||
2. **Cosmo-sekvensering** → **ANBEFALT resolusjon:** advisor-strukturarbeid folder inn i S-Cosmo; Fase 3-bake-off bruker frosset gull-sett (uavhengig av advisor-frontmatter); produksjons-judge dekker 4 skills først, advisor post-Cosmo. Respekterer «Cosmo sist» UTEN å blokkere kritisk sti.
|
||||
3. **N4-revekting** → avgjøres ved SH (policy, ikke defekt; TOC-håndheving drar 91–96 midlertidig < 90 → Spor D-alarm).
|
||||
4. **Versjonsbump `83fd9b5`** → batch med S3- eller S-Cosmo-release.
|
||||
|
||||
**Anbefalt neste sesjon: S1** (Fase 2 type-tag — ren, testbar, retnings-uavhengig start på kritisk sti). Trygt alternativ hvis ønskelig: SH (TOC), men avklar beslutning 3 først.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue