Fiktive Modellfirma im AI-PA Bildungskontext — keine echte Marke
Strömungswerk Engineering GmbH StrömungswerkEngineering
Fortgeschritten · Referenz

Hermes Agent mit Profilen steuern: Bereiche, Arbeitsverzeichnisse und Skills sauber aufbauen

Profile, Arbeitsverzeichnisse, AGENTS.md und Skills sauber kombinieren — damit ein Agent pro Bereich eine klare Rolle hat und sich nichts vermischt.

01 · Referenz

Grundidee

Hermes Agent kann über Profile so organisiert werden, dass unterschiedliche Agenten unterschiedliche Aufgabenbereiche übernehmen.

Grundidee — im Detail aufklappen

Beispiel:

  • Ein Profil kümmert sich um Finanzen
  • Ein anderes Profil kümmert sich um Marketing
  • Ein weiteres Profil kümmert sich um Kundenprojekte
  • Ein anderes Profil ist nur für private Wissensverwaltung zuständig

Das Ziel ist nicht nur, verschiedene Chat-Namen zu haben. Das Ziel ist:

  • getrennte Zuständigkeiten
  • getrennte Erinnerungen / Memory
  • getrennte Arbeitsverzeichnisse
  • getrennte Regeln
  • getrennte Skills
  • weniger Vermischung zwischen Bereichen

Ein Hermes-Profil ist also wie eine eigene Arbeitsrolle.

Weiter — Die vier Ebenen
02 · Referenz

Die vier Ebenen: Profil, Arbeitsverzeichnis, Projektregeln, Skill

Für ein gutes Setup sollte man vier Ebenen unterscheiden.

Die vier Ebenen — im Detail aufklappen
EbeneZweckBeispiel
ProfilWer ist dieser Agent?finanzen, marketing, kunde-a
ArbeitsverzeichnisWo arbeitet er hauptsächlich?Obsidian Vault/Finanzen
ProjektregelnWelche Regeln gelten in diesem Bereich?AGENTS.md im Ordner
SkillWie erledigt er wiederkehrende Aufgaben?finance-controller, content-planner

Diese Ebenen ergänzen sich. Man sollte nicht versuchen, alles nur über Skills zu lösen.

Weiter — Wann nutze ich was?
03 · Referenz

Wann nutze ich was?

Profil

Nutze ein Profil, wenn du einen Agenten mit eigener Rolle willst.

Gut für:

  • getrennte Themenbereiche
  • getrennte Memory
  • getrennte Konfiguration
  • getrennte Skills
  • verschiedene Arbeitsverzeichnisse
  • verschiedene Modelle oder Tools

Beispiele:

finanzen
marketing
legal
kundenservice
produktentwicklung
Arbeitsverzeichnis

Das Arbeitsverzeichnis sagt Hermes: „Hier ist dein Hauptarbeitsbereich."

Wenn der Agent startet, ist er direkt im richtigen Ordner. Datei-Tools, Suche und Projektkontext beziehen sich dann natürlicher auf diesen Bereich.

Beispiel:

/Users/name/Documents/Obsidian Vault/Finanzen
AGENTS.md oder .hermes.md

Diese Dateien beschreiben die lokalen Regeln des Projekts oder Ordners.

Beispiel:

Obsidian Vault/Finanzen/AGENTS.md

Darin steht zum Beispiel:

  • nur im Finanzordner arbeiten
  • keine Beträge erfinden
  • Reports unter Reports/ speichern
  • Steuerdokumente unter Steuer/ ablegen
  • bei unklaren Buchungen nachfragen
Skill

Ein Skill beschreibt eine Arbeitsweise.

Beispiele:

  • Monatsreport erstellen
  • Sponsoring-Leads bewerten
  • Content-Kalender bauen
  • Meeting-Notizen strukturieren
  • Obsidian-Notizen verlinken

Ein Skill ist weniger dafür da zu sagen: „Arbeite nur in diesem Ordner." Dafür sind Profil + Arbeitsverzeichnis + AGENTS.md besser.

Ein Skill sagt eher: „Wenn du diese Art Aufgabe erledigst, gehe nach diesem Verfahren vor."

