# Projektanweisungen für Agenten

## Geltungsbereich

Diese Datei gilt für das gesamte Projekt. Untergeordnete `AGENTS.md`- oder
`agents.md`-Dateien dürfen für ihren Verzeichnisbereich ergänzende Regeln
festlegen.

## Projektziel

Dieses Projekt enthält neben seiner eigentlichen Implementierung eine
persistente, agentengepflegte Wissensdatenbank. Sie soll Wissen aus kuratierten
Quellen einmalig aufbereiten, fortlaufend verdichten und für spätere Aufgaben
wiederverwendbar machen.

## Verbindliche Wiki-Anweisungen

Vor jeder Arbeit an oder mit der Wissensdatenbank MUSS der Agent
[`wiki.md`](./wiki.md) vollständig lesen und befolgen. Das betrifft insbesondere:

- das Aufnehmen neuer Quellen,
- das Erstellen, Ändern, Verschieben oder Löschen von Wiki-Seiten,
- Fragen, deren Antwort aus dem Wiki abgeleitet wird,
- das Ablegen neuer Analysen oder Synthesen,
- Qualitäts-, Konsistenz- und Aktualitätsprüfungen.

`wiki.md` ist die maßgebliche Spezifikation für Struktur, Metadaten,
Provenienz, Verlinkung, Arbeitsabläufe und Qualitätsanforderungen des Wikis.
Bei einem Widerspruch zwischen allgemeinen Projektgewohnheiten und `wiki.md`
hat `wiki.md` für Wiki-Arbeit Vorrang. Direkte Anweisungen des Benutzers haben
weiterhin Vorrang vor beiden Dateien.

## Entscheidungen dauerhaft festhalten

Wenn der Benutzer im Verlauf der Arbeit eine Entscheidung trifft oder eine
bestehende Entscheidung korrigiert, MUSS der Agent sie ohne zusätzlichen
Speicherauftrag dauerhaft festhalten:

- Fachliche, technische, organisatorische und sonstige projektbezogene
  Entscheidungen werden unter `sources/decisions/` im höchsten benötigten
  Detailgrad verwaltet und gemäß `wiki.md` in den Wissensbestand integriert.
- Der Agent darf ausschließlich in diesem Quellenbereich Dateien anlegen,
  ändern oder löschen und protokolliert jede Entscheidung, Änderung oder
  Rücknahme knapp in `sources/decisions/log.md`. Dieses Log bleibt abgesehen
  von sachlichen Korrekturen append-only.
- Entscheidungen über die allgemeine Arbeitsweise des Agenten werden in dieser
  Datei festgehalten.
- Entscheidungen über Aufbau, Format, Pflege oder Arbeitsabläufe der
  Wissensdatenbank werden in `wiki.md` festgehalten.

Eine Korrektur ersetzt die bisher gültige Regel oder Entscheidung an ihrer
maßgeblichen Stelle. Soweit für das Verständnis relevant, bleibt erkennbar,
welche frühere Entscheidung dadurch abgelöst wurde. Der Agent erfasst nur klar
getroffene Entscheidungen als verbindlich; Fragen, Vorschläge,
Gedankenexperimente und noch offene Optionen werden nicht als beschlossene
Entscheidungen ausgegeben.

## Werkzeuge und Installationen

Der Agent darf ohne zusätzliche Rückfrage benötigte Codex-Skills und
CLI-Werkzeuge installieren oder aktualisieren, wenn dies für die aktuelle
Aufgabe sinnvoll ist.

Vor einer Installation prüfen, ob das Werkzeug bereits in geeigneter Version
vorhanden ist. Nur vertrauenswürdige Bezugsquellen verwenden, unnötige
systemweite Änderungen und sachfremde Upgrades vermeiden und das installierte
Werkzeug anschließend durch einen passenden Aufruf verifizieren. Relevante
Installationen im Arbeitsergebnis knapp benennen.

## Arbeitsgrundsätze

- Bestehende Projektdateien und Änderungen des Benutzers bewahren. Nur Dateien
  ändern, die für die aktuelle Aufgabe erforderlich sind.
- Gewöhnliche Quellen nur im Rahmen einer ausdrücklich beauftragten
  Quellenbereinigung löschen und nur, wenn ihr vollständiger relevanter
  Informationsgehalt durch verbleibende Quellen abgedeckt ist. Quelleninhalte
  nicht umschreiben.
- Vor Änderungen den relevanten Bestand lesen und vorhandene Konventionen
  fortführen.
- Quellen und daraus abgeleitetes Wissen klar voneinander trennen.
- Behauptungen nicht erfinden. Unsicherheit, Widersprüche und fehlende Belege
  sichtbar machen.
- Änderungen in kleinen, nachvollziehbaren Einheiten durchführen und mit
  angemessenen Prüfungen verifizieren.
- Keine externen Systeme verändern, keine Nachrichten versenden und keine
  neuen Quellen beschaffen, sofern dies nicht beauftragt oder für die Aufgabe
  ausdrücklich erlaubt wurde.