GanyuanRan/Aegis

Was macht Aegis?

Macht KI-Codierungsagenten architekturbewusst: Baseline-zuerst, evidenzgeprüft, Drift-geprüft und sicher über lange Aufgaben hinweg.

Übersicht

Aegis stellt sicher, dass KI-Agenten die Architektur eines Projekts verstehen und respektieren. Es erfasst die Baseline (die beabsichtigte Architektur), prüft Änderungen gegen eine generierte erwartete Architektur, erkennt Architekturdrift und blockiert Mutationen, die den Agenten selbst oder kritische Projektartefakte betreffen. So bleiben Agenten über lange, komplexe Aufgaben hinweg konsistent und sicher.

Installation

1. Lege einen neuen Skill mit dem Namen GanyuanRan/Aegis in den Einstellungen deines Agenten an.
2. Kopiere den folgenden Skill-Markdown-Code in das Feld für den Skill-Inhalt:
   • https://raw.githubusercontent.com/GanyuanRan/Aegis/main/SKILL.md
3. Speichere den Skill.

Funktionsweise

Aegis implementiert einen Arbeitsablauf mit drei Hauptschritten:

1. Baseline erfassen: Der Agent extrahiert zu Beginn einer Aufgabe die beabsichtigte Architektur aus der Codebasis und speichert sie.
2. Erwartete Architektur generieren: Vor jeder Änderung (Editieren, Testen, Committen) generiert der Agent die erwartete Architektur auf Basis der aktuellen Änderungen.
3. Drift prüfen: Der Agent vergleicht die tatsächliche Architektur (nach Änderungen) mit der erwarteten Architektur. Weicht sie ab (Drift), wird der Vorgang abgebrochen.

Zusätzlich:

• Safe Mutations: Der Agent blockiert Mutationen an sich selbst (z. B. Änderungen an Aegis), an Kompilierungsergebnissen und anderen kritischen Ressourcen.
• Architecture Registry: Architekturzusammenfassungen werden in einer globalen Registry (~/.aegis/registry.json) verwaltet, die eine konsistente Zusammenarbeit über verschiedene persistente Sessions hinweg ermöglicht.

Plattformen

Aegis ist für KI-Agenten wie Claude Code, Cursor, Codex und andere konzipiert.

Beitragen

Siehe CONTRIBUTING.md für Richtlinien.

Lizenz

Projekt-Lizenz: MIT

Häufige Fehler

• Mutation von Aegis selbst: Wenn der Agent Änderungen an seiner eigenen Definition vornimmt, kann dies zu Instabilität führen. Aegis blockiert dies standardmäßig.
• Fehlende Architekturprüfung vor Commit: Wenn der Drift-Check vor dem Commit übersprungen wird, kann inkonsistenter Code eingecheckt werden.
• Manuelle Bearbeitung der Registry: Die Registry sollte nur vom Agenten über die vorgesehenen Befehle aktualisiert werden.

Nächste Schritte

1. Installiere den Skill in deinem Agenten.
2. Starte eine neue Session und führe eine komplexe Aufgabe aus.
3. Überwache die Drift-Prüfungen und die Registry-Integration.