Weiter — Einsteiger-Beispiel
04 · Referenz

Einsteiger-Beispiel: Obsidian-Vault mit Finanzen und Marketing

Angenommen dein Obsidian-Vault liegt hier:

Einsteiger-Beispiel — im Detail aufklappen
/Users/holgergelhausen/Documents/Obsidian Vault

Dann könnte die Struktur so aussehen:

Obsidian Vault/
├── Finanzen/
│   ├── AGENTS.md
│   ├── Einnahmen/
│   ├── Ausgaben/
│   ├── Reports/
│   ├── Steuer/
│   └── Offene Fragen.md
│
├── Marketing/
│   ├── AGENTS.md
│   ├── Kampagnen/
│   ├── Content/
│   ├── CRM/
│   ├── Reporting/
│   └── Ideen.md
│
└── Wissen/
    ├── Allgemein/
    └── Notizen/

Dann legst du zwei Hermes-Profile an:

finanzen
marketing

Das Profil finanzen arbeitet primär in Obsidian Vault/Finanzen. Das Profil marketing arbeitet primär in Obsidian Vault/Marketing.

Weiter — Schritt-für-Schritt
05 · Referenz

Schritt-für-Schritt: Zwei Hermes-Profile anlegen

1. Profile erstellen
hermes profile create finanzen --clone
hermes profile create marketing --clone

--clone bedeutet: Das neue Profil übernimmt sinnvolle Grundeinstellungen aus deinem aktuellen Profil.

2. Arbeitsverzeichnis für Finanzen setzen
hermes --profile finanzen config set terminal.cwd "/Users/holgergelhausen/Documents/Obsidian Vault/Finanzen"
3. Arbeitsverzeichnis für Marketing setzen
hermes --profile marketing config set terminal.cwd "/Users/holgergelhausen/Documents/Obsidian Vault/Marketing"
4. Profil starten

Finanzen:

hermes --profile finanzen

Marketing:

hermes --profile marketing

Oder in Desktop/TUI entsprechend das Profil auswählen, falls du mit der Oberfläche arbeitest.

5. Prüfen

Du kannst prüfen, ob die Profile existieren:

hermes profile list

Und Details anzeigen:

hermes profile show finanzen
hermes profile show marketing
Weiter — AGENTS.md
06 · Referenz

AGENTS.md: Dem Agenten den Arbeitsbereich erklären

Ein Profil gibt die Rolle vor. Das Arbeitsverzeichnis gibt den Ort vor. Aber die konkreten Regeln gehören in eine Kontextdatei.

Für portable Projektregeln eignet sich AGENTS.md.

Wichtig: AGENTS.md wird im aktuellen Arbeitsverzeichnis gefunden. Deshalb sollte das Profil direkt im passenden Ordner starten.

Beispiel: Finanzen/AGENTS.md
# Finanzen-Agent

Du arbeitest im Obsidian-Vault im Bereich Finanzen.

## Hauptarbeitsbereich

/Users/holgergelhausen/Documents/Obsidian Vault/Finanzen

## Zuständigkeit

Dieses Profil kümmert sich um:
- Einnahmen
- Ausgaben
- Monatsreports
- Steuerunterlagen
- offene Finanzfragen
- Beleg- und Buchungsnotizen

## Ordnerstruktur

- Einnahmen/ — Einnahmen, Rechnungen, Zahlungseingänge
- Ausgaben/ — Kosten, Abbuchungen, Belege
- Reports/ — Monatsberichte, Jahresübersichten
- Steuer/ — steuerrelevante Dokumente und Notizen
- Offene Fragen.md — Unklarheiten, die geklärt werden müssen

## Regeln

- Arbeite primär innerhalb dieses Ordners.
- Bearbeite keine Dateien außerhalb von Finanzen/, außer der Nutzer fordert es ausdrücklich.
- Erfinde keine Beträge, Buchungen, Namen oder Belege.
- Wenn Informationen fehlen, stelle Rückfragen oder markiere sie als offen.
- Nutze Obsidian-Wikilinks im Format [[Notizname]].
- Reports gehören in den Ordner Reports/.
- Steuerrelevante Informationen gehören in den Ordner Steuer/.

