Björn RundenandClaude Opus 5.5
7f6b8ebe07
Regeln, Standards, Kontextstruktur und Werkzeuge übernommen; 2nd-brain- Inhalte (Stacks, Ansible-Inventar, Architektur, Knowledge) entfernt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.8 KiB
3.8 KiB
Agenten – Arbeitsweise (projektübergreifend)
Gilt für alle KI-Agenten, agentisch (Claude Code, Codex, Gemini CLI, VSCodium/Continue) wie im Chat.
ai/rules/*.mdhaben Vorrang.
1. Arbeitsweise
- Sitzungsstart gemäß
AGENTS.md. - Erst verstehen, dann bauen: vorhandenen Code, Knowledge-Einträge und Projektstand lesen, bevor etwas Neues entsteht. Bestehendes wiederverwenden.
- Empfehlung statt Optionsliste. Alternativen nur, wenn die Entscheidung wirklich beim Bediener liegt – dann knapp mit Empfehlung.
- Nachfragen, wenn: Ziel/Projekt unklar, Regel berührt (Produktion, Löschen, extern), Verantwortliche für den Header fehlen, Annahmen das Ergebnis wesentlich ändern.
- Selbstständig handeln bei: Formalien, Konventionen aus
common/, offensichtlichen Defaults – im Ergebnis kurz erwähnen. - Keine Erfindungen: Hostnamen, IPs, Versionen, Optionen nur aus Knowledge/Projekt/Quelle. Unsicheres als „unsicher“ markieren.
- Ergebnisse ablegen, nicht nur im Chat: Projektstand →
context.md; Dauerhaftes → Knowledge-DB.
2. Qualitätsmaßstab („nah am Optimum“)
Vor Abgabe von Code/Doku/Architektur selbst prüfen:
- Passender Standard aus
common/eingehalten, Vorlage auscommon/templates/genutzt - Header mit Verantwortlichen (
rules/headers.md), Funktionen mit Kurz-Doku - Keine Geheimnisse, keine internen Daten in Beispielen für Externe
- Lokal getestet (Syntax, Lint, Trockenlauf) – oder ausdrücklich gesagt, was nicht getestet wurde
- Doku/Knowledge aktualisiert,
bin/kb_index.shgelaufen - Einfachste Lösung, die das Ziel erfüllt – keine Vorratsfunktionen
3. Formales
- Sprache, Datum:
rules/language.md. - Markdown:
common/markdown.md. - Commit-Messages (falls Git): Amtssprache, Imperativ, erste Zeile ≤ 72 Zeichen, Bezug zum Bereich (
ai/rules: Regel Prüfungsfragen ergänzt).
4. Standards (Verweise)
| Thema | Datei |
|---|---|
| Bash-Scripts | bash.md |
| Ansible | ansible.md |
| Docker-Compose | docker.md |
| Coding allgemein, Python | coding.md |
| Markdown, Knowledge-Einträge | markdown.md |
| Architektur-Doku, Entscheidungen (ADR) | architecture.md |
5. AI-Basis verbessern
Agenten sollen die Basis besser machen, wenn sie bei der Arbeit Lücken, Widersprüche oder wiederkehrende Muster bemerken.
| Was | Wie |
|---|---|
Regel fehlt/ist unklar (rules/) |
Nicht selbst ändern. Vorschlag im Chat + Eintrag „Offene Fragen“ in context.md |
Standard verbessern (common/) |
Ändern, wenn klar besser und rückwärtskompatibel; Eintrag im Änderungsprotokoll der Datei (unten, TT.MM.JJJJ – was – warum). Größeres vorher vorschlagen |
Vorlage/Script (common/templates/, bin/) |
Ändern + lokal testen + @version erhöhen; _functions.sh in bin/ und templates/bash/ synchron halten |
| Kontext/Knowledge | Jederzeit ergänzen/korrigieren, mit updated und Quelle |
| Wiederkehrende Frage des Bedieners | Antwort als Knowledge-Eintrag (howto/) ablegen |
Verbesserungen, die allgemein gelten (nicht nur für dieses Projekt), dem Bediener zur Übernahme ins Skeleton (~/skel-ai) vorschlagen.
6. Rollen der Agenten
| Agent | Einsatz | Grenzen |
|---|---|---|
| Claude Code | agentisches Coding, Doku | Datenklasse laut rules/privacy.md |
| Chat-Dialog | Konzepte, Reviews | kein Dateizugriff → relevante Dateien einfügen lassen |
Chat-Dialog ohne Dateizugriff: Der Bediener fügt AGENTS.md, die betroffenen rules/, den passenden Standard und context.md ein. Der Agent liefert vollständige Dateien bzw. Diffs und am Ende einen Block „Für context.md“ zum Einpflegen.
Änderungsprotokoll
- 07.10.2026 – angelegt (aus skel-ai).
- 23.10.2026 – auf Einzelprojekt reduziert (
context.mdim Root, Rollen festgelegt).