CommunityRecherche & Datenanalysegithub.com

pax-k/build-right

Agent-unabhängige Fähigkeiten, die eine vage App-Idee in evidenzgestützte KI-Ausführung verwandeln.

Was ist build-right?

Diese Fähigkeit wandelt vage Produktideen in eine präzise, evidenzgestützte Ausführung um, die von KI-Agenten wie Claude Code, Cursor oder Codex genutzt werden kann. Sie stellt sicher, dass nach der Vorarbeit (Definition des Produktumfangs, MVP-Scope, Betriebsregeln und Aufgabenliste) jeder einzelne Schritt streng nach einem reproduzierbaren Zyklus abläuft: Eine Aufgabe ausführen, den aktuellen Zustand überprüfen, kleine Änderungen vornehmen, mit der richtigen Evidenz verifizieren und den Tracker aktualisieren. Die Fähigkeit enthält vordefinierte Entscheidungspunkte (Gates), die den Agenten dazu zwingen, vor dem nächsten Schritt eine Entscheidung zu treffen – beispielsweise ob Input vom Gründer nötig ist oder ob der nächste Schritt überhaupt KI-eigen und bereit ist. Sie ist plattformunabhängig und funktioniert mit jedem Tool, das SKILL.md-Dateien unterstützt. Sie enthält Skripte zur Zustandsauflösung (State Resolver) und Ausführungsprüfung (Execution Check), die den Agenten leiten, aber nicht blind befolgt werden müssen – die Ausgabe dient als Input für das Urteilsvermögen des Agenten. Am Ende jeder Antwort wird ein Status-Badge gesetzt, der den Fortschritt visualisiert (z. B. DONE, NEEDS INPUT, BLOCKED).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add pax-k/build-right

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Build Right Execution

Verwenden Sie diese Fähigkeit, nachdem die Vorarbeit Produktwahrheit, MVP-Umfang, Betriebsregeln und eine ausführbare Aufgabenliste erzeugt hat.

Grundregel:

Führe eine Aufgabe aus.
Beweise den aktuellen Zustand.
Ändere eng begrenzt.
Verifiziere mit der richtigen Evidenz.
Aktualisiere den Tracker.
Dann gehe zur nächsten Aufgabe über.

Erforderliche Lektüre

  • Lesen Sie immer references/workflow.md, bevor Sie handeln.
  • Lesen Sie references/gates.md vor der Aufgabenauswahl, nach der Aufgabenaufnahme und bevor Sie zu einer anderen Aufgabe übergehen.
  • Lesen Sie references/review-and-delegation.md nur, wenn Review-Trigger zutreffen, Subagent-Review nützlich ist oder breite Evidenz-/Tracker-Änderungen betroffen sind.
  • Lesen Sie references/evidence-contract.md, bevor Sie eine Aufgabe abschließen oder aktualisieren.
  • Lesen Sie ../build-right-engineering-principles/references/principles.md vor der Implementierung oder Überprüfung, wenn eine Aufgabe Architekturgrenzen, öffentliche APIs, Paketeigentum, Provider-Adapter, generierten Code, Fehlersemantik, Tests, Observability, Sicherheit oder durchsetzbare Richtlinien berührt.
  • Verwenden Sie assets/templates/task-template.md, wenn Sie eine fehlende Aufgabe erstellen oder eine zu breite Aufgabe aufteilen.
  • Verwenden Sie gebündelte Hilfsskripte nur in der vollständigen Bun-Befehlsform, wie unten gezeigt. Verlassen Sie sich nicht auf PATH-Alias oder rufen Sie Kurznamen wie continue-check als Shell-Befehle auf.
  • Verwenden Sie den State Resolver, bevor Sie eine Aufgabe auswählen oder durch eine Warteschlange vorrücken. Melden und gleichen Sie seine Entscheidung ab, bevor Sie fortfahren.
  • Verwenden Sie den Execution Helper für deterministische Aufgaben-, Vertrags- und Gate-Signale. Behandeln Sie die Skriptausgabe als Eingabe für Ihr Urteilsvermögen, nicht als Autorität.

