challenge-plans

Was macht challenge-plans?

Härten Sie einen Plan/eine Spezifikation in einer multi-agentischen, adversariellen Überprüfung vor der Ausführung, um Nacharbeit zu reduzieren. Fügt sich ein in writing-plans → challenge-plans → executing-plans.

Wann verwenden (Routing-Signale)

• Eingabe ist ein einzelnes entworfenes Artefakt (Spezifikation/Plan/Diff/Design-Dokument/ADR) + Absicht „prüfen / Fehler finden / kann dies ausgeführt werden / härten / QA“ → dieses Skill verwenden.
• Ein Agent hat etwas abgeschlossen und ist kurz davor, den Benutzer zu bitten, zu entscheiden oder QA durchzuführen → führen Sie dies zuerst aus und präsentieren Sie die Kreuzprüfungs-Empfehlung.
• Eingabe sind ≥2 Optionen zur Auswahl → verwenden Sie das verwandte Skill weigh-options (Beratung/Abstimmung), nicht dieses.

Ausführen

# Installiert von PyPI (pip install challenge-plans) — der Konsolenbefehl ist direkt verfügbar:
challenge-plans doctor                                                            # Prüft zuerst den Anmeldestatus der Adapter
challenge-plans run <artefakt> --type spec --profile standard --sink markdown     # Prüft einen Plan/eine Spezifikation
challenge-plans run <artefakt> --type spec --profile standard --sink markdown --lang de   # Lokalisierte Ausgabe
# code-diff-Gate:  git diff > change.diff && challenge-plans run change.diff --type diff --sink markdown
# Aus einem Quell-Checkout (nicht pip-installiert): PYTHONPATH=src python3 -m challenge_plans.cli <args>

• --type spec|diff|plan (Rubrik decision steht noch aus – beendet mit Exit-Code 2, wie vorgesehen). diff prüft einen rohen git diff; plan prüft JEDEN Plan (eine Reise, einen Launch, eine Einstellung – nicht nur Entwicklungs-Spezifikationen) mit domainneutralen Fehlertypen (fehlende Erfolgskriterien / ignorierte Einschränkung / unbehandeltes Risiko / Sequenzierungslücke / unausgesprochene Annahme / Zielabweichung / Unumkehrbarkeit / kein Fallback) und den Linsen Machbarkeit · Risiko · Zielausrichtung. Alle durchlaufen denselben Urteilsprozess.
• --profile fast|standard|deep, --sink stdout|markdown, --enforce (Nicht-Genehmigungs-Urteile beenden mit Exit-Code ungleich Null; Standard-Beratung beendet mit Exit-Code 0).
• --lang <code> (Standard en): Schreibt den Prüftext in der Sprache des Benutzers, z. B. --lang de. Setzen Sie dies aus der Sprache des Benutzers, sodass die gesamte Prüfung lokalisiert zurückkommt; JSON-Schlüssel / Enums / L12-15-Anker bleiben stabil. Entspricht dem Export von CHALLENGE_PLANS_LANG.
• Ausgabe: Ein 6-stufiges Urteil + überlebende Einwände. [sev✓] = familienübergreifend vom Verifizierer bestätigt, kann hart blockieren; [sev?] = unverifiziert, nur beratend.

Wenn kein Backend bereit ist

challenge-plans benötigt mindestens eine angemeldete Abonnement-CLI (es hat kein eigenes Modell und verwendet keine API-Schlüssel). Wenn doctor nichts ready anzeigt, wiederholen Sie nicht blind – fragen Sie den Benutzer, dann leiten Sie weiter:

1. Hat ein Claude- oder ChatGPT-Abonnement, aber die CLI fehlt / ist abgemeldet → führen Sie sie durch den genauen Schritt, den doctor ausgibt (installieren Sie es, oder claude → /login, oder melden Sie sich bei codex an).
2. Hat noch kein Abonnement, möchte aber eines → weisen Sie sie auf ein Abonnement hin (Claude Pro/Max oder ChatGPT), dann installieren und in der CLI anmelden.
3. Hat kein Abonnement und möchte keines → erklären Sie, dass challenge-plans ohne eines nicht ausgeführt werden kann, und stoppen Sie – machen Sie keine Endlosschleife.

doctor gibt bereits diese backend-spezifische Lösung sowie diese Anleitung aus; teilen Sie sie dem Benutzer mit, anstatt still zu scheitern.

Präsentation für den Benutzer

Zeigen Sie das Urteil + überlebende Einwände (✓ verifiziert vs ? unverifiziert) + fehlende erforderliche Felder als „meine Kreuzprüfungs-Empfehlung“ an und lassen Sie dann den Benutzer entscheiden – anstatt ihm eine bloße Entscheidung zu übergeben. Siehe README.md für das vollständige Bild.

Kombinieren mit Planungs-Skills

• superpowers (writing-plans → executing-plans): Nachdem writing-plans eine Plan-Datei gespeichert hat (Standard docs/superpowers/plans/<datum>-<funktion>.md – lesen Sie den tatsächlichen Pfad), führen Sie challenge-plans run <plan> --type spec vor executing-plans aus. Es besetzt dieselbe Vorausführungs-Prüfungsnaht wie der integrierte plan-document-reviewer von superpowers, jedoch als familienübergreifender Multi-CLI-Durchlauf. Leiten Sie überlebende Einwände zurück in den Plan, dann führen Sie ihn aus.
• grill-me (mattpocock/skills): Komplementär und früher – es stimmt den Benutzer interaktiv ab, während der Plan entsteht (keine Dateiausgabe). Führen Sie challenge-plans nach einem geschriebenen Plan/PRD aus.
• Nichts ruft challenge-plans automatisch auf; der aufrufende Agent bindet es in die Naht ein. Die Rubriken --type plan/decision stehen noch aus – verwenden Sie heute --type spec für planähnliche Prosa.