Jeg underviser i det, jeg selv bruger

Jeg sidder faktisk og får phugl.dk bygget om med Codex, mens jeg skriver det her.

Den seneste version så pæn ud. Men forklaringen på min arbejdsmåde var stadig for luftig. Der stod blandt andet, at materialet blev ordnet, og at resultatet kom tilbage.

Det kunne jo betyde hvad som helst.

Så jeg gav Codex opgaven tilbage. Forsiden skal hurtigt forklare, hvad phugl kan hjælpe med. Den fulde arbejdsmåde får sin egen side, hvor man kan følge en rigtig opgave og se, hvad Codex bygger, hvordan resultatet bliver testet, og hvad der bliver gemt bagefter.

Den konkrete opgave er denne hjemmeside

Denne hjemmeside, helt konkret

Følg opgaven trin for trin

Her kan du se, hvad jeg beslutter, hvad Codex gør, og hvordan fejl fra tests og en ekstra gennemgang bliver sendt tilbage til en ny rettelse.

Opgaven

Resultatet

En præcis liste over det, der skal ændres, uden at resten af siden bliver blandet ind i opgaven.

Det gør jeg

Jeg siger, at siden ser fin ud, men at man stadig ikke kan mærke, hvordan jeg faktisk løser en opgave.

Det gør Codex

Codex finder de berørte sider, den beslægtede artikel og den kode, der holder den gamle forklaring på plads.

Sådan bliver resultatet testet

Codex sammenholder opgaven med den synlige side og de eksempler, jeg har peget på.

Den konkrete opgave er den nye struktur på hjemmesiden.

Jeg har sagt, at forsiden gentog den samme forklaring flere steder, og at arbejdsmåden ikke hang logisk sammen. Codex har derfor fundet de sider, funktioner og artikler, hvor den gamle forklaring stadig ligger.

Nu bliver forsiden kortere. Den nye side Sådan arbejder jeg viser opgaven gennem fire trin. Hvis en test eller en ekstra gennemgang finder en fejl, går opgaven tilbage til Codex. Ved siden af kan man se, hvad der bliver gemt til næste lignende opgave.

Det er jo meget lettere at forstå end “materialet bliver sorteret”.

Jeg viser materialet og sætter retningen

Jeg beskriver først det resultat, der skal virke. Til denne opgave har Codex også den eksisterende hjemmeside, mine tidligere kommentarer, designretningen og de kontroller, som allerede beskytter bloggen.

Jeg siger ikke, hvilken fil Codex skal åbne først, eller præcis hvordan hvert afsnit skal bygges. Det finder Codex selv ud af. Jeg sætter målet: En ny besøgende skal hurtigt forstå, hvad phugl kan hjælpe med. Den, der vil vide mere, skal kunne se hele arbejdsmåden på den særskilte side.

Codex vælger selv, hvilke filer der skal ændres. En anden model læser planen uden at skrive i filerne og peger på logiske huller og uklare formuleringer. Fundene går tilbage til Codex.

Jeg tester og retter igen

Når den lokale version er klar, åbner Codex siden på mobil og computer. Knapper og links bliver brugt med mus, berøring og tastatur. Codex tager også skærmbilleder, så vi kan se, om teksten kan læses, og om noget ligger forkert.

Hvis en tekst forsvinder, et link ender det forkerte sted, eller forklaringen stadig ikke giver mening, går fundet tilbage til Codex. Codex retter og kører den samme test igen.

Det er det loop, jeg bruger ret meget efterhånden.

Min opgave er at sige præcist, hvad der skurrer, når et fund ændrer selve retningen. Denne gang var problemet, at sproget var intetsigende. Jeg skrev ikke siden færdig selv. Jeg gav kritikken og de konkrete eksempler tilbage til Codex, som rettede den.

Det samme sker, hvis den anden model finder en ny svaghed i sin gennemgang. Codex retter. Siden bliver bygget igen. Testene bliver kørt igen.

Det er også sådan, jeg arbejder med kurser. En case, der bare siger “analysér materialet”, er for tynd. Den går tilbage og bliver bygget ud med en konkret situation, rigtige valg og noget, deltageren faktisk kan gøre.

Det, der virker, bliver gemt til næste gang

Vores samtale træner ikke modellen på ny. Jeg gemmer i stedet min feedback som en regel, en test eller kode, Codex kan bruge igen.

I denne opgave blev min kritik af de uklare proceskort omsat til en regel: Teksten skal nævne den konkrete opgave og handling. Den regel ligger nu i skriveguiden. Der er også en test, som opdager, hvis de gamle formuleringer kommer tilbage, og koden til de klikbare trin kan genbruges.

Når Codex får en lignende opgave, kan agenten læse reglen, køre testen og tage udgangspunkt i den kode, der allerede virker. Det er sådan næste opgave bliver bedre, selv om selve modellen ikke er blevet trænet på vores samtale.

Jeg bestemmer, hvad der bliver sendt og lagt live

Jeg giver Codex plads til at skrive, bygge, teste og rette i de lokale filer uden at spørge mig om hvert lille valg.

Jeg vælger målet og ændrer retningen, når der er brug for det. Jeg tager også de beslutninger, der har en reel konsekvens. Denne hjemmeside kan blive bygget, testet og lagt i en testversion uden at vente på mig ved hvert lille trin. Jeg beslutter særskilt, om den skal lægges live.

Det samme gælder en mail, et opslag eller en betaling. Codex kan gøre arbejdet klar. Jeg sender selv mailen, lægger opslaget eller siden live og godkender betalingen.

Hvad kan en mindre virksomhed bruge det til?

Jeg ville begynde med en opgave, der allerede ligger på bordet og irriterer.

Det kan være tilbud, der hver uge bliver samlet fra de samme gamle dokumenter. Beskriv, hvordan et færdigt tilbud skal se ud, og giv Codex adgang til de rigtige filer. Lad den samle tilbuddet, kontrollere priser og navne mod kilderne og vise en testversion.

Når der mangler noget, går fundet tilbage til Codex. Når forløbet virker, gemmer I det gode eksempel og den kontrol, der fangede fejlen. Næste tilbud begynder så med mere viden og en bedre arbejdsgang.

Det er sådan, jeg bygger min egen måde at arbejde med Codex på. Én rigtig opgave ad gangen. Først opgaven, så tests og rettelser, og til sidst de regler og dele, der er værd at genbruge.

Giver det mening? Ellers sig endelig til.