Agent-First Dokumentation, del 1

Jag driver en koncern med fyra bolag. Bokföring, löner, fakturering, avtal, teknisk dokumentation: allt som hör till. För ett år sedan fanns det mesta i mitt huvud, i e-posttrådar och i utspridda dokument.

Idag använder jag Claude som en operativ medarbetare. Inte som en chatbot man ställer frågor till, utan som någon som faktiskt kan agera i min dokumentation. Men det fungerar bara om dokumentationen är gjord för det.

Den här guiden beskriver hur jag löste det. Inte med programmering eller dyra system, utan med en enkel struktur av textfiler och mappar.

Vad betyder agent-first?

Agent-first innebär att du strukturerar din information så att en AI kan läsa och förstå den, inte bara du. Tänk på det som att anställa en ny medarbetare: om du har en handbok, en filstruktur och tydliga mallar kan personen komma igång själv. AI fungerar likadant, fast den läser ännu snabbare.

I praktiken handlar det om tre saker:

1. Strukturerat format med tydlig rubrik, kategori och taggar
2. Konsekvent mönster där alla dokument följer samma mall
3. Centralt register som listar alla dokument med metadata

Vad guiden täcker

I del 1 går jag igenom grunderna:

• Varför Markdown och YAML är det mest praktiska formatet
• Hur du väljer plattform (GitHub) och separerar internt från externt
• Hur du ger varje dokument en identitet med frontmatter
• Hur registret fungerar som dokumentens telefonkatalog
• Praktiska exempel från min egen bokslutsdomän
• Governance: hur du håller ordning utan att det tar tid
• Var du börjar, och vad du kan skippa

Det hela tar 20-40 minuter per vecka att underhålla. Inte mer.

Ladda ner guiden

Guiden finns som PDF (9 sidor) och täcker allt du behöver för att komma igång.

Vad kommer i del 2?

Del 2 handlar om vad som händer när du bygger agenter på den här grunden:

• Varför dokumentation ensamt inte räcker: agenter behöver permissions, state och memory
• Skillnaden mellan att en agent läser en eskaleringsregel och att den faktiskt följer den
• Hur du behåller kontrollen utan att vara flaskhals
• Praktiska exempel från min marknadsföringsagent som kör själv varje vecka

Del 2 publiceras inom kort.