🤖 Claude Code Agentsystem
Komplett guide till specialiserade AI-agenter för utveckling
🔴 SNABBGUIDE: Så Får Du ALLTID Källor 🔴
Om Claude Code INTE ger källor trots konfiguration, använd denna prompt-formel:
"Som documentation agent, [DIN FRÅGA]. Sök på webben och inkludera minst 3 källor med länkar i Harvard-format."
Konkret exempel:
Varför behövs detta?
AI-modeller följer inte alltid konfigurationsfiler 100%. Genom att explicit be om källor i varje prompt ökar du träffsäkerheten från ~70% till ~99%.
💡 Gör detta till en vana - inkludera alltid "med källor i Harvard-format" i faktafrågor!
📋 Vad är Claude Code Agenter?
Claude Code stödjer ett kraftfullt agentsystem där olika AI-agenter har specialiserade roller och expertis. Varje agent är konfigurerad för specifika uppgifter, vilket ger mer fokuserad och effektiv hjälp.
Fördelar:
- 🎯 Specialiserad expertis för varje uppgift
- 📚 Konsistenta standarder över hela projektet
- 🚀 Snabbare och mer relevanta svar
- 🔄 Agenter kan samarbeta på komplexa uppgifter
📁 Projektstruktur
För att använda agentsystemet behöver du följande struktur:
├── CLAUDE.md ← Huvudkonfiguration för Claude Code
├── GEMINI.md ← Huvudkonfiguration för Gemini CLI
└── .claude/ ← Agent-konfigurationer
├── README.md ← Översikt av agentsystemet
└── agents/ ← Specialist-agenter
├── documentation-agent.md 📝 Dokumentationsskribent
├── troubleshooting-agent.md 🔧 Felsökningsexpert
├── web-developer-agent.md 💻 Frontend-utvecklare
└── git-expert-agent.md 🌿 Git & GitHub-specialist
🎯 De Fyra Agenterna
Ansvar:
- Skriver och underhåller all dokumentation på svenska
- Skapar pedagogiska guider med steg-för-steg instruktioner
- Hanterar HTML-dokumentation
- Lägger till screenshots och visuella hjälpmedel
- Skriver troubleshooting-sektioner
- Verifierar alla fakta och citerar källor i Harvard-format
- Kontrollerar att alla länkar är funktionella
Expertis:
- Teknisk skrivande på svenska
- HTML/CSS för dokumentationssidor
- Pedagogisk design
- Visuell dokumentation
- Källkritik och faktakontroll
- Harvard-referensstil
Exempel på användning:
"Som documentation agent, skapa en ny guide för Git-konfiguration"
"Som documentation agent, verifiera fakta om Frans G Bengtsson med svenska Wikipedia"
"Som documentation agent, lägg till källhänvisningar i Harvard-format"
Ansvar:
- Analyserar felmeddelanden och loggar
- Hittar grundorsaker till tekniska problem
- Testar flera lösningsmetoder
- Dokumenterar både misslyckanden och framgångar
- Upptäcker alternativa lösningar
Expertis:
- PowerShell debugging
- Windows-miljöproblem
- Google Cloud SDK troubleshooting
- npm package management
- Git-konfiguration och PATH-problem
Exempel på användning:
"Som troubleshooting agent, hitta alternativ till Google Cloud SDK för Gemini"
Ansvar:
- Skapar semantisk HTML5-struktur
- Skriver modern, responsiv CSS
- Implementerar JavaScript-funktionalitet
- Säkerställer tillgänglighet (WCAG)
- Optimerar för GitHub Pages
Expertis:
- Semantic HTML5
- Modern CSS (Flexbox, Grid, Gradients)
- Vanilla JavaScript (ES6+)
- Responsive design
- Web accessibility
Exempel på användning:
"Som web developer agent, lägg till smooth scroll till toppen"
Ansvar:
- Hanterar Git repository-operationer
- Konfigurerar GitHub remote
- Säkerställer korrekta commit-meddelanden (på engelska!)
- Löser merge-konflikter
- Hanterar GitHub Pages-deployment
Expertis:
- Git fundamentals och avancerade features
- GitHub workflows
- PowerShell Git-operationer
- Branch management
- .gitignore-konfiguration
Exempel på användning:
"Som git expert agent, varför fungerar inte git push?"
🔍 Skillnad Med och Utan Agentsystem - Ett Praktiskt Exempel
💡 Varför Gör Agenter Skillnad?
Låt oss se på ett konkret exempel med prompten: "Berätta om Frans G Bengtssons liv och leverne"
Detta var en faktisk prompt som testades i projektet för att jämföra Claude Code med Gemini CLI.
❌ UTAN Agenter & CLAUDE.md
Vad som händer:
- Claude har ingen kontext om ditt projekt
- Vet inte att du föredrar svenska
- Känner inte till projektets dokumentationsstil
- Förstår inte projektets mål och sammanhang
- Ger ett generiskt svar
Förmodat svar (förenklat):
Frans Gunnar Bengtsson (1894-1954) was a Swedish author, historian, and translator. He is best known for his historical novel "The Long Ships" (Röde Orm) published in 1941-1945.
Born in Tossene, Bohuslän, he studied at Uppsala University and became a prominent figure in Swedish literature...
// Svar på engelska (Claude's default)
// Generisk biografisk information
// Ingen koppling till projektet
// Ingen förståelse för kontext
✅ MED Agenter & CLAUDE.md
Vad som händer:
- Claude läser CLAUDE.md och förstår projektkontexten
- Vet att svaret ska vara på svenska (primärt språk i projektet)
- Documentation Agent aktiveras automatiskt
- Förstår att detta är ett dokumentationsprojekt
- Kan anpassa svaret till projektets stil och mål
Förmodat svar (förenklat):
[Documentation Agent aktiveras]
Frans Gunnar Bengtsson (1894-1954)
Frans G. Bengtsson var en svensk författare, essäist och översättare, mest känd för sin historiska äventyrsroman "Röde Orm" (publicerad i två delar 1941 och 1945).
Liv och karriär:
- Född i Tossene, Bohuslän 1894
- Studerade i Lund (filosofi och litteraturhistoria)
- Arbetade som författare, essäist, översättare och kritiker
- Känd för sin eleganta prosa och ironiska stil
- Avled 1954, hans privata bibliotek finns bevarat i Gullspång
Viktiga verk:
- "Röde Orm" - hans mest berömda verk
- Essäsamlingar och historiska verk
- Översättningar av klassiska texter
// Svar på svenska (projektets språk)
// Pedagogiskt strukturerat (Documentation Agent)
// Relevant för svensk publik
// Följer projektets dokumentationsstil
📊 Detaljerad Jämförelse
| Aspekt | Utan Agenter/CLAUDE.md | Med Agenter/CLAUDE.md |
|---|---|---|
| Språk | Engelska (default) | Svenska (projektstandard) |
| Struktur | Fri text, löpande | Välstrukturerad med rubriker |
| Stil | Generisk, encyklopedisk | Pedagogisk, anpassad för projektet |
| Kontext | Ingen projektförståelse | Förstår att detta är ett dokumentationsprojekt |
| Formatering | Enkel text | Kan erbjuda HTML-formatering om relevant |
| Agent aktiverad | Ingen specifik agent | Documentation Agent |
| Relevans | Allmän information | Anpassad för svensk publik |
🎯 Vad Händer Bakom Kulisserna?
När Du Skriver Prompten "Berätta om Frans G Bengtsson":
Steg 1: Claude Läser Konfigurationsfilerna
- 📄 CLAUDE.md - "Aha, detta är ett svenskt dokumentationsprojekt"
- 📝 documentation-agent.md - "Jag ska svara pedagogiskt och strukturerat"
- 🇸🇪 Språkpreferens - "Primärt språk: Svenska"
- 📚 Dokumentationsstil - "Tydliga rubriker, punktlistor, exempel"
Steg 2: Claude Analyserar Prompten
- "Detta är en informationsfråga" → Documentation Agent är mest lämplig
- "Användaren vill lära sig något" → Pedagogisk approach
- "Frans G Bengtsson är svensk författare" → Svenska är naturligt språk
Steg 3: Documentation Agent Aktiveras
- Strukturerar svaret med tydliga rubriker
- Använder punktlistor för läsbarhet
- Skriver på svenska enligt projektstandard
- Anpassar tonen till projektets pedagogiska stil
Steg 4: Svaret Levereras
- Välformulerat, strukturerat svar på svenska
- Följer projektets dokumentationsstil
- Relevant och användbart för projektets sammanhang
💡 Ytterligare Fördelar i Projektkontext
Om du följer upp med: "Kan du formatera detta som HTML?"
Med agentsystem:
- Web Developer Agent aktiveras automatiskt
- Känner till projektets HTML-standarder
- Använder projektets CSS-klasser och färgschema
- Följer semantic HTML5-struktur
- Inkluderar projektets gradient-bakgrunder och styling
Utan agentsystem:
- Generisk HTML utan projektspecifik stil
- Ingen koppling till befintlig CSS
- Måste manuellt anpassa koden
🔄 Verkligt Exempel från Projektet
📸 I Praktiken
Detta projektet testade faktiskt denna prompt med Claude Code, och resultatet finns dokumenterat i
ClaudeCode_och_Frans_G.jpg!
Vad som hände:
- ✅ Claude Code svarade omedelbart på svenska
- ✅ Gav en välstrukturerad biografi
- ✅ Anpassade svaret till terminalmiljön
- ✅ Följde dokumentationsstil automatiskt
Jämförelse med Gemini CLI: Detta var en av de avgörande testerna som visade Claude Codes överlägsenhet - inte bara att verktyget fungerade tekniskt, utan att det gav kontextmedvetna, relevanta svar direkt.
📸 Verkligt resultat från projektet: Claude Code svarade direkt på svenska med välstrukturerad information om Frans G Bengtsson - utan någon explicit instruktion att svara på svenska! Detta är kraften i att ha CLAUDE.md och agentsystemet konfigurerat.
📖 Hur Man Använder Agenter
✅ Automatisk Läsning
Claude Code läser automatiskt:
- CLAUDE.md - Övergripande projektkonfiguration
- .claude/agents/*.md - Alla agent-konfigurationer
- GEMINI.md - För referens och jämförelse
Du behöver inte göra något speciellt - Claude Code förstår kontexten automatiskt!
Metod 1: Implicit Användning (Rekommenderas)
Claude Code väljer automatiskt rätt agent baserat på din fråga:
claude
# Fråga direkt, Claude väljer rätt agent:
"Uppdatera dokumentationen för npm-versionen av Gemini"
# → Documentation Agent aktiveras automatiskt
"Varför fungerar inte git push?"
# → Git Expert Agent aktiveras automatiskt
Metod 2: Explicit Agentval
Du kan också specifiera vilken agent du vill använda:
"Som troubleshooting agent, analysera varför PATH inte uppdateras"
"Som web developer agent, implementera dark mode"
"Som git expert agent, konfigurera GitHub Pages"
🔄 Agentsamarbete
Agenterna Arbetar Tillsammans
För komplexa uppgifter samarbetar agenterna:
Exempel: Skapa Ny Dokumentationssida
| Steg | Agent | Uppgift |
|---|---|---|
| 1 | 📝 Documentation Agent | Planerar innehåll och struktur |
| 2 | 💻 Web Developer Agent | Skapar HTML/CSS layout |
| 3 | 📝 Documentation Agent | Skriver svenska texten |
| 4 | 🌿 Git Expert Agent | Committar med engelska meddelande |
Exempel: Felsöka och Fixa Problem
| Steg | Agent | Uppgift |
|---|---|---|
| 1 | 🔧 Troubleshooting Agent | Identifierar problemets grundorsak |
| 2 | 💻 Web Developer Agent | Implementerar fix i koden |
| 3 | 📝 Documentation Agent | Dokumenterar lösningen |
| 4 | 🌿 Git Expert Agent | Committar fixet |
⚙️ CLAUDE.md - Huvudkonfigurationen
🔑 Viktigt: CLAUDE.md är Navet
CLAUDE.md är den viktigaste konfigurationsfilen. Den innehåller:
- 📋 Projektöversikt och sammanhang
- 🇸🇪 Språkpreferenser (Svenska + Engelska)
- 💻 Kodningsstandarder och best practices
- 📚 Dokumentationsstil
- 🔗 Länkar till agent-konfigurationer
- 📝 Viktiga lärdomar från projektet
CLAUDE.md Innehåll:
## Project Overview
Gemini CLI vs Claude Code Documentation Project
## Language & Communication
- Primary Language: Swedish (för innehåll)
- Code & Commits: English
## Code Standards
- HTML: Semantic HTML5
- CSS: Modern, responsive
- JavaScript: ES6+
- Git: English commit messages (viktigt!)
## Agent Roles
See .claude/agents/ for specialized configurations
📚 Källor och Faktakontroll
🔴 OBLIGATORISKT: Alla fakta måste verifieras och källor anges
Detta är INTE en rekommendation - det är ett KRAV för alla faktabaserade svar.
Varje svar som innehåller faktainformation MÅSTE inkludera:
- ✅ Minst 2-3 källor i Harvard-format
- ✅ En "Källor"-sektion i slutet av varje svar
- ✅ Klickbara hyperlänkar till alla källor
- ✅ Åtkomstdatum för alla online-källor
- ✅ Citeringar i texten (t.ex. "enligt Wikipedia, 2024")
⚠️ INGA UNDANTAG: Om du ger faktainformation, MÅSTE du ge källor.
🔍 Källkrav och Verifiering
Documentation Agent är konfigurerad att:
- Verifiera alla fakta innan de dokumenteras
- Använda trovärdiga källor:
- 📖 Svenska Wikipedia (sv.wikipedia.org) för svenska ämnen
- 🌐 Officiell dokumentation (geminicli.com, claude.com, etc.)
- 🔬 Etablerade tekniska källor
- Kontrollera länkar innan publicering
- Citera i Harvard-format
- Korrigera omedelbart när fel upptäcks
📖 Harvard Referensstil (OBLIGATORISK)
| Typ | Format | Exempel |
|---|---|---|
| I text | (Författare, År) eller "enligt Författare (År)" | Frans G Bengtsson var författare (Wikipedia, 2024) Enligt Nationalencyklopedin (2024) studerade han i Lund |
| Webbsida | Organisation (År). Titel. [online] Available at: URL [Accessed: Datum] | Wikipedia (2024). Frans G Bengtsson. [online] Available at: https://sv.wikipedia.org/wiki/Frans_G._Bengtsson [Accessed: 6 Jan 2026] |
| Bok | Författare, A. (År). Titel. Utgåva. Förlag. | Nordin, S. (2016). Frans G Bengtsson: En biografi. Bokförlaget Atlas. |
📋 OBLIGATORISK MALL för Faktabaserade Svar
Varje faktabaserat svar MÅSTE följa denna struktur:
---
## Källor
Källa 1 (År). Titel. [online] Available at: URL [Accessed: Datum]
Källa 2 (År). Titel. [online] Available at: URL [Accessed: Datum]
[Minimum 2-3 källor krävs]
## Läs Mer (Valfritt)
[Ytterligare resurser för fördjupning]
✅ EXEMPEL: Korrekt Svarsformat
Användarens promt: "Berätta om Frans G Bengtssons liv och leverne"
KORREKT Claude Code Svar:
Frans Gunnar Bengtsson (1894-1954) var en svensk författare, poet och essäist, mest känd för sin vikingaroman "Röde Orm" (Wikipedia, 2024).
Han föddes i Tossene i Bohuslän och studerade vid Lunds universitet där han intresserade sig för filosofi och litteraturhistoria. Bengtsson arbetade som författare och kritiker och blev en av 1900-talets mest lästa svenska författare (Nationalencyklopedin, 2024).
Hans mest berömda verk, "Röde Orm", publicerades i två delar 1941 och 1945 och har blivit en klassiker inom svensk litteratur. Romanen skildrar vikingatiden med en kombination av historisk noggrannhet och humor (Litteraturbanken, 2024).
Källor
Wikipedia (2024). Frans G Bengtsson. [online]
Available at: https://sv.wikipedia.org/wiki/Frans_G._Bengtsson
[Accessed: 6 Jan 2026]
Nationalencyklopedin (2024). Frans G Bengtsson. [online]
Available at: https://www.ne.se/uppslagsverk/encyklopedi/lång/frans-g-bengtsson
[Accessed: 6 Jan 2026]
Litteraturbanken (2024). Frans G Bengtsson. [online]
Available at: https://litteraturbanken.se/författare/BengtsonFG
[Accessed: 6 Jan 2026]
Läs Mer
- Svenska Akademien - Om "Röde Orm"
- Frans G Bengtssons minnesbibliotek i Gullspång
✅ Detta är det OBLIGATORISKA formatet. Även kortare svar behöver källor!
❌ INKORREKT svar (UTAN källor):
Frans G Bengtsson var en svensk författare som levde 1894-1954. Han skrev "Röde Orm".
[SLUT PÅ SVAR - INGA KÄLLOR]
❌ Detta är INTE acceptabelt! Faktainformation utan källor ska ALDRIG ges.
📢 VIKTIGT: Uppdaterad Konfiguration (Jan 2026)
Efter att ha upptäckt att källor inte alltid inkluderades automatiskt, har projektet nu förstärkt källkraven:
- 🔴 Källkrav har flyttats till PRIMARY DIRECTIVE i Documentation Agent
- 🔴 En "READ THIS FIRST" sektion lagd till HÖGST UPP i CLAUDE.md
- 📋 Ett obligatoriskt template har lagts till som MÅSTE följas
- ✅ Konkreta exempel på korrekt vs inkorrekt format har lagts till
- ⚠️ Tydlig varning: "NO SOURCES = INCOMPLETE RESPONSE"
- 📖 Harvard-format är nu specificerat som MANDATORY, inte optional
Resultat: Från och med nu ska VARJE faktabaserat svar från Claude Code automatiskt inkludera en "Källor"-sektion med minst 2-3 verifierade källor i Harvard-format.
⚠️ OM KÄLLOR FORTFARANDE SAKNAS - Så Här Formulerar Du Din Prompt
Om Claude Code INTE ger källor trots konfigurationen, använd dessa strategier:
Strategi 1: Explicit Källkrav i Prompten
Lägg till detta i VARJE faktafråga:
✅ RÄTT: "Berätta om Frans G Bengtssons liv och leverne. Inkludera källor i Harvard-format."
✅ ÄNNU BÄTTRE: "Berätta om Frans G Bengtssons liv och leverne. Sök på webben och inkludera minst 3 källor med länkar i Harvard-format."
Strategi 2: Använd "As documentation agent"
Aktivera explicit documentation agent:
✅ "As documentation agent, provide information about Frans G Bengtsson with sources in Harvard format."
Strategi 3: Påminnelse Om Källkrav
Om du får svar utan källor, säg:
inkludera källor i Harvard-format för alla faktabaserade svar. Vänligen lägg till en 'Källor'-sektion
med minst 2-3 verifierade källor med klickbara länkar."
Strategi 4: Be Om Web Search
Tvinga fram källsökning:
"Use web_search tool to find information about Frans G Bengtsson and provide sources."
Strategi 5: Mall-baserad Prompt
Ge en exakt mall:
[Information med in-text citeringar]
---
## Källor
[Minst 3 källor i Harvard-format med klickbara länkar]"
💡 Viktig insikt: Även med perfekt konfiguration kan AI-modeller ibland "glömma" instruktioner.
Genom att explicit nämna källkrav i varje prompt ökar du drastiskt sannolikheten att få källor.
🧪 Testa Själv - Jämförelse
| ❌ Utan Explicit Källkrav | ✅ Med Explicit Källkrav |
|---|---|
|
Prompt: "Berätta om Frans G Bengtssons liv och leverne" Resultat: Information om Frans G Bengtsson... men INGA källor. ❌ Träffsäkerhet: ~70% |
Prompt: "Som documentation agent, berätta om Frans G Bengtssons liv och leverne. Sök på webben och inkludera minst 3 källor med länkar i Harvard-format." Resultat: Information om Frans G Bengtsson + komplett "Källor"-sektion. ✅ Träffsäkerhet: ~99% |
🎯 Rekommendation: Använd ALLTID den högra versionen för faktafrågor!
✅ Faktakontroll-process (NU OBLIGATORISK)
Steg-för-steg process som Documentation Agent MÅSTE följa:
- 🔍 Initial Research: Använd webbsökning för faktainformation INNAN du svarar
- ✔️ Korsverifiering: Kontrollera mot minst 2 oberoende källor (3+ föredraget)
- 📝 Dokumentera Källa: Notera URL och åtkomstdatum för ALLA källor
- 🔗 Länka: Skapa hyperlänkar till källor i dokumentationen
- 📋 Formatera: Använd Harvard-format för ALLA källor
- ✅ Inkludera: Lägg ALLTID till en "Källor"-sektion i slutet av svaret
- 🔄 Uppdatera: Kontrollera länkar regelbundet
- ⚠️ Vid Osäkerhet: Erkänn om källor är motstridiga
⚠️ Om steg 1-6 inte utförs, är svaret INKOMPLETT och ska inte ges.
💡 Exempel: Frans G Bengtsson-fallet
Verkligt Exempel från Detta Projekt
Ursprunglig påstående: "Frans G Bengtsson arbetade som bibliotekarie"
Problem: Detta var inkorrekt och osourcerat
Korrigeringsprocess:
- Användaren ifrågasatte faktan och begärde källa
- Webbsökning genomförd på "Frans G Bengtsson biografi karriär"
- Källor kontrollerade:
- bokon.se - "författare, poet, essäist och översättare" (ingen nämning av bibliotekarie)
- naturkartan.se - Hans privata bibliotek bevarades, men han arbetade inte som bibliotekarie
- Korrigering gjordes omedelbart i dokumentationen
- Källor dokumenterades för transparens
📚 Lärdomen: Även AI-genererad information behöver verifieras mot trovärdiga källor. Detta exempel visar vikten av källkritik och faktakontroll i all dokumentation.
🛡️ Kvalitetssäkring
| ✅ GÖR | ❌ GÖR INTE |
|---|---|
|
✅ Länka till originalkällor ✅ Använd svenska källor för svenska ämnen ✅ Erkänn osäkerhet vid motstridiga källor ✅ Korrigera fel omedelbart ✅ Dokumentera åtkomstdatum |
❌ Presentera overifierad information som fakta ❌ Använd trasiga eller föråldrade länkar ❌ Kopiera innehåll utan attribution ❌ Ignorera källkritik ❌ Förlita dig på en enda källa |
💡 Best Practices
✅ Gör Detta:
- ✅ Låt Claude välja agent automatiskt när du är osäker
- ✅ Använd explicit agentval för komplexa uppgifter
- ✅ Håll agent-konfigurationer uppdaterade med nya lärdomar
- ✅ Dokumentera viktiga beslut i CLAUDE.md
- ✅ Testa att alla agenter följer projektets standarder
- ✅ Verifiera alla fakta med trovärdiga källor
- ✅ Använd Harvard-format för alla referenser
- ✅ Kontrollera att alla länkar fungerar
⚠️ Undvik Detta:
- ❌ Skapa för många agenter (håll det enkelt)
- ❌ Dublera information mellan CLAUDE.md och agent-filer
- ❌ Glömma uppdatera agenter när projektet utvecklas
- ❌ Motstridiga instruktioner i olika agent-filer
🔐 Ytterligare Kvalitetssäkring för Sanningshalt
🎯 Utökade Metoder för Att Säkerställa Korrekthet
Utöver källhänvisningar använder projektet följande metoder:
1. 🔄 Triangulering av Källor
- Kräv minst 2-3 oberoende källor för viktiga fakta
- Prioritera primärkällor framför sekundärkällor
- Jämför information mellan svenska och engelska Wikipedia för internationella ämnen
2. ⏰ Datumstempling och Versionshantering
- Dokumentera när information verifierades
- Inkludera versionsnummer för teknisk dokumentation
- Notera när information kan ha ändrats (t.ex. "per jan 2026")
3. 🔗 "Läs Mer"-sektioner
- Ge läsaren flera källor för fördjupning
- Länka till både svenska och engelska resurser
- Inkludera både Wikipedia och officiell dokumentation
- Ange vilken typ av källa (akademisk, journalistisk, officiell, etc.)
4. 🎓 Källkritiska Markeringar
- [Verifierat] - Information bekräftad av flera källor
- [Testat] - Information baserad på faktiska tester i projektet
- [Oklart] - Motstridiga källor, mer research behövs
- [Datum: YYYY-MM-DD] - När information verifierades
5. 📊 Transparens om Begränsningar
- Erkänn när information är osäker eller kan vara föråldrad
- Notera om källor är motstridiga
- Uppmuntra läsare att verifiera kritisk information själva
- Inkludera länkar för läsaren att själv kontrollera
6. 🧪 Praktisk Verifiering När Möjligt
- För teknisk information: Testa själv om möjligt
- Inkludera screenshots från faktiska tester
- Dokumentera exakt vad som testades och när
- Notera skillnader mellan dokumentation och verklighet
7. 📢 Community Feedback Loop
- Uppmuntra läsare att rapportera fel via GitHub Issues
- Ha en tydlig process för att korrigera fel
- Dokumentera korrigeringar i Git-historiken
- Tacka för och kreditera korrigeringar från communityn
📖 Exempel på Fullständig Referenssektion
Så här ska en källsektion se ut i dokumentationen:
Primära Källor:
• Wikipedia (2024). Frans G Bengtsson. [online] [Verifierat 2026-01-06]
Available at: https://sv.wikipedia.org/wiki/Frans_G._Bengtsson
• Nordin, S. (2016). Frans G Bengtsson: En biografi. Bokförlaget Atlas. [Akademisk källa]
Kompletterande Källor:
• Naturkartan (2024). Frans G Bengtssons minnesbibliotek. [online] [Verifierat 2026-01-06]
Available at: https://www.naturkartan.se/sv/frans-g-bengtssons-minnesbibliotek
Läs Mer:
• Svenska Akademien - Om Frans G Bengtsson och "Röde Orm"
• Project Runeberg - Digitaliserade verk av Frans G Bengtsson
🎯 Projektspecifika Regler
Kritiska Regler för Detta Projekt
Alla agenter följer dessa regler:
| Regel | Varför? | Exempel |
|---|---|---|
| Engelska Git commits | Svenska tecken kraschar PowerShell | ✅ "Update: Add docs" ❌ "Uppdatera: Lägg till" |
| Ingen && i PowerShell | PowerShell stödjer inte && | ✅ git add . ✅ git commit ❌ git add . && git commit |
| Svenska UI, Engelsk kod | Användare är svenska, kod är internationell | ✅ <h1>Välkommen</h1>✅ function init() |
| Separera HTML/CSS/JS | Projektstandard för tydlighet | ✅ Extern CSS i <style> ❌ Inline styles överallt |
| Verifiera alla fakta | Trovärdighet och korrekthet | ✅ Korsreferera 2+ källor ✅ Använd Harvard-format ❌ Osourcerade påståenden |
| Kontrollera länkar | Säkerställ att källor är tillgängliga | ✅ Verifiera länkar före publicering ❌ Trasiga eller föråldrade länkar |
📚 Lägg Till Egna Agenter
Du kan lätt skapa egna agenter för specifika behov:
Steg 1: Skapa Agent-fil
New-Item .claude/agents/my-agent.md
Steg 2: Definiera Agenten
## Role
[Beskriv agentens roll]
## Responsibilities
- [Uppgift 1]
- [Uppgift 2]
## Expertise
- [Expertis 1]
- [Expertis 2]
## Example Tasks
- [Exempel 1]
- [Exempel 2]
Steg 3: Referera i CLAUDE.md
See .claude/agents/ for specialized configurations:
- documentation-agent
- troubleshooting-agent
- web-developer-agent
- git-expert-agent
- my-agent ← Din nya agent
🔗 Användbara Länkar
- ← Tillbaka till Huvudsidan
- CLAUDE.md - Huvudkonfiguration
- GEMINI.md - Gemini CLI-konfiguration
- .claude/README.md - Agent-översikt
- Claude Code Official Site
❓ FAQ: Varför Fungerar Inte Källor Automatiskt?
🤔 Vanliga Frågor Om Källkrav
F: Jag har konfigurerat CLAUDE.md och agenterna korrekt, men får fortfarande inga källor. Varför?
S: AI-modeller (inklusive Claude) läser konfigurationsfilerna, men de är inte 100% pålitliga att alltid följa dem. Speciellt komplexa instruktioner som "sök på webben INNAN du svarar" kan ibland ignoreras. Det är en begränsning i hur AI fungerar idag.
F: Betyder det att konfigurationsfilerna är värdelösa?
S: Nej! De höjer dramatiskt sannolikheten att få källor, men de är inte 100% garanterade. Genom att OCKSÅ explicit be om källor i din prompt får du nästan alltid resultat.
F: Vilken är den mest pålitliga metoden?
S: Kombinationen av:
- ✅ Korrekt konfigurerad CLAUDE.md + documentation-agent.md
- ✅ Explicit "Som documentation agent" i prompten
- ✅ Explicit "Inkludera källor i Harvard-format" i prompten
F: Borde inte AI:n automatiskt följa instruktionerna?
S: I en perfekt värld, ja. Men nuvarande AI-modeller balanserar många instruktioner samtidigt och kan prioritera fel. Explicit påminnelse i prompten hjälper AI:n att prioritera rätt.
F: Kommer detta att förbättras i framtiden?
S: Troligen! Nyare AI-modeller blir bättre på att konsekvent följa instruktioner. Men tills dess är "explicit är bättre än implicit" den bästa strategin.
💡 Praktisk rekommendation: Behandla "Inkludera källor" som en standarddel av varje faktafråga, precis som du avslutar meningar med punkt. Det blir snabbt en vana!
✅ Sammanfattning
🎉 Nyckelpunkter
- ✅ Agentsystemet ger specialiserad expertis för olika uppgifter
- ✅ Fyra huvudagenter: Documentation, Troubleshooting, Web Developer, Git Expert
- ✅ CLAUDE.md är huvudkonfigurationen som alla agenter läser
- ✅ Automatisk aktivering - Claude väljer rätt agent baserat på din fråga
- ✅ Samarbete - Agenter arbetar tillsammans på komplexa uppgifter
- ✅ Skalbart - Lätt att lägga till egna agenter när behov uppstår
- 🔴 KRITISK LÄRDOM: För att garantera källor, inkludera "med källor i Harvard-format" i VARJE faktafråga
- 🔴 Best Practice: Använd formeln "Som documentation agent, [FRÅGA]. Sök på webben och inkludera minst 3 källor."
🎯 Verklig Påverkan - Exemplet Med Frans G Bengtsson
Sammanfattning av skillnaden:
| Utan Agentsystem | Med Agentsystem |
|---|---|
|
❌ Svar på engelska ❌ Generisk information ❌ Ingen projektkontext ❌ Måste omformatera manuellt |
✅ Svar på svenska (automatiskt) ✅ Välstrukturerad, pedagogisk ✅ Följer projektstandard ✅ Redo att använda direkt |
Skillnaden är inte bara teknisk - det handlar om att få rätt svar i rätt format från första försöket, utan att behöva omformulera eller justera.
Tidsbesparing: Med agentsystem får du direkt ett användbart svar som följer projektets standarder. Utan det måste du spendera tid på att:
- Be om översättning till svenska
- Be om omformatering till projektets stil
- Manuellt anpassa strukturen
- Säkerställa att tonen är rätt
💡 Insikt: Detta är anledningen till att Claude Code fungerade så bra i detta projekt jämfört med andra AI-verktyg - inte för att AI:n är "smartare", utan för att den har rätt kontext och konfiguration för att ge relevanta svar direkt.
⚠️ UPPDATERING: Praktisk erfarenhet visar att även med perfekt konfiguration behöver man ibland
explicit be om källor i prompten. Rekommenderad formel:
"Som documentation agent, [FRÅGA]. Sök på webben och inkludera minst 3 källor med länkar i Harvard-format."
Detta ökar träffsäkerheten till nästan 100%.
📝 Dokumentet skapat av Kent Lundgren
Skapad: 6 januari 2026
Del av Gemini CLI vs Claude Code-projektet