Plan före kod
Vi skriver ner mål, risker och användarvärde innan vi låter agentflöden implementera.
Caire bygger en AI-first vårdplattform, men vi gör det med senior produktdisciplin: från PRD till granskad PR, små verifierade ändringar, tydliga ägare och respekt för verklig hemtjänst.

Samma princip som finns i Caire Core gäller internt: continuous learning loop, tydliga beslut, spårbarhet och mänskligt ansvar före automatisering.
Vi skriver ner mål, risker och användarvärde innan vi låter agentflöden implementera.
AI kan producera mycket, men kod, design, innehåll och dataflöden granskas som produktarbete.
Tekniken bedöms utifrån hemtjänstens verkliga vardag: planerare, vårdgivare, klienter och anhöriga.
Vi föredrar användbara förbättringar som går att testa, mäta och förbättra över stora svårgranskade språng.
Leveransmandat
Produktägare skriver en PRD med ändring, framgångsmått och icke-mål. Specialiserade agenter hanterar därefter Spec, tester, implementation, granskning, verifiering, dossier och PR-flöde medan människor behåller produktansvaret.
Polstjärna
Vi mäter förlupen tid från PRD-intag till mergad PR, modellkostnad per levererad funktion och tokeneffektivitet. Poängen är inte att ersätta produktomdöme; den är att ta bort onödiga överlämningar i arbete som redan är specificerat.
Arbetsflöde
Varje steg producerar en kontrollerad artefakt. Nästa steg vägrar starta utan den, vilket gör pipelinen till ett enkelriktat kontrakt från produktavsikt till mergad ändring.
| # | Steg | Utdata | Ägare |
|---|---|---|---|
| 0 | Intag-normalisering | Kanonisk PRD-sökväg och funktionsslug | Orchestrator |
| 1 | PRD | Ändring, framgångsmått och icke-mål | Människa |
| 2 | Spec | Gherkin-acceptansscenarier | Architect-agent |
| 3 | Tester | Misslyckande Vitest- och Playwright-tester | Test-writer |
| 4 | Implementation | Kod i isolerad worktree | Editor |
| 5 | Granskning | P1/P2/P3-fynd eller ren rapport | Reviewer-agenter |
| 6 | Verifiering | Trace, skärmbild och sammanfattningsdossier | Verifier |
| 7 | PR | Pushad branch och extern granskning | GitHub-flöde |
Migrerat plattformskällmaterial
Varje arbetsflödeskoncept visas som en del av en operativ modell, så kandidater och partners kan förstå hur strategi, implementation, verifiering och granskning hänger ihop.
Jobbet är att förkorta vägen från produktavsikt till verifierad förändring utan att ta bort ansvar. Läs detta först: människor äger prioritering, kvalitet och beslut.
Arbetsflödet delar ansvar mellan Architect, Editor, Reviewer, Verifier och Orchestrator. Rollen väljer modell efter uppgift, kostnad, risk och sammanhang.
Darwin är en tunn intern Node-loop som håller ihop intag, arbetskö, status och bevis. Den ska vara enkel, observerbar och möjlig att byta ut i delar.
Kartan delar upp vad som används av PRD-till-PR-pipelinen, vad som är parkerat och vad som är den prioriterade byggkön.
Adapter-formen gör att arbetsflödet kan välja modell utan att låsa produktprocessen till en leverantör eller ett enda gränssnitt.
Spec betyder testbara acceptansscenarier, inte lösa önskemål. Gherkin och done contract gate minskar spec-drift mellan PRD, test och implementation.
Review-loopen pollar externa granskare, klassar allvarlighet och återinträder i editorn med en idempotent åtgärdslista.
Automatisering får bara skalas när bevis, kostnad och kvalitet håller. Annars ska den kunna stoppas eller rullas tillbaka.
Måttet funktioner per sekund per token används tillsammans med kostnad, kvalitet och affärssignaler för att se om flödet faktiskt förbättrar leveransen.
Varje leverans ska kunna lämna spår: trace.zip, screenshot.png, console.log, testutdrag och en kort sammanfattning av vad artefakten bevisar.
Produkten vi bygger och sättet vi bygger på delar samma filosofi: spåra vad som ändras, lär av utfall och låt människor vara ansvariga för viktiga beslut.
Fördjupning
Diagram 1
Diagram 2
Diagram 3
Arbetsflöde
CAIREs leveransmodell är en agentisk PRD-till-PR-pipeline. En människa skriver en produktbeskrivning; specialiserade AI-agenter hanterar spec, tester, implementation, granskning och verifiering; människan godkänner en skärmbild. Beräkningskapacitet är flaskhalsen — inte antalet anställda.
Från en mening till levererad mjukvara. Människan dyker upp på två platser endast — när PRD:n skrivs, och när dossier-skärmbilden godkänns.
Arbetsflöde
Det agentiska arbetsflödet är inte "AI-stöd för utvecklare". Det är leveransmodellen. Fyra åtaganden gör arbetsflödet distinkt.
Arbetsflöde
Produktägare skriver PRD. Pipelinen tar PRD:n därifrån — spec, tester, kod, granskning, dossier, merge — utan en människa mitt i något steg.
Arbetsflöde
Varje modellanrop går via en adapter. Routning är konfiguration, inte kod. När en bättre eller billigare modell kommer är rotationen en kvartalsöversyn — inte en refaktorering.
Arbetsflöde
Mätningar efter merge rampar en funktion 1% → 100%. Försämring slår tillbaka flaggan. Beslutet är mekaniskt — människor bestämmer inte "okej, rampa det här".
Arbetsflöde
Kassaflöde, intäkter och förbrukning är systemingångar. Orchestratorn vägrar starta en dyr körning om dagens budget är slut. Inget mänskligt "dra åt svångremmen".
Arbetsflöde
Varje arkitekturbeslut i pipelinen mäts mot en fråga: gör det att vi levererar fler funktioner per sekund, per dollar (och per token)? Mätvärdet är medvetet litet i absoluta tal. Det som spelar roll är banan.
Arbetsflöde
Klocktid från PRD-intag till mergad PR. Att pressa det här betyder att parallellisera steg, cacha specifikationer och ta bort mänskliga rundresor. Varje levererad funktion landar en rad i .compound-state/agent-service.db med sin förlupna tid.
Arbetsflöde
Total modellutgift över alla åtta steg, per mergad PR. Billigare leverantörer, mindre modeller för enklare routning, batch-API:er, prompt-cachning — varje hävstång pekar tillbaka hit. Orchestratorn vägrar körningar vars projicerade kostnad skulle överskrida dagens budget.
Arbetsflöde
Totala in- + ut-tokens i pipelinen, per mergad PR. Ju renare specifikation och ju snävare dossier-kontrakt, desto färre tokens bränner editorn på iteration. Tokens är en ledande indikator för kostnad.
Arbetsflöde
En optimerings-mathematician-agent läser genomflödesloggen varje vecka och föreslår routningsförändringar — annan modell per roll, annan batch-storlek, annan cachstrategi. CPO/CTO-agenten ratificerar. Spärrhaken rör sig bara åt ett håll.
Den här sidan rör sig själv med mätvärdet. Nya routningsvinster, nya agent-promptar, nya dossier-format — varje förbättring som puffar funktioner-per-sekund-per-dollar landar här som en uppdatering.
Arbetsflöde
Varje steg producerar en kontrollerad artefakt. Nästa steg vägrar starta utan den. Pipelinen är ett kontinuerligt flöde, inte en checklista — varje steg lämnar över ett typat resultat.
De två återinträdes-kanterna (P1 hittad → återinträd editor) är de enda looparna. Allt annat är ett enkelriktat kontrakt från PRD till mergad commit.
Kontraktet är skarpt: ingen dossier, ingen merge . Varje stegs utdata är en typad, persisterad artefakt som nästa steg läser — och som en människa, en revision eller en framtida agent kan spela upp.
Arbetsflöde
Det agentiska arbetsflödet får inte människor att försvinna — det gör dem strategiska. Varje roll har en eller två snäva platser att kliva in. Allt annat är mjukvara.
Arbetsflöde
Definierar vad + varför Skriver PRD:n i wiki/plans/ med ett framgångsmått och explicita icke-mål. Godkänner (eller avvisar) dossier-skärmbilden före merge. Sätter försämringströskeln som skala-eller-släck bevakar efter merge. 💻
Arbetsflöde
Granskar, skriver inte Läser den auto-genererade specifikationen för avvikelse från PRD:n. Motargumenterar P2-granskningskommentarer med motivering när agenten har fel. Underhåller agent-promptar och modelladaptern — kod om hur kod skrivs. 🛠️
Arbetsflöde
Äger infrastrukturen Driftar Darwin (orchestrator-runtime), launchd-jobsplatser, merge-kön. Bevakar genomflödesloggen: kostnad per mergad PR, funktioner per sekund per token. Godkänner modell-routningsrotationer från optimerings-mathematicianens veckoförslag. 🧪
Arbetsflöde
Skriver reglerna, inte fallen Kuraterar Gherkin-mönstren som Test-writer-agenten kompilerar från. Granskar dossier summary.json för hoppade scenarier eller tomma Playwright-trace. Äger "ingen dossier, ingen merge"-grinden — det enda orchestratorn inte kan hoppa över. 📈
Arbetsflöde
Bevakar hävstången Läser kostnad-per-mergad-PR sjunka månad för månad medan routningsmatrisen stramas åt. Spårar funktioner-per-sekund-per-token som hävstångsförhållandet som inte beror på rekrytering. Ratificerar kvartalsvisa modell-routningsbeslut; väljer inte modeller. 🔍
Arbetsflöde
Granskar spåret Inspekterar wiki/raw/dossiers/<funktion>/ på en mergad PR — full Playwright-trace, skärmbild, konsollogg. Läser PRD-frontmatter för att kartlägga en levererad funktion tillbaka till den ursprungliga beskrivningen. Verifierar leverantörsoberoende genom att läsa routningskonfigurationen — ingen leverantörsbindning att ärva.
Arbetsflöde
Pipelinen riktar in sig på stadig produktutveckling — det arbete som i ett traditionellt team fyller standups och sprintar. Större arkitektoniska drag får fortfarande en mänsklig-ledd plan.
Arbetsflöde
En ny banner, en ny sida, en formvariation. PRD namnger acceptansscenarierna; pipelinen skriver vitest- + Playwright-tester; Editor implementerar; Verifier fångar skärmbild-dossiern.
Arbetsflöde
PRD ramar in buggen som ett misslyckande scenario. Test-writer kompilerar det; Editor fixar; resolver-reviewer + perf-reviewer fångar N+1-försämringar innan PR:n öppnas.
Arbetsflöde
Genomflödesrad, KPI-kakel, dashboard-diagram. Spec namnger datakällan; tester verifierar formen; dossiern visar mätningen renderas med realistisk seed-data.
Arbetsflöde
Kvartalsvis: optimerings-mathematicianen föreslår en routningsändring baserat på kostnad, godkännandegrad, latens. CPO/CTO-agenten ratificerar. En config-redigering; adaptern hanterar resten.
Arbetsflöde
Granskningsomgång som agentic-workflow-granskningen själv: identifiera avvikelse, fixa dokumentet, kör yarn wiki:lint , leverera. Wiki-bara PR:er använder samma åtta steg med verifier i lättläge.
Arbetsflöde
Ny CSV-adapter, ny gate-leverantör, nytt externt flöde. PRD namnger kontraktet; tester täcker gränssnittet; dossier bevisar integrationen med riktiga fixtures och en inspelad trace.
Arbetsflöde
Autonoma loopar utan skyddsräcken är hur AI-projekt bränner budgetar och levererar försämringar. Varje steg av pipelinen är inhägnat. Editor-agenten sitter i centrum, omgiven av mekanismer som antingen kan sakta ner den, omdirigera den eller stoppa den helt.
Åtta oberoende skyddsräcken. Inget enskilt förebygger buggar ensam; tillsammans gör de autonom leverans säker nog att människans enda obligatoriska handling är att läsa en skärmbild.
Arbetsflöde
Editor kan inte leverera beteende som specifikationen inte namnger. Avvikelse mellan PRD och spec är i sig ett P2-fynd för verifier — och specifikationen är kort nog att rymmas i varje agents kontext, så avvikelse är alltid bevisbar.
Arbetsflöde
MAX_ITERATIONS = 8 på editorns inre loop, plus max 3 återinträdes-cykler från review eller Codex-feedback. Träffa taket och körningen visar fel till en människa — den mal aldrig vidare.
Arbetsflöde
Den valfria PIPELINE_BUDGET_ENFORCEMENT -flaggan (av i pilot, på när intäkter är verkliga) vägrar fler modellanrop när per-körning-kostnaden skulle överskrida taket. I pilot är människan enda PRD-producenten, så kostnaden är implicit begränsad.
Arbetsflöde
En grön CI-körning är nödvändig men inte tillräcklig. Dossiern — Playwright-trace, slutskärmbild, konsollogg, maskinläsbar sammanfattning — bevisar att funktionen faktiskt renderades. Granskare kan spela upp tracet; människan ser skärmbilden.
Arbetsflöde
Samma pipeline, tre sätt att gå in i den. Välj vägen som matchar stunden — en PRD i versionskontroll, ett formulär på Dashboard, ett meddelande på Telegram. Varje väg producerar samma dossier och samma merge-beslut.
Arbetsflöde
Skriv wiki/plans/<funktion>-ÅÅÅÅ-MM-DD.md , skapa en isolerad worktree med ./scripts/git/worktree-add.sh , och pipelinen körs mot den grenen. Reviewer-subagenter granskar diff:en, verifier fångar dossiern, merge-kön landar PR:n. Bäst för utvecklare som levererar i versionskontroll.
Arbetsflöde
Klistra in en PRD-sökväg, klicka start , se pipelinens framsteg på localhost:3010 . Dossier-visaren visar skärmbild, konsollogg och maskinläsbar sammanfattning inline. Godkänn / Avvisa är en knapp — ingen GitHub-rundresa krävs. Bäst för produktägare som vill ha ett UI, inte ett CLI.
Arbetsflöde
Posta en PRD-länk till interface-agent . Samma backend kör pipelinen; dossier-skärmbilden postas tillbaka till den ursprungliga tråden. Svara godkänn och den merger. Den lättaste möjliga vägen — ett notis och en bild. Bäst för grundaren som läser på en telefon mellan möten.
Arbetsflöde
Pipelinen bygger på tre öppna mönster och en disciplin. Inget här är skräddarsytt för skräddarsydhetens skull.
Arbetsflöde
En dyr resonemangsomgång producerar specifikationen; många billiga redigeringsomgångar implementerar mot den. ~1/14 av kostnaden för att köra varje anrop på resonemangsmodellen — kostnadsdrivaren är editorn, inte arkitekten.
Arbetsflöde
Klarspråk är för oprecis för att koordinera flera agenter. Acceptansscenarier i Gherkin är korta nog att rymmas i varje agents kontext, precisa nog att kompilera till misslyckande tester, och greppbara.
Arbetsflöde
En grön CI-körning är nödvändig men inte tillräcklig. Dossiern — trace, skärmbild, konsollogg, maskinläsbar sammanfattning — bevisar att funktionen faktiskt renderades, i en verklig webbläsare, i tillståndet specifikationen namngav.
Arbetsflöde
Externa review-bots (Codex, CodeRabbit) postar kommentarer efter varje push. Pipelinen pollar dem, behandlar P1/P2 som misslyckande tester, och återinträder editorn automatiskt. Disciplinen är obligatorisk.
Arbetsflöde
Arbetsflöde
Hur CAIRE komponerar AI-agenter till ett operativsystem för hemtjänstleverans.
Arbetsflöde
VRPTW, NP-svårighet och den hybrida människa-AI-optimeringsmodellen som driver schemaläggning.
Arbetsflöde
Hur CAIRE hanterar AI-reglering, granskningsspår och ansvarsfull driftsättning i sjukvård.
Arbetsflöde
Tolv guider beskriver varje steg i detalj — vision och mandat, agentroller, dossier-mönstret, granskningsåterkopplingen och orkestreraren som binder ihop allt.
| # | Steg | Utdata | Drivs av |
|---|---|---|---|
| 0 | Intag-normalisering Konvertera chatt, brief eller Cursor-plan till en portabel PRD. | Kanonisk PRD-sökväg + funktionsslug. | Orchestrator |
| 1 | PRD En människa skriver beskrivningen: ändring, framgångsmått, icke-mål. | wiki/plans/<funktion>-ÅÅÅÅ-MM-DD.md | Människa (enda obligatoriska steget) |
| 2 | Spec Architect-agenten emitterar Gherkin-acceptansscenarier. | wiki/specs/<funktion>.md | Architect (resonemangsmodell) |
| 3 | Test-stubbar Test-writer kompilerar varje scenario till ett misslyckande test. | Vitest + Playwright-tester som misslyckas vid första körningen. | Test-writer (mellanmodell) |
| 4 | Implementation Editor itererar på diff:en tills varje test passerar. | Kod i en isolerad worktree; alla mål-tester gröna. | Editor (mellanmodell) |
| 5 | Självgranskning Tre reviewer-subagenter granskar diff:en parallellt. | P1 / P2 / P3-fyndlista, eller "ren". | resolver-reviewer · dashboard-reviewer · perf-reviewer |
| 6 | Verifiering & dossier Type-check, lint, tester, Playwright-trace + skärmbild. | wiki/raw/dossiers/<funktion>/{trace.zip, screenshot.png, summary.json} | Verifier (mellanmodell) |
| 7 | Granskningsloop Externa review-bot-kommentarer återinträder editor på P1 / P2. | Varje fynd åtgärdat eller motargumenterat med motivering. | Reviewer-feedback (mellanmodell) |
| 8 | Merge + bevis Auto-merge köad; dossier-skärmbild levereras för mänskligt godkännande. | Mergad commit på main + skärmbild till mänsklig kanal. | Orchestrator + GitHub Merge Queue |