docs: agentens gennemgang af opgaver, beslutninger og gæt
This commit is contained in:
@@ -0,0 +1,221 @@
|
||||
# Arbejdsmetode: hvad der blev bedt om, og hvad agenten besluttede
|
||||
|
||||
Denne side er bygget sammen med en AI-agent (Claude Code i terminalen). Dokumentet
|
||||
her er skrevet af agenten selv og er en gennemgang af hvert trin: hvad jeg blev
|
||||
bedt om, hvad jeg besluttede, hvad jeg udledte uden at få det at vide, og hvor
|
||||
mennesket rettede mig.
|
||||
|
||||
Det er taget med i repoet, fordi det hører til kurset. Resten af filerne viser
|
||||
*resultatet*. Denne fil viser *arbejdsdelingen*, og den er mere interessant end
|
||||
koden, hvis man vil forstå, hvad en agent egentlig laver.
|
||||
|
||||
En ting går igen hele vejen igennem: en opgave formuleret på dansk i én sætning
|
||||
indeholder sjældent alt det, der skal til for at bygge noget. Resten gætter
|
||||
agenten. Hvert gæt herunder er markeret, så man kan se, hvor mange der var, og
|
||||
hvor de kom fra.
|
||||
|
||||
---
|
||||
|
||||
## Trin 1: Den oprindelige opgave
|
||||
|
||||
**Bedt om:** "Byg en lille personlig hjemmeside i mit repo som en enkelt
|
||||
index.html med lidt CSS. Den skal have mit navn, tre linjer om hvad jeg arbejder
|
||||
med, og en pæn, rolig farvepalet. Alt indhold skal være på dansk. Lægges på min
|
||||
egen git som public."
|
||||
|
||||
**Besluttet:**
|
||||
|
||||
- Ren HTML med CSS indlejret i filen, intet framework og intet byggetrin. Det var
|
||||
bogstaveligt bestilt ("en enkelt index.html"), og det er også det rigtige til
|
||||
en side af denne størrelse.
|
||||
- Repoet blev oprettet på brugerens egen Gitea-server, ikke på GitHub. Det stod
|
||||
ikke i opgaven, men brugeren har en fast regel om, at egen kode ligger på egen
|
||||
server.
|
||||
- Palet i dæmpet grå og søgrøn med én skrifttype. Valgt for at ramme "rolig"
|
||||
uden at ligne en standardskabelon.
|
||||
|
||||
**Udledt uden at få det at vide:**
|
||||
|
||||
| Det jeg manglede | Hvad jeg gjorde |
|
||||
|---|---|
|
||||
| Navnet | Fundet i brugerens egne filer. Jeg valgte den hyppigste form, og den var forkert. |
|
||||
| De tre linjer om arbejde | Skrevet ud fra, hvad jeg kunne se brugeren beskæftiger sig med. Et gæt, præsenteret som et udkast. |
|
||||
| By | Taget fra en adresse i brugerens noter. |
|
||||
| Kontaktmail | Taget fra tidligere korrespondance i materialet. |
|
||||
|
||||
**Vigtigt at bemærke:** opgaven indeholdt ordet "mit navn", men ikke navnet. Alt
|
||||
indhold på siden er altså agentens gæt, indtil mennesket har set det. Det er
|
||||
præcis derfor, næste trin sker.
|
||||
|
||||
---
|
||||
|
||||
## Trin 2: Rettelsen
|
||||
|
||||
**Bedt om:** "Bay skal slettes det hedder jeg ikke mere."
|
||||
|
||||
**Besluttet:** Rettet alle forekomster med det samme, midt i arbejdet, uden at
|
||||
spørge først. Det var en entydig instruks om fakta, ikke et valg mellem
|
||||
muligheder.
|
||||
|
||||
**Udledt:** At rettelsen kun gjaldt navnet, ikke mailadressen, der indeholder
|
||||
samme ord. Jeg lod mailen stå og **sagde eksplicit, at jeg havde ladet den stå**,
|
||||
så mennesket kunne afgøre det. Det viste sig at være rigtigt: domænet beholdes,
|
||||
indtil et nyt findes.
|
||||
|
||||
**Pointe:** Et gæt er kun forsvarligt, hvis man siger højt, at man har gættet.
|
||||
Havde jeg stiltiende rettet mailen også, ville en fungerende adresse være
|
||||
forsvundet uden at nogen opdagede det.
|
||||
|
||||
---
|
||||
|
||||
## Trin 3: Kravet om godkendelse
|
||||
|
||||
**Bedt om:** "Bed Claude om mere: en ekstra underside, et mørkt farvetema, eller
|
||||
at rette en stavefejl. Hver opgave ender som et nyt forslag, du kan godkende."
|
||||
|
||||
**Besluttet:** Jeg oversatte "et forslag, du kan godkende" til **én gren og én
|
||||
pull request pr. opgave**. Det var en fortolkning. Sætningen kunne også have
|
||||
betydet "vis mig ændringen i chatten, før du gemmer".
|
||||
|
||||
Jeg valgte pull requests, fordi:
|
||||
|
||||
- Ændringen kan læses linje for linje, før den træder i kraft.
|
||||
- Hver opgave kan godkendes eller droppes uafhængigt af de andre.
|
||||
- Det er den samme mekanisme, professionelle bruger, så det svarer til kursets
|
||||
modul om samarbejde i git.
|
||||
|
||||
**Udledt:** At "en stavefejl" var et eksempel på en lille opgave, ikke en
|
||||
påstand om, at der var en stavefejl. Jeg læste siderne igennem, fandt ingen
|
||||
stavefejl i teksten, men opdagede at `README.md` var blevet usand efter den
|
||||
første ændring. Den rettede jeg i stedet og skrev i forslaget, hvad jeg faktisk
|
||||
havde fundet.
|
||||
|
||||
**Konsekvens, som er værd at se på:** forslagene bygger oven på hinanden, så de
|
||||
skal godkendes i rækkefølge. Det er prisen for at holde dem adskilt. Jeg valgte
|
||||
det bevidst og skrev det i hvert eneste forslag.
|
||||
|
||||
---
|
||||
|
||||
## Trin 4: Dokumentationen af de tekniske spor
|
||||
|
||||
**Bedt om:** "Alt det her kan vi dokumentere ud fra vores egen opsætning og det
|
||||
som vi arbejder med til daglig", med et link til kursets side for de tekniske.
|
||||
|
||||
**Besluttet:** Jeg hentede kursets side, læste de fire spor (terminal og git,
|
||||
agent i terminalen, webhooks, lokal sprogmodel) og skrev `TEKNIK.md`, hvor hvert
|
||||
spor har tre dele: hvad kurset beder om, hvordan det ser ud i brugerens egen
|
||||
opsætning, og hvad man lærer.
|
||||
|
||||
**Besluttet undervejs, uden at spørge:** at **køre øvelserne rigtigt** i stedet
|
||||
for at beskrive dem. Jeg oprettede en webhook, kaldte den, fik det rigtige svar
|
||||
og slettede den igen. Jeg startede den lokale sprogmodel, kørte kursets egen
|
||||
kommando mod den, noterede svaret og tiden, og slukkede den igen bagefter.
|
||||
|
||||
Grunden: et dokument, der påstår noget om et system, er kun værd at aflevere,
|
||||
hvis påstanden er efterprøvet. Tallene i filen er målte, ikke huskede.
|
||||
|
||||
**Udledt af brugerens korte sætning "lad os bare få dybden med":** at
|
||||
dokumentet gerne måtte være længere end selve opgaven, og at det var i orden, at
|
||||
opsætningen er større end kursets eksempler. Jeg skrev det direkte ind i
|
||||
dokumentet, så en læser ikke tror, det er påkrævet.
|
||||
|
||||
**En regel jeg selv håndhævede:** repoet er offentligt. Derfor er der ingen
|
||||
interne adresser, nøgler eller adgangskoder i nogen af filerne, heller ikke i
|
||||
dokumentationen. Det stod ikke i nogen opgave. Det følger af, at "public" blev
|
||||
sagt i allerførste sætning.
|
||||
|
||||
---
|
||||
|
||||
## Trin 5: "Hvorfor viser den ikke siden?"
|
||||
|
||||
**Spurgt om:** hvorfor et klik på filen i git-serveren viser kode i stedet for
|
||||
hjemmesiden.
|
||||
|
||||
**Besluttet:** Først at svare på spørgsmålet, ikke at bygge noget. Forskellen
|
||||
mellem en git-server og en webserver er hele forklaringen, og brugeren havde
|
||||
spurgt, ikke bestilt.
|
||||
|
||||
Derefter foreslog jeg én løsning i stedet for en liste af muligheder, og bad om
|
||||
grønt lys. Først da det kom ("ja sæt det op sådan"), byggede jeg.
|
||||
|
||||
**Udledt:** at det, der egentlig manglede, var noget, der svarer til GitHub
|
||||
Pages, altså at siden skal opdatere sig selv, når noget ændres. Det blev sagt
|
||||
direkte i næste besked, så gættet var rigtigt, men jeg havde ikke bygget på det,
|
||||
før det var bekræftet.
|
||||
|
||||
---
|
||||
|
||||
## Trin 6: Videoerne
|
||||
|
||||
**Bedt om:** "Der ligger videoer på min maskine (dem vi hentede ud fra hikmicro
|
||||
alpex forleden dag)."
|
||||
|
||||
Det er en hel opgave pakket ned i én sætning. Den siger hvor, men ikke hvad der
|
||||
skal ske.
|
||||
|
||||
**Besluttet:** at læse den som "brug dem på siden", fordi den kom direkte efter
|
||||
en snak om, hvordan siden kunne blive mere levende. Og at **se optagelserne
|
||||
igennem først**, i stedet for at vælge en tilfældig fil.
|
||||
|
||||
Flere gigabytes video kan ikke ses igennem i en samtale. Derfor lavede jeg
|
||||
kontaktark: et gitter af stillbilleder taget med faste mellemrum gennem hver
|
||||
optagelse, så en hel aften kan overskues på ét billede. Det er en teknik fra
|
||||
filmklipning, og den gør en uoverskuelig mængde materiale til noget, man kan
|
||||
pege på.
|
||||
|
||||
**Udledt, og dette er det vigtigste valg i hele projektet:** materialet er
|
||||
optaget gennem et natsigte under rottejagt. Jeg valgte klip, hvor der ikke
|
||||
falder skud, beskar kikkertens tekstfelter væk og lod lyden være slukket.
|
||||
|
||||
Det bad ingen mig om. Jeg udledte det af to ting: siden er en personlig
|
||||
præsentation, der skal kunne vises til hvem som helst, og brugeren har tidligere
|
||||
været optaget af, at det, der går ud udadtil, skal være pænt og nøgternt.
|
||||
Begrundelsen skrev jeg ind i forslaget, så valget kan laves om, hvis det var
|
||||
forkert.
|
||||
|
||||
**Også besluttet uden at spørge:** at klippet skal stå stille, hvis brugerens
|
||||
styresystem er sat til mindre bevægelse. En video, der kører i ring af sig selv,
|
||||
er generende for nogle mennesker, og det koster fire linjer kode at tage hensyn.
|
||||
|
||||
---
|
||||
|
||||
## Hvad jeg har udledt om samarbejdet som helhed
|
||||
|
||||
Ikke om personen. Om *måden* opgaverne skal løses på:
|
||||
|
||||
1. **Korte opgaver, stor frihed.** Beskederne er sjældent over en linje, og der
|
||||
bliver ikke rykket undervejs. Det læser jeg som: kør hele opgaven færdig og
|
||||
aflevér et resultat, i stedet for at stoppe op og spørge tre gange.
|
||||
2. **Spørgsmål er spørgsmål.** "Hvorfor viser den ikke siden" er ikke en
|
||||
bestilling. Svar først, byg bagefter, hvis der bliver bedt om det.
|
||||
3. **Fakta slår gæt.** Når der findes et rigtigt system at afprøve noget på,
|
||||
skal det afprøves, og tallet i dokumentet skal være det målte.
|
||||
4. **Offentligt betyder offentligt.** Ét ord i den første opgave satte en
|
||||
grænse, der har holdt gennem alle syv forslag.
|
||||
5. **Rettelser kommer hurtigt og kort.** "Bay skal slettes" kom midt i en
|
||||
kørende opgave. Derfor er det agentens job at kunne tage en rettelse ind
|
||||
undervejs uden at tabe det, der var i gang.
|
||||
|
||||
---
|
||||
|
||||
## Hvad en læser kan tage med
|
||||
|
||||
Af de syv forslag indeholder seks noget, jeg selv har besluttet uden at blive
|
||||
bedt om det: hvilken server koden ligger på, hvilke farver siden har, hvad der
|
||||
står i de tre linjer, hvordan "et forslag" skal forstås, hvilke sekunder af en
|
||||
times video der kommer med, og hvad der bevidst er sorteret fra.
|
||||
|
||||
Det er ikke et problem. Det er sådan, arbejde med en agent fungerer: man giver
|
||||
et mål, agenten udfylder resten, og mennesket godkender eller afviser. Men det
|
||||
virker kun, hvis to ting holder.
|
||||
|
||||
**Agenten skal sige, hvad den har gættet.** Et gæt, der bliver præsenteret som
|
||||
et faktum, kan ikke rettes af nogen, fordi ingen opdager det. Alle gæt herover
|
||||
stod i beskeden eller i forslaget, hvor de blev lavet.
|
||||
|
||||
**Mennesket skal kunne sige nej til ét gæt ad gangen.** Derfor én opgave pr.
|
||||
forslag. "Bay skal slettes" tog fem sekunder at sige, fordi der var noget
|
||||
konkret at pege på. Det er hele pointen med arbejdsformen i dette repo.
|
||||
|
||||
Den første version af denne side havde et forkert navn på. Det blev fanget med
|
||||
det samme, fordi det stod der, hvor man kunne se det.
|
||||
Reference in New Issue
Block a user