tjboudreaux/ready-agent-1

Agent Readiness Fix – Behebung der Agent-Reife

Heben Sie die Reife eines Repos an, indem Sie nur sichere Änderungen anwenden. Die Engine plant und schreibt Konfigurationsgerüste; Sie kümmern sich um Git und verfassen jegliche Prosa. Drei Bereiche, drei verschiedene Sicherheitsstufen.

Schritte

1. Stellen Sie sicher, dass ein Bericht existiert. Wenn .agents/readiness/latest.json fehlt, führen Sie zuerst den Skill ra1-report aus.

2. Führen Sie einen Trockenlauf des Plans durch, um zu sehen, was sich ändern würde:

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>
   

   Es werden drei Bereiche ausgegeben: Auto-apply (sichere Konfigurationsgerüste), Propose (Entwürfe zur Überprüfung) und GitHub-Einstellungen (manuell).

3. Erstellen Sie zuerst einen lokalen Branch (arbeiten Sie niemals auf dem Standard-Branch):

   git -C <repo-path> checkout -b readiness/fixes
   

4. Wenden Sie die sicheren Gerüste an (idempotent; verweigert bei schmutzigem Arbeitsverzeichnis; überschreibt niemals nicht-leere Dateien):

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply
   

5. Verfassen Sie die „Propose“-Elemente selbst – README-Abschnitte, eine maßgeschneiderte AGENTS.md, Runbooks, einen ersten Test. Schreiben Sie diese als Entwürfe zur Überprüfung durch den Benutzer; erfinden Sie keine Fakten über die Codebasis. templates/AGENTS.md ist ein Grundgerüst – füllen Sie es mit dem, was das Repo tatsächlich tut.

6. Zeigen Sie den Diff und committen Sie lokal. Fassen Sie die Änderungen zusammen, dann:

   git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"
   

   Beenden Sie die Commit-Nachricht mit dem erforderlichen Co-Authored-By-Trailer.

7. Führen Sie erneut ra1-report aus, um den Level-Unterschied anzuzeigen.

Vertrag (nicht verletzen)

• Nie pushen und nie einen PR ohne explizite Benutzerbestätigung öffnen. Zuerst lokal bauen und committen.
• Nur Konfigurationsgerüste automatisch anwenden. README/AGENTS.md/Tests/Runbooks sind Entwürfe zur Überprüfung durch den Benutzer – automatisches Schreiben von Prosa riskiert „dokumentierte Fiktion“.
• GitHub-Einstellungsänderungen niemals mit Code-Commits bündeln (Branch-Schutz, Secret Scanning, Labels). Präsentieren Sie diese als Checkliste von gh-Befehlen, die der Benutzer ausführen und bestätigen soll.
• Respektieren Sie ein schmutziges Arbeitsverzeichnis: nicht --force über uncommittete Arbeit hinweg ohne Nachfrage.