ECdison6227/project-guardian-cheap-code-delegate

Project Guardian

Verwende diese Fähigkeit an Projektgrenzen:

• Beim Starten eines Projekts.
• Nach Kontextverlust oder in einem neuen Thread.
• Vor größeren Änderungen.
• Nach Dateimodifikationen.
• Nachdem ein günstiger Worker einen Patch erstellt hat.
• Beim Beenden einer Arbeitssitzung.
• Mehr als 30 Minuten nach dem letzten Gedächtnis-Checkpoint.

Kernaufgaben

• Projekterinnerung in .ai/memory/ pflegen.
• Maschinenlesbaren Zustand in .ai/state.json pflegen.
• Git-Disziplin durchsetzen: initialisieren, stagen und committen automatisch. Erwähne Git nicht nur, sondern führe es aus.
• Branch-Sicherheit bewahren.
• Geänderte Dateien zusammenfassen.
• Niemals automatisch pushen, zurücksetzen, bereinigen, deployen oder destruktive Befehle ausführen.

Starten oder Fortsetzen

1. Prüfen, ob .ai/state.json existiert.
2. .ai/memory/-Dateien lesen, falls vorhanden.
3. git status --short --branch prüfen.
4. Wenn kein Git-Repo, git init automatisch ausführen.
5. Wenn auf main oder master, dem Benutzer einen ai/<task>-Branch vorschlagen, aber nicht ohne Bestätigung erstellen.
6. Vor neuen Arbeiten eine prägnante Zusammenfassung zur Wiederaufnahme erstellen.

Hilfsprogramm:

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh resume

Gedächtnis initialisieren

Verwende das Hilfsprogramm, wenn ein Projekt kein Gedächtnis hat:

$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh init --task "..."

Das Hilfsprogramm erstellt:

• .ai/state.json
• .ai/memory/PROJECT_MEMORY.md
• .ai/memory/SESSION_LOG.md
• .ai/memory/CHECKPOINTS.md
• .ai/memory/DECISIONS.md
• .ai/memory/TODO.md
• .ai/memory/PAPER_CONTEXT.md

Es führt auch git init aus, falls das Verzeichnis noch kein Git-Repository ist.

Nach Änderungen

1. Git-Status und eine Diff-Zusammenfassung ausführen.
2. Geänderte Dateien zusammenfassen.
3. Falls sinnvoll, cheap-code-delegate für einen kostengünstigen Checkpoint-Entwurf verwenden.
4. Einen Gedächtnis-Checkpoint automatisch schreiben.
5. git add -A und git commit -m "checkpoint: <summary>" automatisch ausführen.
6. Nicht pushen, es sei denn, der Benutzer fordert es ausdrücklich an oder du übergibst --push.

Hilfsprogramm:

# Auto-commit lokal
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..."

# Auto-commit und pushen (erfordert explizite Absicht)
$HOME/.agents/skills/project-guardian/scripts/project_guardian.sh checkpoint --summary "..." --push

Papier-Projekte

Wenn es sich um ein Papier oder eine Thesis handelt:

• .ai/memory/PAPER_CONTEXT.md pflegen.
• Zusammenfassung, Einleitung, verwandte Arbeiten, Methode, Experimente, Einschränkungen, Fazit, Referenzen, Abbildungen, Tabellen und Gleichungen nachverfolgen.
• Nach Änderungen den Benutzer daran erinnern, die Querschnittskonsistenz, Zitate und Nummerierung zu überprüfen.

Automatische Aktionen

Automatisch ausführen:

• git init, wenn das Verzeichnis kein Git-Repository ist.
• git add -A beim Checkpointen.
• git commit beim Checkpointen.
• Schreiben von .ai/memory-Checkpoints.

Explizite Benutzerbestätigung erforderlich

Nicht automatisch ausführen:

• git push
• git reset
• git clean
• destruktives Checkout
• rm -rf
• Deployment
• Produktionsbefehle
• Erstellen von Branches außer dem automatisch vorgeschlagenen ai/<task>-Branch

Referenzen

Diese nur bei Bedarf laden:

• references/memory-schema.md: .ai/-Dateiverantwortlichkeiten.
• references/git-safety.md: sicherer Git-Workflow.
• references/paper-projects.md: Gedächtnisanleitung für Papiere.