boc/projects/landvex/00-styrning/AGENTARME.md

# AGENTARMÉ — implementeringsorder v1
## Landvex produktionspaket · 58 agenter · 11 skvadroner · 4 faser

Detta dokument är arbetsordern. Paketets filer är enda sanningskällan. Ingenting implementeras som inte går att spåra hit.

⸻

## Hårda regler — gäller varje agent, utan undantag

1. **Enda sanningskälla:** `10-data/` + `lvx-objekt-schema.json`. Ingen agent uppfinner fakta, fält, klasser, standarder eller ID:n.
2. **Aldrig mock i kundnära väg.** Saknad förmåga levereras som ärligt svar med konfidens + automatisk bounty (mönstret i `30-produkt/lvx-api-demosvar.json`, case 3) — aldrig som låtsad träff, aldrig som stubbe i miljö en kund kan nå.
3. **PLATSHÅLLARE serialiseras aldrig** ut ur något publikt gränssnitt. Filtret sitter i serialiseringskoden och testas.
4. **Källa på varje påstående.** Publika svar bär `verifieringsniva`, `konfidens` och `kallor[]` — obligatoriska fält enligt API-kontraktet.
5. **Standarder refereras** med organ + beteckning + roll. Standardtext återges aldrig (juridikregeln).
6. **ID:n mintas endast** via registertjänsten (`lvx-id-register.json`-logiken i `ingest.py`). ID:n återanvänds aldrig, av ingen.
7. **Verifieringstrappan är enkelriktad:** obekräftad → källbelagd (kräver källor) → fältverifierad (endast fotoflödet) → tillverkarbekräftad (endast portalflödet). Ingen kod får sätta nivå utanför sitt flöde.
8. **Grind före merge/deploy:** `00-styrning/verifiera.py` grönt + checksummor mot `MANIFEST.json`. Rött stoppar allt.
9. **Ontologi-/schemaändring** endast via Ändringsrådet (skvadron A) med versionslyft och migrering.
10. **Osäkerhet uttrycks, döljs aldrig.** Konfidens är produktyta, inte intern metadata.

⸻

## Skvadroner (58 agenter)

**A · Programkontor & arkitektur (3)** — äger detta dokument, MANIFEST, gränssnittskontrakt och Ändringsrådet. Godkänner fasgrindar. *Input:* allt. *Output:* beslut, versionslyft.

**B · Plattform & SRE (6)** — Fas 0: dev/stage/prod, IaC, hemligheter, observabilitet, larm, backup/DR. Driftsätter samtliga tjänster. *DoD:* verifiera.py körs grönt i CI på varje miljö; återställningstest genomfört.

**C · Datakärna & graf (6)** — laddar `lvx-klassposter-master-v3.json` + modellfilerna till dokument-+graflager; grafen härleds alltid ur posterna (aldrig handredigerad); ID-registertjänst med atomär mintning. *DoD:* laddad databas reproducerar exakt grafstatistiken i `lvx-graf-kanter-v3.json` (176 kanter · 80 LVX · 82 standard).

**D · Ingest-automation (7)** — produktifierar `20-automation/ingest.py` till tjänst: tre köer (schemalagd / kunddriven / fält), skördare med källvitlista och referatregel, extraktor-API bakom `lvx-extraktionsprompt.md`, granskningskö-UI för konflikter, körningsrapporter. *DoD:* våg 7-batchen i `intag/` replayad genom tjänsten ger identiskt resultat (4 nivålyft, 1 mint, 0 fel).

**E · Object API (7)** — implementerar `30-produkt/lvx-pilot-api-spec.md` exakt: 6 endpoints, svarskontraktet, PLATSHÅLLARE-filter, feedback→bounty, nycklar, rate limits och **usage-mätning per identify för debitering** (SaaS-kärnan). *DoD:* kontraktstester gröna; de tre golden-casen reproduceras via API:t mot riktig data.

**F · Vision & identify (6)** — utvärderings- och träningsflöde från bountydata; identify-modell bakom API:t. Tills modellen når beslutad tröskel svarar identify med klasskandidat + ärlig konfidens — regel 2 i praktiken. *DoD:* golden-case-regressionssvit; konfidenskalibrering rapporterad.

**G · QUIXZOOM fältflöde (6)** — bounty-motorn (`lvx-zoomer-bounties-vag1.json` + auto-förslagen): poäng, först-på-individ ×2, dubblettkontroll hash+geo, hårdkodade säkerhets- och integritetsregler (auto-blurr, inga registreringsskyltar), foto→OCR→**fältverifierad**-lyft, LVX-I-individregister. *DoD:* ett komplett e2e-lyft källbelagd→fältverifierad i stage med riktigt foto.

**H · Tillverkarportal (4)** — flödet som sätter **tillverkarbekräftad**: claims kopplade till modellposter, spårbara godkännanden, aldrig standardtext. *DoD:* en modellpost lyft e2e i stage.

**I · Säkerhet, juridik & compliance (4)** — källpolicy (referat, aldrig kopiering), licensregister per källa, GDPR för positionsdata, åtkomstmodell, pentest. *DoD:* godkänd granskning av serialisering + datalager.

**J · QA & verifiering (5)** — äger och utökar `verifiera.py`; kontraktstester mot API-spec; datagrind 0 valideringsfel; golden-case-replay i CI; last- och kaostester. *DoD:* grindarna blockerar på riktigt (bevisat med avsiktligt rött bygge).

**K · Kund, pilot & SaaS-paketering (4)** — Pilot/Pro/Enterprise enligt API-specens paketering, mätarbaserad debitering på identify, onboarding, pilotworkshop med `40-strategi/landvex-pilotpitch.pptx`. *DoD:* första designpartner tecknad till pilotstart.

⸻

## Faser & grindar

**Fas 0 — Grund (B, C, J):** miljöer uppe, data laddad, verifiera.py grönt i CI.
→ *Grind 0:* checksummor + 0 valideringsfel + grafstatistik reproducerad.

**Fas 1 — Produkt (D, E, F, I):** ingest-tjänst och Object API live mot riktig data.
→ *Grind 1:* golden cases via API:t; våg 7-replay identisk; pentest av API-ytan.

**Fas 2 — Flyhjul (G, F):** fältflödet live; feedback→bounty→foto→fältverifierad sluter loopen.
→ *Grind 2:* första e2e-nivålyftet; kunddrivna kön mätbar.

**Fas 3 — Skala (H, K, D):** tillverkarportal, fler skördebatchar genom pipelinen, pilotkund onboardad.
→ *Grind 3:* tillverkarbekräftad e2e; kostnad per verifierat faktum rapporteras sjunkande.

Beroenden: C före D/E · E före F/G-exponering · G före H:s fältdata · J tvärs igenom alla faser.

⸻

## Eskalering

Datakonflikt → granskningskö (D) → Ändringsrådet (A). Schemabehov → A med versionslyft. Säkerhets-/juridikfynd → I stoppar berörd leverans omedelbart. Oklarhet om fakta → svaret är alltid: gå till källfilen; finns det inte där, finns det inte.