diff --git a/docs/concepts/orkestrering.md b/docs/concepts/orkestrering.md index ba63a4f..e8768d5 100644 --- a/docs/concepts/orkestrering.md +++ b/docs/concepts/orkestrering.md @@ -324,7 +324,37 @@ Boten svarer: Systemet lærer hva brukerne vil ha fra det som ikke lykkes. -## 11. Avgrensning +## 11. Prinsipp: målet er alltid script + +Enhver orkestrering har som mål å bli et deklarativt script. +AI-nivåene (fritekst, drøm) er **verktøy for å komme dit**, +ikke permanente driftsmoduser. + +Hvis en orkestrering ikke kan uttrykkes som script, betyr det +én av to ting: + +1. **Verktøyet mangler.** Lag et nytt CLI-verktøy som dekker + det manglende steget. Da kan scriptet uttrykke det. +2. **Logikken er for vag.** Stram opp instruksjonene til de er + presise nok for et script. Hvis det ikke er mulig, er + orkestreringen kanskje ikke moden nok for automatisering. + +AI som permanent feilhåndtering i en orkestrering er et tegn +på at noe er galt — enten med verktøyet eller med spesifikasjonen. +Det skal fikses, ikke kompenseres. + +``` +Drømmemodus → "Hva vil vi oppnå?" +Fritekst → "Hvordan gjør vi det?" +Script → "Nøyaktig dette." + ↓ +Hvis script ikke er mulig: + → Mangler verktøy? → Lag synops- + → For vagt? → Stram opp spec + → Umulig? → Ikke automatiser dette +``` + +## 12. Avgrensning - Orkestreringer er **ikke** en generell workflow-engine. De er oppskrifter — deklarative eller AI-tolkede. @@ -335,7 +365,7 @@ Systemet lærer hva brukerne vil ha fra det som ikke lykkes. - Brukeren begrenses aldri til kjente verktøy. Manglende funksjonalitet fanges opp som feature requests. -## 12. Komponenter +## 13. Komponenter | Feature | Rolle | |---------|-------| @@ -345,7 +375,7 @@ Systemet lærer hva brukerne vil ha fra det som ikke lykkes. | Arbeidstavlen | Work items opprettes ved feil | | Responskvalitet | Intelligence/effort per orkestrering | -## 13. Bygger på +## 14. Bygger på - `docs/retninger/unix_filosofi.md` — CLI-verktøy som byggeklosser - `docs/retninger/interaksjonsmodell.md` — drag-and-drop for observes-edge - `docs/concepts/arbeidstavlen.md` — @bot, work items ved feil