## Ausgabe-Stil

- Kurz, sachlich, prüfbar.
- Bei Zahlen immer Quelle oder Datei nennen.
- Unklare Punkte als „Offene Fragen" sammeln.
Beispiel: Marketing/AGENTS.md
# Marketing-Agent

Du arbeitest im Obsidian-Vault im Bereich Marketing.

## Hauptarbeitsbereich

/Users/holgergelhausen/Documents/Obsidian Vault/Marketing

## Zuständigkeit

Dieses Profil kümmert sich um:
- Kampagnenplanung
- Content-Ideen
- Social-Media-Planung
- CRM-Nurturing
- Marketing-Reports
- Zielgruppen- und Persona-Notizen

## Ordnerstruktur

- Kampagnen/ — laufende und geplante Kampagnen
- Content/ — Posts, Skripte, Hooks, Ideen
- CRM/ — Segmente, Follow-ups, Nurturing-Strecken
- Reporting/ — KPIs, Wochenberichte, Learnings
- Ideen.md — ungefilterte Ideen und Backlog

## Regeln

- Arbeite primär innerhalb dieses Ordners.
- Bearbeite keine Dateien außerhalb von Marketing/, außer der Nutzer fordert es ausdrücklich.
- Nutze vorhandene Kampagnen- und Persona-Notizen, bevor du neue Ideen erfindest.
- Markiere Annahmen klar als Annahmen.
- Nutze Obsidian-Wikilinks.
- Content-Entwürfe gehören in Content/.
- Kampagnenpläne gehören in Kampagnen/.
- Reporting gehört in Reporting/.

## Ausgabe-Stil

- Strategisch, aber konkret.
- Immer mit nächsten Schritten.
- Bei Kampagnen: Zielgruppe, Kanal, Hook, CTA, Timing nennen.
Weiter — Skills
07 · Referenz

Skills: Arbeitsweisen statt Ordnergrenzen

Skills sollten nicht primär die Ordnerstruktur definieren. Dafür sind Profile und AGENTS.md besser. Ein Skill ist ideal für wiederholbare Aufgaben.

Beispiel-Skill: finance-controller
# Finance Controller

## When to Use

Nutze diesen Skill, wenn der Nutzer Monatsreports, Ausgabenanalysen, Einnahmenübersichten oder steuerrelevante Zusammenfassungen erstellen möchte.

## Procedure

1. Suche relevante Notizen in Einnahmen/, Ausgaben/, Reports/ und Steuer/.
2. Sammle alle Zahlen mit Quellenangabe.
3. Markiere fehlende Belege oder unklare Buchungen.
4. Erstelle eine strukturierte Zusammenfassung.
5. Schreibe neue Reports unter Reports/YYYY-MM.md.
6. Sammle offene Punkte in Offene Fragen.md.

## Pitfalls

- Keine Beträge erfinden.
- Keine Steuerberatung vortäuschen.
- Keine Buchung als geklärt markieren, wenn der Beleg fehlt.
Beispiel-Skill: marketing-planner
# Marketing Planner

## When to Use

Nutze diesen Skill für Kampagnenplanung, Content-Kalender, Persona-Mapping und CRM-Nurturing.

## Procedure

1. Lies vorhandene Notizen in Kampagnen/, Content/, CRM/ und Reporting/.
2. Prüfe Zielgruppe, Kanal, Angebot und Timing.
3. Entwickle konkrete Kampagnenideen.
4. Erstelle Content-Bausteine: Hook, Angle, CTA, Format.
5. Speichere Kampagnenpläne unter Kampagnen/.
6. Speichere Content-Entwürfe unter Content/.

## Pitfalls

- Keine Zielgruppen erfinden, wenn Personas vorhanden sind.
- Keine KPI-Versprechen ohne Daten.
- Ideen immer mit nächstem Schritt abschließen.
Weiter — Weitere Beispiele
08 · Referenz

Weitere Beispiele

