Du har laget agents.md og listet opp hvem agentene dine er. Nå spør du deg hva som faktisk gjør at agenten oppfører seg som du vil. Det er der soul.md kommer inn. Hvis agents.md er organisasjonskartet, er soul.md kulturen. Det er her du bestemmer tonen, holdningene og verdiene til agentene dine. Og det krever ikke et eneste linjekode.
Soul.md er ren tekst, ikke struktur
Det første som overrasker mange når de åpner en soul.md-fil, er hvor enkel den ser ut. Det er ingen tabeller, ingen lister, ingen tekniske felter. Det er bare ren tekst. Vanlige norske setninger som beskriver hvordan du vil at agenten skal være.
Hele filen er skrevet som om du forklarer et nytt teammedlem hva som er viktig på den første arbeidsdagen. Hvilken tone skal de bruke? Hvor formelle skal de være? Hva er aldri akseptabelt? Hva gjør de når de er usikre? Du svarer på disse spørsmålene i samme tone som du ville snakket med en ny kollega.
Det er en helt annen sjanger enn den teknologiske dokumentasjonen mange er vant til. Du skriver mer som en mentor enn som en utvikler. Vil du forstå hvor soul.md passer inn i den større filstrukturen, anbefaler vi Filer og minne i OpenClaw.
Tonen øverst i filen
Helt øverst i en typisk soul.md står noen linjer om tone. Skal agentene være formelle eller uformelle? Bruker de "du" eller "De"? Skal de være vennlige og varme, eller mer profesjonelle og distanserte?
En enkel linje som "vær vennlig og direkte, unngå unødvendige høflighetsfraser" former hvordan alle agentene dine kommer til å snakke. Det er en setning, men den styrer titusenvis av e-poster, meldinger og oppsummeringer fremover. Det er kraftig.
Når du beskriver tonen, tenk gjennom hva som faktisk passer for din bedrift. En klinikk for fysioterapi vil ha en annen tone enn et kreativt byrå. En B2B-leverandør i industrien snakker annerledes enn en frilanser i designbransjen. Soul.md er stedet du fanger denne karakteren.
Hvordan agenten håndterer usikkerhet
Lengre ned i en typisk soul.md står det noe om hvordan agenten skal håndtere usikkerhet. Skal den prøve å gjette hvis den er i tvil, eller skal den stoppe opp og spørre deg? Det er kanskje en av de viktigste beslutningene du tar når du lager en agent.
En linje som "hvis du er usikker på hva brukeren mener, spør heller enn å gjette" gjør forskjellen på om agenten plaprer i vei med svar som ikke treffer, eller om den faktisk samarbeider med deg. En agent som spør ofte er mindre selvgående, men mye mer pålitelig.
Du må ta dette valget bevisst. Hvis agenten skal håndtere kundehenvendelser, vil du sannsynligvis at den heller spør enn å gjette. Hvis den skal generere kreative innholdsforslag du uansett kommer til å vurdere, kan litt gjetting være greit, fordi du er der som filter.
Verdier som binder hele teamet sammen
Litt lengre ned i filen står det gjerne noen linjer om verdier. Hva skal prioriteres? Hva er aldri akseptabelt? Det høres abstrakt ut, men i praksis er det enkelt og konkret.
"Vær alltid ærlig om hva du har gjort og ikke gjort. Ikke pynt på sannheten." Det er en kjerneverdi du gir hele teamet ditt på én linje med tekst. Den verdien styrer hvordan agenten rapporterer tilbake til deg etter en oppgave. Den styrer om agenten skjuler feil eller flagger dem. Den styrer om du kan stole på at sammendragene reflekterer det som faktisk skjedde.
En annen verdi kan være: "Hvis du oppdager at noe ikke gir mening, stopp og spør." Det forhindrer at agenten fortsetter å bygge på en feil antagelse, og at små feil vokser til store problemer.
Soul.md er holdninger, ikke teknikk
Det viktige å huske er at ingenting i soul.md er teknisk. Det er bare holdninger du beskriver. Det er sjelen til agenten, og det er regler for hvordan du vil at agenten skal være, ikke hvordan den skal kode eller koble seg til API-er.
Tenk på det som en personalhåndbok i bedriften din. Personalhåndboka beskriver ikke hvordan du installerer e-postklienten. Den beskriver hva som forventes av oppførsel, hvilke verdier som ligger i bunn, og hvordan teamet skal samarbeide. Soul.md har akkurat samme funksjon for agentene dine.
Hvordan filen henger sammen med agents.md og skill.md
Soul.md er én av tre kjernefiler. Den jobber tett med agents.md, som beskriver hvem som er på laget, og med skill.md, som beskriver hva hver enkelt ferdighet kan gjøre. Sammen utgjør de identiteten og oppførselen til hele agent-teamet ditt.
Det fine med å splitte det opp slik er at du kan endre tonen uten å røre verken roller eller ferdigheter. Hvis du innser at agenten er for formell, justerer du soul.md. Hvis du vil legge til en ny rolle, går du inn i agents.md. Hver fil har sin tydelige funksjon, og det gjør vedlikeholdet enkelt.
Slik tester du om soul.md gir riktig tone
Den beste testen på om soul.md fungerer er å gi agenten en typisk oppgave og lese resultatet. Føles tonen riktig? Stiller agenten spørsmål når den burde, eller plaprer den i vei? Stemmer holdningene med det du faktisk vil ha?
Hvis noe ikke stemmer, er det sjelden en stor omskriving som trengs. Det er som regel én eller to linjer du justerer. Sett "vær formell og presis" i stedet for "vær vennlig og direkte" og se hvordan stilen endres. Det er denne lille justeringen som gjør soul.md så praktisk å jobbe med.
Klar for neste steg
Når du har soul.md på plass, er neste fil i puslespillet skill.md, som beskriver hva hver ferdighet faktisk gjør. Vi går gjennom skill-filen i slik beskriver du ferdigheter med skill.md.
Vil du se hvordan soul.md ser ut i et komplett oppsett, finner du gjennomgangen i OpenClaw-kurset til Benjamin Bruarøy på Utdannet.no.
