Agent.md Struktur¶

Agent.md-Dateien definieren spezialisierte Sub-Agent-Typen für Claude Code – wiederverwendbare Agenten mit festen Rollen, Tools und Verhaltensweisen.

Was ist Agent.md?¶

Während SKILL.md einen Workflow für den Haupt-Agenten definiert, definiert Agent.md einen spezialisierten Unter-Agenten:

CLAUDE.md          → Kontext für den Haupt-Agenten
SKILL.md           → Workflow den der Haupt-Agent ausführt
Agent.md           → Typ/Rolle für einen Sub-Agenten

Ein Agent aus Agent.md wird mit dem Agent-Tool gespawnt und läuft in einem eigenen Kontext.

Speicherort¶

~/.claude/agents/
└── my-agent/
    └── Agent.md          # Hauptdatei (erforderlich)

# Oder projektlokal:
./.claude/agents/
└── my-agent/
    └── Agent.md

Aufbau¶

YAML Frontmatter¶

---
name: security-reviewer
description: Spezialisierter Agent für Security-Reviews.
  Wird genutzt wenn Code auf Vulnerabilities geprüft werden soll.
model: claude-haiku-4-5-20251001    # Optional: spezifisches Model
allowed-tools:                       # Optional: Tool-Beschränkung
  - Read
  - Glob
  - Grep
---

Markdown-Body¶

Der Body beschreibt: - Die Rolle des Agenten - Wie er Aufgaben angehen soll - Was er zurückliefern soll

# Security Reviewer

Du bist ein spezialisierter Security-Review-Agent.

## Deine Aufgabe

Prüfe Code auf:
- OWASP Top 10 Vulnerabilities
- Hardcoded Secrets und Credentials
- Unsichere Deserialisierung
- SQL/Command Injection
- Fehlende Input-Validierung

## Vorgehen

1. Lies alle angegebenen Dateien
2. Suche nach bekannten Vulnerability-Patterns
3. Prüfe Dependencies auf bekannte CVEs

## Output-Format

Strukturierter Report:

### Kritisch (sofort fixen)
- [Finding] in [Datei:Zeile]
- Risiko: [Beschreibung]
- Fix: [Empfehlung]

### Warnung (bald fixen)
[...]

### Info
[...]

Frontmatter-Felder¶

Feld	Pflicht	Beschreibung
`name`	✅	Agent-Bezeichner, wird beim Spawnen referenziert
`description`	✅	Wann dieser Agent-Typ genutzt werden soll
`model`	❌	Überschreibt das Default-Model für diesen Agenten
`allowed-tools`	❌	Whitelist der verfügbaren Tools

Agent spawnen¶

Im Haupt-Agenten:

Nutze den security-reviewer Agent um src/auth/ zu prüfen.

Oder explizit im Prompt:

Spawn a security-reviewer agent to analyze src/api/users.ts

Beispiele¶

Code-Review Agent (Haiku, read-only)¶

---
name: code-reviewer
description: Führt Code-Reviews durch. Read-only, macht keine Änderungen.
model: claude-haiku-4-5-20251001
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Code Reviewer

Du reviewst Code und gibst Feedback – du änderst nichts.

## Review-Kriterien

- Korrektheit: Macht der Code was er soll?
- Lesbarkeit: Ist er verständlich?
- Performance: Gibt es offensichtliche Bottlenecks?
- Tests: Sind kritische Pfade gedeckt?

## Output

Strukturiertes Feedback mit Zeilen-Referenzen:

**[Datei:Zeile]** - [Kategorie]: [Beschreibung]

Dokumentations-Generator¶

---
name: doc-generator
description: Generiert technische Dokumentation aus Code.
model: claude-haiku-4-5-20251001
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
---

# Dokumentations-Generator

Generiere Dokumentation aus dem gegebenen Code.

## Format

- Markdown
- Deutsch
- Jede Public-Funktion/Klasse dokumentieren
- Beispiele wo sinnvoll

## Output-Struktur

1. Übersicht (was macht das Modul?)
2. Installation/Setup
3. API-Referenz
4. Beispiele

Ansible Playbook Reviewer¶

---
name: ansible-reviewer
description: Prüft Ansible Playbooks auf Best Practices und potenzielle Probleme.
model: claude-haiku-4-5-20251001
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Ansible Playbook Reviewer

Prüfe Ansible Playbooks auf:

## Checkliste

- [ ] Idempotenz: Tasks wiederholt ausführbar?
- [ ] Tags: Logische Blöcke getaggt?
- [ ] Vault: Keine Klartext-Credentials?
- [ ] Handlers: Unnötige Restarts vermieden?
- [ ] `become`: Nur wo wirklich nötig?
- [ ] Check Mode: `--check` funktionsfähig?

## Output

Findings mit konkreten Fixes.

Agent.md vs SKILL.md¶

Aspekt	Agent.md	SKILL.md
Läuft	Als Sub-Agent (eigener Kontext)	Im Haupt-Agenten
Tool-Zugriff	Eingeschränkt durch `allowed-tools`	Alle Tools des Haupt-Agenten
Model	Kann eigenes Model haben (Haiku)	Haupt-Model
Kontext	Isoliert, eigener Context-Window	Gemeinsamer Kontext
Gut für	Parallele, spezialisierte Aufgaben	Sequenzielle Workflows

Template zum Kopieren¶

---
name: [agent-name]
description: [Wann wird dieser Agent genutzt? Ein Satz.]
model: claude-haiku-4-5-20251001
allowed-tools:
  - Read
  - Glob
  - Grep
---

# [Agent Name]

[Ein Satz: Was ist die Rolle dieses Agenten?]

## Aufgabe

[Was soll der Agent tun?]

## Vorgehen

1. [Schritt 1]
2. [Schritt 2]
3. [Schritt 3]

## Output-Format

[Wie soll das Ergebnis aussehen?]