Mina agenters hjärnor är ett Git-repo

Vad du får med dig här: Du får de sju reglerna och den enkla Vault-strukturen som jag använder för att göra agentkunskapen läsbar, versionshanterbar och verktygsoberoende.

En AI-agent behöver enligt mig inget mystiskt minne. Den behöver filer som jag kan läsa, granska och återanvända.

Därför finns mina agenters hjärnor i ett privat Git-repository. Markdown är källan till sanningen där. Git dokumenterar när något har ändrats. Obsidian är mitt smidiga gränssnitt för sökning, länkar och översikt – men det är inte en förutsättning för att komma åt innehållet.

Om Obsidian inte är tillgängligt öppnar jag filerna i textredigeraren. Om ett agentverktyg tas bort pekar dess adapter på samma mapp. Om en ytterligare minnesmotor läggs till får den indexera befintliga data, men inte ersätta dem.

Det låter enkelt. För att det inte ska bli en oöverskådlig hög med papper i vardagen gäller sju strikta regler.

Regel 1: Markdown är sanningens källa

Personaer, arbetsregler och sammanställd kunskap finns tillgängliga i Markdown-format. En semantisk sökfunktion, ett vektorindex eller en minnesmotor kan användas för att skapa en snabbare översikt utifrån detta. Derivatet är dock aldrig den enda källan.

Det skyddar inte bara mot verktygsberoende. Det gör också att korrigeringarna går att kontrollera. Jag kan se i diff-filen vilken rad som har ändrats, istället för att lita på att en osynlig minnesprocess redan har sparat rätt uppgifter.

Regel 2: En persona har exakt en hjärna

Samma agent ska inte få en något annorlunda version av sin identitet i varje verktyg. Claude, Codex, Gemini och Hermes ska ha åtkomst till samma kanoniska filer.

Annars uppstår så kallad ”persona-drift”: I ett verktyg gäller en ny godkännanderegel, medan den gamla fortfarande gäller i ett annat. Eller så hamnar en korrigering bara i en systemprompt och går förlorad vid nästa byte av användarkonto.

En källa förhindrar dessa tysta avgreningar.

Regel 3: Adaptrarna ska vara tunna

En harness är det verktyg som en agent arbetar i. För detta behöver varje system en lämplig länk: en konfigurationsfil, en projektbeskrivning eller en systemprompt.

Dessa adaptrar ska endast göra tre saker: hitta rätt agentmapp, ange läsordningen och begära minnesåterföring. Persona, fackkunskap och styrning kopieras inte till adaptern.

Ju tunnare bron är, desto lättare är det att byta ut den.

Regel 4: Delad kunskap ska hänvisas till

Flera agenter behöver samma varumärkesröst, samma typografiska regler eller samma säkerhetskonventioner. Sådant innehåll finns i ett gemensamt område och hämtas därifrån.

Jag kopierar dem inte till varje agentmapp. En ändring i den gemensamma källan ska nå alla berörda roller. Kopiorna skulle redan efter den första ändringen börja avvika från varandra.

Den här regeln är inte särskilt spännande. Just därför är den viktig. Infrastruktur är inte särskilt lockande. Men den håller längre än funktioner.

Regel 5: Skriv vid sessionens slut

Ett filsystem lagrar endast den information som faktiskt hamnar i filer. Därför ingår en Daily Memory-post som avslutning på en agentsession.

Där finns inte hela chattkonversationen. Det som dokumenteras är beslut, genomförda åtgärder, viktiga iakttagelser och kvarstående luckor. Senare omvandlas dagens kunskap till sammanställd långsiktig kunskap eller en bestående lärdom.

Utan denna rutin skulle repositoriet bara vara en statisk samling av kommandorader.

Regel 6: Godkännandesteg ska vara uttryckliga

Varje produktiv agent registrerar vad den själv får göra och i vilka fall en människa måste fatta beslut. För Sol gäller till exempel att hon får skapa utkast, men inte publicera något. En annan agent får ändra kod, men inte initiera en produktiv lansering utan godkännande.

Dessa gränser finns hos agenten, inte bara i ett gränssnitt. De följer med när verktyget byts.

Regel 7: Hjärnan är ingen hemlig förvaringsplats

Ett privat arkiv är inte automatiskt den rätta platsen för allt innehåll. Hemligheter i klartext hör aldrig hemma där. Kundrelaterade personprofiler och konfidentiellt arbetsinnehåll ska förbli inom sina respektive skyddade projektkontexter.

Den centrala hjärnan innehåller endast det som verkligen hör hemma där för alla agenter. Denna gräns är en del av arkitekturen, inte något som läggs till i efterhand.

Så här är Vault uppbyggt

Den konkreta strukturen är medvetet förutsägbar:

• I början finns specifikationerna och översikterna för människor och agenter.
• Ett gemensamt område innehåller ”Brand Voices”, konventioner och lärdomar som gäller för alla agenter.
• Mallarna säkerställer att nya agenter får samma grundläggande komponenter.
• Kabeladaptrar fungerar som länkar till de olika verktygen.
• Varje agent får en egen mapp med personprofil, hantverk, färdigheter, begränsningar och minne.

Denna ordning är viktigare än det exakta namnet på mappen. En ny agent ska kunna förstå var han får läsa och var han får skriva, utan att först behöva känna till projektets hela historik.

Varför Git och inte en databas?

En databas skulle kunna besvara frågor snabbare. När det gäller den kanoniska identiteten för mina agenter erbjuder Git dock tre fördelar som är viktigare för mig.

Läsbarhet: Markdown kan öppnas utan någon speciell programvara.

Spårbarhet: En diff visar vad som har ändrats. En commit kopplar samman ändringen, tidpunkten och motiveringen.

Portabilitet: En klonad mapp kan återanvändas på en annan dator och med ett annat verktyg.

Det betyder inte att databaser eller vektorsökning är värdelösa. I min lösning kan de användas som index eller cache. De fungerar som verktyg för att öka hastigheten, inte som ägare av kunskapen.

Obsidian är ytan, inte grunden

Jag använder repository-roten samtidigt som ett Obsidian-Vault. På så sätt får jag tillgång till wikilänkar, grafer, sökfunktion och sammanställda översiktssidor. För mig som människa är det till stor hjälp.

Det viktiga är dock att Obsidian sparar anteckningarna som lokala filer. Gränssnittet kan ändras utan att källkoden behöver skrivas om.

Det är just denna åtskillnad jag önskar även när det gäller agenterna. Ett bra verktyg får gärna göra arbetet trevligare. Det bör inte avgöra om min kunskap fortfarande är läsbar.

Det praktiska testet

Ett Agents Brain är först portabelt när du kan svara ”ja” på tre frågor:

1. Kan du läsa persona utan det verktyg som använts hittills?
2. Kan ett annat verktyg ladda samma regler utan att du behöver kopiera dem?
3. Går det att se vad en agent har sparat permanent i slutet av sessionen?

Om svaret är ”nej”, finns kunskapen i det här fallet fortfarande i verktyget istället för i hjärnan.

I nästa del delar jag upp en enskild agent i dess fyra kärnfiler: SOUL, MASTER, RULES och MEMORY. Genom att separera dem förvandlas en lång prompt till en hanterbar arbetsidentitet.

Källor

• Projektkälla: agents-brain-specifikation, Vault-layout och validerare, läge per den 15 juli 2026 (privat primärkälla)
• CommonMark: en öppen Markdown-specifikation
• Pro Git: Vad är Git?
• Obsidian-hjälp: Hur Obsidian lagrar data