Beispiel 1: Finanzen, Marketing und Recht
Obsidian Vault/
├── Finanzen/
│   ├── AGENTS.md
│   ├── Einnahmen/
│   ├── Ausgaben/
│   └── Reports/
│
├── Marketing/
│   ├── AGENTS.md
│   ├── Kampagnen/
│   ├── Content/
│   └── Reporting/
│
└── Recht/
    ├── AGENTS.md
    ├── Verträge/
    ├── Datenschutz/
    └── Offene Prüfungen.md
hermes profile create finanzen --clone
hermes profile create marketing --clone
hermes profile create recht --clone
hermes --profile finanzen config set terminal.cwd "/Users/name/Documents/Obsidian Vault/Finanzen"
hermes --profile marketing config set terminal.cwd "/Users/name/Documents/Obsidian Vault/Marketing"
hermes --profile recht config set terminal.cwd "/Users/name/Documents/Obsidian Vault/Recht"

Logik: finanzen pflegt Finanznotizen, marketing pflegt Kampagnen und Content, recht strukturiert Verträge, erfindet aber keine Rechtsberatung.

Beispiel 2: Agentur mit mehreren Kunden

Eine Agentur könnte für jeden Kunden ein eigenes Profil haben.

Kunden/
├── Kunde-A/
│   ├── AGENTS.md
│   ├── Strategie/
│   ├── Content/
│   ├── Reporting/
│   └── Meetings/
│
├── Kunde-B/
│   ├── AGENTS.md
│   ├── Strategie/
│   ├── Content/
│   ├── Reporting/
│   └── Meetings/
│
└── Intern/
    ├── AGENTS.md
    ├── Prozesse/
    └── Templates/
hermes profile create kunde-a --clone
hermes profile create kunde-b --clone
hermes profile create agentur-intern --clone
hermes --profile kunde-a config set terminal.cwd "/Users/name/Kunden/Kunde-A"
hermes --profile kunde-b config set terminal.cwd "/Users/name/Kunden/Kunde-B"
hermes --profile agentur-intern config set terminal.cwd "/Users/name/Kunden/Intern"

Warum getrennte Profile? Weil Kundenkontexte nicht vermischt werden sollen: andere Marke, andere Tonalität, andere Zielgruppen, andere vertrauliche Informationen, andere Reports.

Passende Skills: client-reporting, content-calendar, meeting-summary, brand-voice-editor.

Beispiel 3: Produktteam (Engineering, Product, Support)
Produkt/
├── Engineering/
│   ├── AGENTS.md
│   ├── Architektur/
│   ├── Bugs/
│   ├── Releases/
│   └── ADRs/
│
├── Product/
│   ├── AGENTS.md
│   ├── Roadmap/
│   ├── User-Research/
│   ├── Specs/
│   └── Backlog/
│
└── Support/
    ├── AGENTS.md
    ├── Tickets/
    ├── FAQs/
    └── Eskalationen/
hermes profile create engineering --clone
hermes profile create product --clone
hermes profile create support --clone
hermes --profile engineering config set terminal.cwd "/Users/name/Produkt/Engineering"
hermes --profile product config set terminal.cwd "/Users/name/Produkt/Product"
hermes --profile support config set terminal.cwd "/Users/name/Produkt/Support"
  • Engineering-Agent: Architekturentscheidungen, Release Notes, Bug-Triage, technische Doku.
  • Product-Agent: Roadmap, Anforderungen, User Stories, Research-Synthese.
  • Support-Agent: Ticket-Zusammenfassungen, FAQ-Pflege, Eskalationsmuster, Feedback clustern.
Beispiel 4: Persönlicher Knowledge-Workspace
Mein Vault/
├── Gesundheit/
│   ├── AGENTS.md
│   ├── Termine/
│   ├── Training/
│   └── Ernährung/
│
├── Lernen/
│   ├── AGENTS.md
│   ├── Bücher/
│   ├── Kurse/
│   └── Zusammenfassungen/
│
├── Projekte/
│   ├── AGENTS.md
│   ├── Projekt-A/
│   └── Projekt-B/
│
└── Haushalt/
    ├── AGENTS.md
    ├── Verträge/
    ├── Wartung/
    └── ToDos/