Betriebsmodus

  1. Führen Sie den schreibgeschützten State Resolver aus, wenn verfügbar:

    bun <skill-path>/scripts/continue-check.ts --cwd <project> --format markdown --strict
    
  2. Melden Sie die Ergebnisse des Resolvers, bevor Sie Arbeit auswählen:

    Resolver-Entscheidung: <decision>
    Konfidenz: <confidence>
    Nächste Aktion: <next action>
    Nächste Aufgabe: <task or none>
    Blockierende Gates: <gates or none>
    Externe Folgeaktionen: <follow-ups or none>
    
  3. Befolgen Sie die Entscheidung des Resolvers, bevor Sie Arbeit auswählen:

    • ask-founder: Fragen Sie nach oder melden Sie das gründereigene Gate; fahren Sie nicht fort.
    • wait-external: Melden Sie das externe Zustandsgate; fahren Sie nicht fort.
    • create-blocker: Erstellen oder vorschlagen Sie den kleinsten KI-eigenen Blocker.
    • no-ready-task: Stoppen Sie und melden Sie, dass keine KI-eigene Aufgabe bereit ist.
    • invalid-state: Stoppen Sie und gleichen Sie widersprüchliche Tracker-/Gate-Zustände ab.
    • continue-active-task oder execute-task: Wählen Sie genau diese Aufgabe aus.
  4. Führen Sie den schreibgeschützten Execution Helper aus, wenn verfügbar:

    bun <skill-path>/scripts/execution-check.ts --cwd <project> --mode next-task --format markdown
    
  5. Lesen Sie Aufgaben-, Sprint/Meilenstein-Tracker, Autoritätsdokumente und lokale Agentenanweisungen.

  6. Geben Sie die Aufgabenaufnahme aus:

    Aktive Aufgabe: <task id or path>
    Erledigt bedeutet: <observable completion criteria>
    Nicht-Ziele: <explicit exclusions>
    Annahmegrundlage: <founder-claimed | ai-inferred | prototype-assumption | repo-evidence-backed | public-evidence-backed | customer-evidence-backed>
    Umkehrbarkeit: <easy | moderate | hard>
    Lernhaken: <how this task will produce evidence>
    Quelle unter Test: <repo-local path | installed path | GitHub source | release tag | n/a>
    Basisevidenz: <artifact or command>
    Verifikationsleiter: <focused -> broader checks>
    Evidenzziel: <task file or evidence file>
    
  7. Führen Sie den Execution Helper im Modus task-contract oder all aus, wenn ein Aufgabenpfad existiert, und gleichen Sie dann alle fehlenden Felder vor der Bearbeitung ab.

  8. Überprüfen Sie den aktuellen Workspace-Zustand vor der Bearbeitung.

  9. Erfassen Sie die Basisevidenz.

  10. Implementieren Sie die kleinste Änderung, die die Aufgabe erfüllt.

  11. Verifizieren Sie in Schichten.

  12. Führen Sie ein Subagent-Review durch, wenn ein erforderlicher Review-Trigger zutrifft und Subagent-Werkzeuge verfügbar sind. Wenn nicht verfügbar oder verboten, dokumentieren Sie das übersprungene Review und ersetzen Sie die Verifikation durch eine Alternative vor dem Abschluss.

  13. Dokumentieren Sie Evidenz, bevor Sie die Aufgabe als abgeschlossen markieren.

  14. Aktualisieren Sie nur den relevanten Tracker/die relevanten Dokumente.

  15. Führen Sie den vollständigen Bun State Resolver-Befehl und den Execution Helper im Modus stop-gates aus, bevor Sie eine andere Aufgabe auswählen.

  16. Melden Sie die Ergebnisse des Resolvers erneut, bevor Sie entscheiden, ob eine andere Aufgabe sicher ausgewählt werden kann.

  17. Halten Sie an jedem Gründer-, Externer-Zustand-, Fehlgeschlagene-Verifikation-, Veraltete-Aufgabe-, Quellkonflikt-, Offener-Konflikt-, Nicht-KI-Eigentümer- oder Freigabe-Anspruch-Gate an. Fahren Sie erst mit der nächsten Aufgabe fort, wenn das Gate aufgelöst oder explizit in eine bereite KI-eigene Aufgabe umgewandelt wurde.

  18. Führen Sie gemäß dem Projekt-Workflow einen Commit durch oder übergeben Sie.

