diff --git a/ARBEJDSMETODE.md b/ARBEJDSMETODE.md new file mode 100644 index 0000000..68d0a72 --- /dev/null +++ b/ARBEJDSMETODE.md @@ -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. diff --git a/README.md b/README.md index 2d5fe23..9355a46 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,7 @@ Skoleprojekt 2026. Alt indhold er på dansk. - `klip.js` – stopper videoklippet, hvis brugeren har bedt om mindre bevægelse - `media/` – et kort, lydløst klip fra natkikkerten (8 s, under 1 MB) og dets stillbillede - `TEKNIK.md` – kursets fire tekniske spor dokumenteret på min egen opsætning +- `ARBEJDSMETODE.md` – agentens egen gennemgang: hvad den blev bedt om, hvad den besluttede, og hvad den gættede - `CLAUDE.md` – projektets tre regler til Claude Code Åbn `index.html` i en browser for at se siden.