hermes profile create gesundheit --clone
hermes profile create lernen --clone
hermes profile create projekte --clone
hermes profile create haushalt --clone

Jeder Bereich hat eigene Regeln: Gesundheit erfindet keine Diagnosen, Lernen macht Zusammenfassungen/Karteikarten, Projekte trackt Aufgaben/Entscheidungen, Haushalt verwaltet Verträge/Termine.

Beispiel 5: Unternehmen mit Rollen-Agenten
Company OS/
├── CEO/
│   ├── AGENTS.md
│   ├── Strategie/
│   ├── Entscheidungen/
│   └── Board/
│
├── Sales/
│   ├── AGENTS.md
│   ├── Leads/
│   ├── Pipeline/
│   └── Follow-ups/
│
├── HR/
│   ├── AGENTS.md
│   ├── Recruiting/
│   ├── Onboarding/
│   └── Policies/
│
└── Finance/
    ├── AGENTS.md
    ├── Monatsabschluss/
    ├── Rechnungen/
    └── Forecast/
hermes profile create ceo --clone
hermes profile create sales --clone
hermes profile create hr --clone
hermes profile create finance --clone

Gute Skills — Sales: lead-qualifier, crm-followup-writer, pipeline-reviewer. HR: candidate-screening, onboarding-writer, policy-summarizer. Finance: forecast-analyst, invoice-checker, monthly-reporting. CEO: decision-brief, board-update, strategy-review.

Weiter — Empfohlene Ordnerstruktur
09 · Referenz

Empfohlene Ordnerstruktur

Für viele Anwendungsfälle ist diese Struktur gut:

Empfohlene Ordnerstruktur — im Detail aufklappen
Workspace/
├── Bereich-A/
│   ├── AGENTS.md
│   ├── Eingang/
│   ├── Arbeit/
│   ├── Archiv/
│   └── Reports/
│
├── Bereich-B/
│   ├── AGENTS.md
│   ├── Eingang/
│   ├── Arbeit/
│   ├── Archiv/
│   └── Reports/
└── Shared/
    ├── Templates/
    └── Allgemeines Wissen/

Wichtig:

  • Jeder Hauptbereich bekommt ein eigenes AGENTS.md.
  • Jeder Hauptbereich kann ein eigenes Hermes-Profil bekommen.
  • Gemeinsame Vorlagen liegen in Shared/.
  • Der Agent darf Shared/ lesen, aber nur schreiben, wenn es erlaubt ist.
Weiter — Profile vs. Projects
10 · Referenz

Profile vs. Projects

Hermes hat auch Projects. Profile und Projects lösen unterschiedliche Probleme.

Profile vs. Projects — im Detail aufklappen

Ein Profil beantwortet: Wer arbeitet hier? (z. B. finanzen, marketing, kunde-a, support).

Ein Project beantwortet: Welcher Workspace / welches Repo / welcher Ordner gehört zu dieser Arbeit? Projects sind besonders in der Desktop-App hilfreich, weil sie Arbeitsbereiche gruppieren können.

hermes project create "Obsidian Finanzen" "/Users/name/Documents/Obsidian Vault/Finanzen"
KonzeptBedeutung
ProfilRolle / Identität / Memory
ProjectWorkspace / Ordnergruppe
SkillProzess / Methode
AGENTS.mdlokale Regeln

Für Anfänger reicht meistens: 1. Profil anlegen, 2. terminal.cwd setzen, 3. AGENTS.md in den Ordner legen, 4. Skills ergänzen. Projects sind ein zusätzlicher Komfort, besonders in der Desktop-App.

Weiter — Sicherheit
11 · Referenz

Sicherheit: Profile sind keine harte Sandbox

Ein Hermes-Profil ist eine organisatorische Trennung, aber keine perfekte technische Sicherheitsgrenze. Wenn ein Agent File-Tools hat, kann er technisch auch andere Pfade lesen oder bearbeiten, sofern das Betriebssystem es erlaubt.

Sicherheit — im Detail aufklappen

Wenn du wirklich harte Grenzen brauchst, nutze zusätzlich: getrennte Benutzerkonten, Dateisystemrechte, Container, SSH-/Remote-Backend, getrennte Maschinen, eingeschränkte Toolsets.