Nicht-Bereit-Regel

Wenn Autoritätsdokumente, MVP-Umfang, Ausführungsregeln oder Aufgabendateien fehlen, tun Sie nicht so, als ob die Ausführung bereit wäre. Leiten Sie den Benutzer zu /build-right-preflight weiter oder erstellen Sie den kleinsten Sprint-0-Blocker, der erforderlich ist, um die fehlende Ausführungsoberfläche zu etablieren.

Prototyp-Aufgaben dürfen nur von prototype-assumption ausgeführt werden, wenn Umkehrbarkeit, Lernhaken und die vor der Produktwahrheit erforderliche Validierung explizit sind.

Bei Fähigkeitsveröffentlichungen/manuellen Tests dokumentieren Sie die genaue Quelle unter Test. Wenn die installierte oder aufgerufene Fähigkeit im Vergleich zur Repo-lokalen Fähigkeitsquelle veraltet ist, markieren Sie den Test als partial-needs-rerun und verschieben Sie Freigabe-Gates nicht auf "bereit".

Umfangsregel

Erweitern Sie den Umfang nicht stillschweigend. Wenn die Aufgabe nicht zusammenhängende Arbeit offenbart, erstellen Sie ein Folge-Issue und fahren Sie nur innerhalb der Grenzen der ausgewählten Aufgabe fort.

Stop/Frag-Gate

Überprüfen Sie nach jeder Aufgabe, ob der nächste Schritt wirklich KI-eigen und bereit ist. Halten Sie an und fragen Sie nach oder melden Sie den Blocker, wenn der nächste Schritt erfordert:

  • gründereigene Produkt-, Positionierungs-, Käufer-/Benutzer- oder MVP-Entscheidungen
  • bereite oder aktive Aufgabenverantwortung, die nicht KI ist
  • offene Konflikte in docs/conflicts.md
  • externe Entdeckung, Suchindexierung, Veröffentlichung, Geheimnisse, kostenpflichtige Dienste oder Produktionszugang
  • fehlgeschlagene Verifikation, veralteten Aufgabenstatus, Quellkonflikt oder mehrdeutige Evidenz
  • erforderliches Subagent-Review, das ohne gleichwertigen Ersatz übersprungen wurde

Das Fortfahren durch eine vorbereitete Warteschlange ist nur erlaubt, solange jeder nächste Schritt bereit, KI-eigen, evidenzgestützt und nicht durch eines dieser Gates blockiert ist.

Sichtbarer Status-Badge für Benutzer

Beenden Sie jede letzte Antwort mit genau einem Status-Badge-Block:

✅ [DONE] Status: DONE
Entscheidung: <decision/result>
Nächste Aktion: <next action or none>
Benutzereingabe erforderlich: <none | concise ask>
Blockiert durch: <none | blocker>

Verwenden Sie diese Statuszuordnung:

  • ✅ [DONE] Status: DONE für eine abgeschlossene Aufgabe mit Evidenz, Verifikation und Tracker-Updates.
  • 🟢 [GREEN] Status: ALL GREEN für execute-task oder continue-active-task vor Beginn der Implementierung.
  • 🟡 [YELLOW] Status: NEEDS INPUT für ask-founder.
  • 🟠 [ORANGE] Status: NEEDS WORK für KI-eigene Folgearbeit, die noch keine bereite Ausführungsaufgabe ist.
  • 🔵 [BLUE] Status: WAITING EXTERNAL für wait-external, Veröffentlichung, Indizierung, Anmeldedaten, kostenpflichtige Dienste, Produktionszugang oder Drittanbieterstatus.
  • 🔴 [RED] Status: BLOCKED für create-blocker, no-ready-task, invalid-state, offene Konflikte, fehlgeschlagene Verifikation, veraltete/Quellkonflikt, nicht KI-eigene Aufgabenverantwortung oder übersprungenes erforderliches Review ohne Ersatz.

Verwandte Skills