Zum Hauptinhalt springen

Meta-Agenten /meta

Hinweis

Diese Definitionen gehören in das ai-agents Repository (github.com/tobi936/ai-agents) unter /meta. Sie liegen hier temporär, bis das Git-Submodule .claude/agents/ aktiv ist. Dann nach .claude/agents/meta/ verschieben und hier löschen.

Dieses Verzeichnis enthält Agenten, die andere Agenten verbessern — sogenannte Meta-Agenten.

Verzeichnisstruktur​

.claude/agents/
├── orchestrator.md        ← Kern-Prompts (schreibgeschützt für Agenten)
├── coder.md
├── architect.md
├── ...
└── meta/                  ← Dieses Verzeichnis
    ├── README.md          ← Diese Datei
    ├── meta-orchestrator.md   ← Koordiniert Meta-Agent-Aktivitäten
    └── prompt-reviewer.md     ← Bewertet und verbessert einzelne Prompts

Sicherheitsmodell​

Meta-Agent schlägt Verbesserung vor
            ↓
    Öffnet Pull Request
    (NIE direkter Commit auf main)
            ↓
    GitHub Actions erkennt Änderung
    an .claude/agents/*.md
            ↓
    meta-agent-review.yml blockiert
    bis zur manuellen Freigabe
            ↓
    Mensch reviewed und approvet/rejectet

Kritisches Risiko: Halluzinations-Loop​

Ein Meta-Agent könnte eine Verschlechterung als Verbesserung tarnen. Darum gilt:

  1. Kein direkter Commit auf main oder den Agenten-Branch — immer PR
  2. Pflicht-Label meta-agent-proposal auf jedem Meta-Agent-PR
  3. Manueller Review über GitHub Environment-Protection (Pflicht-Reviewer)
  4. Versionierung: Alle Kern-Prompt-Änderungen werden in VERSIONS.md festgehalten

Meta-Agenten aktivieren​

Meta-Agenten laufen nicht im regulären ai-agent-loop.yml. Sie werden manuell oder via separatem Workflow gestartet:

# Lokal (Analyse ohne Commit)
claude --print --agent .claude/agents/meta/prompt-reviewer.md \
  "Analysiere .claude/agents/coder.md und erstelle einen Review-Report."

# Via GitHub Actions (manueller Dispatch)
# → Actions > Meta-Agent Review Gate > Run workflow

Einrichtung in GitHub​

  1. Environment anlegen: Settings > Environments > meta-agent-review
  2. Required reviewers hinzufügen (dein GitHub-Username)
  3. Label anlegen: Issues > Labels > meta-agent-proposal (Farbe: orange)
  4. Label anlegen: Issues > Labels > ai-run (Farbe: blau) — für den Haupt-Workflow