Für die meisten Wissensarbeits-Setups reicht aber: klares Arbeitsverzeichnis, AGENTS.md, getrennte Profile, keine unnötigen Tools aktivieren.

Weiter — Häufige Fehler
12 · Referenz

Häufige Fehler

Fehler 1: Alles in einen globalen Skill schreiben

Schlecht: Der Skill sagt „Du bist für Finanzen, Marketing und HR zuständig." Besser: Profil finanzen, Profil marketing, Profil hr — je ein Arbeitsverzeichnis, je ein AGENTS.md, spezifische Skills pro Bereich.

Fehler 2: Nur das Profil anlegen, aber kein Arbeitsverzeichnis setzen

Dann weiß Hermes zwar, welches Profil aktiv ist, arbeitet aber vielleicht im falschen Ordner. Besser:

hermes --profile finanzen config set terminal.cwd "/Pfad/zum/Finanzen-Ordner"
Fehler 3: Keine lokalen Regeln hinterlegen

Ohne AGENTS.md kennt der Agent die gewünschte Struktur nicht zuverlässig. Besser: je ein AGENTS.md in Finanzen/, Marketing/, HR/.

Fehler 4: Skills mit Projektregeln überladen

Ein Skill sollte keine komplette Projektstruktur ersetzen. Besser: Ordnerregeln in AGENTS.md, Prozesslogik in Skill.

Fehler 5: Zu viele Profile für Kleinigkeiten

Nicht jeder Unterordner braucht ein eigenes Profil. Ein Profil lohnt sich, wenn es eine eigene Rolle ist, anderes Memory sinnvoll ist, andere Regeln gelten, andere Tools/Skills gebraucht werden oder Themen nicht vermischt werden sollen.

Weiter — Best-Practice-Checkliste
13 · Referenz

Best-Practice-Checkliste

Für jeden neuen Bereich:

Best-Practice-Checkliste — im Detail aufklappen
  1. Bereich definieren — Was ist die Aufgabe dieses Bereichs?
  2. Ordner anlegen — z. B. Obsidian Vault/Finanzen/
  3. AGENTS.md schreiben — Zuständigkeit, Ordnerstruktur, Regeln, Schreib-/Lesebereich, Ausgabe-Stil, No-Gos
  4. Profil erstellenhermes profile create finanzen --clone
  5. Arbeitsverzeichnis setzenhermes --profile finanzen config set terminal.cwd "/Pfad/zum/Finanzen-Ordner"
  6. Skills installieren oder erstellen — z. B. obsidian, finance-controller, monthly-reporting
  7. Testfrage stellen — „Fasse mir die offenen Finanzfragen zusammen und sage, welche Dateien du dafür genutzt hast." Wenn der Agent die richtigen Ordner nutzt, ist das Setup gut.
Weiter — Starter-Template für ein Bereichs-AGENTS.md
14 · Referenz

Starter-Template für ein Bereichs-AGENTS.md

Starter-Template für ein Bereichs-AGENTS.md — im Detail aufklappen
# [Bereich]-Agent

Du arbeitest im Bereich [Bereich].

## Hauptarbeitsbereich

/absoluter/pfad/zum/bereich

## Zuständigkeit

Dieses Profil kümmert sich um:
- ...
- ...

## Ordnerstruktur

- Eingang/ — neue ungeprüfte Informationen
- Arbeit/ — aktive Dokumente und Notizen
- Reports/ — Auswertungen und Zusammenfassungen
- Archiv/ — abgeschlossene Themen

## Regeln

- Arbeite primär innerhalb dieses Ordners.
- Bearbeite keine Dateien außerhalb dieses Ordners, außer der Nutzer fordert es ausdrücklich.
- Nutze vorhandene Daten, bevor du neue Annahmen triffst.
- Markiere Annahmen klar.
- Wenn Informationen fehlen, frage nach oder schreibe sie in Offene Fragen.md.

## Ausgabe-Stil

- Kurz und klar.
- Bei Fakten Quellen nennen.
- Bei Aufgaben konkrete nächste Schritte vorschlagen.

## No-Gos

- Keine Daten erfinden.
- Keine Dateien außerhalb des Bereichs verändern.
- Keine vertraulichen Inhalte in andere Bereiche kopieren.
Weiter — Starter-Template für einen Bereichs-Skill
15 · Referenz

Starter-Template für einen Bereichs-Skill

Starter-Template für einen Bereichs-Skill — im Detail aufklappen
---
name: bereichs-workflow
description: Wiederkehrender Workflow für [Bereich]
---

# Bereichs-Workflow

## When to Use

Nutze diesen Skill, wenn der Nutzer ...

## Procedure

1. Prüfe die relevanten Notizen im aktuellen Arbeitsbereich.
2. Sammle Fakten mit Quellen.
3. Erstelle eine strukturierte Zusammenfassung.
4. Markiere offene Fragen.
5. Schreibe Ergebnisse in den passenden Zielordner.

## Output Format

- Zusammenfassung
- Quellen
- Offene Fragen
- Nächste Schritte

## Pitfalls

- Keine Informationen erfinden.
- Keine Dateien außerhalb des Arbeitsbereichs bearbeiten.
- Keine unklaren Annahmen als Fakten darstellen.
Weiter — Übung 1
◆ 16 · Übung 1

Verzeichnisstruktur planen

Jetzt bist du dran: vier Übungen, die aufeinander aufbauen — erst der Plan, dann die Profile, dann die Regeln, dann die saubere Trennung.

Ziel: Bereiche & Ordner festlegen · Voraussetzung: keine · Dauer: ~10 Min

Bevor du ein einziges Profil anlegst, entscheidest du auf Papier (oder in einer Notiz), welche Bereiche deiner Modellfirma getrennt arbeiten sollen und wie ihre Ordner aussehen. Das ist der Bauplan — alles Spätere hängt daran.

Warum das?

Wer zuerst plant, vermeidet später Chaos: klare Ordner bedeuten klare Zuständigkeiten und Agenten, die sich nicht ins Gehege kommen.

  1. Liste 2–4 Bereiche, die klar getrennt sind (z. B. Finanzen, Marketing).
  2. Skizziere pro Bereich einen Ordner mit sinnvollen Unterordnern (z. B. Reports/, Steuer/, Content/) und einer Offene Fragen.md.
  3. Halte pro Bereich in einem Satz fest, wofür er zuständig ist.
  4. Notiere je Bereich die 3 wichtigsten Regeln — die kommen später in die AGENTS.md.
▶ Optionaler Helfer-Prompt
Ich plane Hermes-Profile für meine Firma. Bereiche: Finanzen, Marketing. Schlag mir je eine sinnvolle Ordnerstruktur mit Unterordnern vor und welche 3 Regeln in die AGENTS.md gehören.
Lösung / Erwartetes Ergebnis
Ein Ordnerbaum wie im „Einsteiger-Beispiel" dieser Seite: Finanzen/ und Marketing/ mit je eigener AGENTS.md und Unterordnern, plus ein gemeinsamer Wissen/-Bereich. Pro Bereich steht klar, wofür er zuständig ist. Stolperfalle: nicht zu fein aufteilen — 2–4 Bereiche reichen zum Start.
Weiter — Übung 2
◆ 17 · Übung 2

Erstes Profil & Arbeitsverzeichnis

Ziel: ein Profil, das im richtigen Ordner startet · Voraussetzung: Übung 1 · Dauer: ~10 Min

Aus dem Plan wird Realität: Du legst ein Profil marketing an und sagst Hermes, wo es zu Hause ist — im Marketing-Ordner.

Warum das?

Ein Profil mit festem Arbeitsverzeichnis startet immer im richtigen Ordner. Datei-Suche und Kontext beziehen sich dann automatisch auf diesen Bereich, ohne dass du es jedes Mal sagen musst.

  1. Profil erstellen (Befehl unten).
  2. Arbeitsverzeichnis setzen: hermes --profile marketing config set terminal.cwd "…/Marketing"
  3. Starten mit hermes --profile marketing und prüfen mit hermes profile list.
hermes profile create marketing --clone
Lösung / Erwartetes Ergebnis
hermes profile list zeigt marketing. Beim Start landet der Agent ohne Umweg im Marketing-Ordner — prüf es mit der Frage „In welchem Ordner arbeitest du gerade?". Stolperfalle: Pfade mit Leerzeichen immer in Anführungszeichen.
Weiter — Übung 3
◆ 18 · Übung 3

Regeln per AGENTS.md

Ziel: klare Spielregeln für das Profil · Voraussetzung: Übung 2 · Dauer: ~15 Min

Ein Profil sagt „wer", das Arbeitsverzeichnis „wo" — die AGENTS.md sagt „nach welchen Regeln". Hier gibst du dem Marketing-Agenten seine Leitplanken.

Warum das?

Ohne Regeln rät der Agent im Zweifel. Mit klaren Grenzen fragt er lieber nach und legt Ergebnisse genau dorthin, wo sie hingehören.

  1. Lege im Marketing-Ordner eine AGENTS.md an — nimm das Starter-Template weiter oben auf dieser Seite als Vorlage.
  2. Passe 5 Regeln an: Hauptarbeitsbereich · „nur hier arbeiten" · „keine Zahlen erfinden" · „Reports nach Reporting/" · „bei Unklarheit nachfragen".
  3. Neue Sitzung starten — Regeln greifen erst nach Neustart.
Lösung / Erwartetes Ergebnis
Gib einen Auftrag mit fehlender Info („Erstell den Monatsreport"). Der Agent fragt nach statt zu raten und legt das Ergebnis im Ordner Reporting/ ab. Stolperfalle: AGENTS.md wird im aktuellen Arbeitsverzeichnis gefunden — das Profil muss im richtigen Ordner starten.
Weiter — Übung 4
◆ 19 · Übung 4

Zwei Profile ohne Vermischung

Ziel: beweisen, dass Bereiche getrennt bleiben · Voraussetzung: Übung 3 · Dauer: ~15 Min

Der Beweis: Du legst ein zweites Profil finanzen mit eigenem Arbeitsverzeichnis und eigener AGENTS.md an und zeigst, dass Marketing und Finanzen sich nicht vermischen.

Warum das?

Getrennte Profile bedeuten getrenntes Gedächtnis, getrennte Skills und getrennte Regeln. Genau das schützt sensible Bereiche wie Finanzen vor versehentlichem Zugriff.

  1. Profil erstellen (Befehl unten) und Arbeitsverzeichnis auf den Finanzen-Ordner setzen.
  2. Eigene AGENTS.md für Finanzen (z. B. „keine Beträge erfinden", „Belege in Steuer/").
  3. Zwischen beiden Profilen wechseln und je eine typische Aufgabe geben.
hermes profile create finanzen --clone
Lösung / Erwartetes Ergebnis
Frag den marketing-Agenten nach einer Finanzzahl — er kennt sie nicht, weil er nur seinen Bereich sieht. Jedes Profil bleibt in seinem Ordner, mit eigenem Gedächtnis und eigenen Regeln. Stolperfalle: nicht alles über Skills lösen wollen — die Trennung kommt aus Profil + Arbeitsverzeichnis + AGENTS.md.
Weiter — Kurzfazit
20 · Referenz

Kurzfazit

Der beste Aufbau ist:

Kurzfazit — im Detail aufklappen
Profil = Wer arbeitet?
Arbeitsverzeichnis = Wo arbeitet er?
AGENTS.md = Welche lokalen Regeln gelten?
Skill = Wie wird eine Aufgabe erledigt?

Für das Beispiel heißt das: Profil finanzen, Arbeitsverzeichnis Obsidian Vault/Finanzen, AGENTS.md mit Finanzregeln, Skills obsidian, finance-controller, monthly-reporting. Und: Profil marketing, Arbeitsverzeichnis Obsidian Vault/Marketing, AGENTS.md mit Marketingregeln, Skills obsidian, marketing-planner, content-calendar.

So steuerst du Hermes Agent sauber über Profile, ohne dass sich Bereiche vermischen.