lukaszbadowski/manage-ai-software-projects

Verwalte KI-Softwareprojekte

Verwandle vage KI-gestützte Lieferarbeit in ein kontrolliertes Ausführungssystem für einen menschlichen Bediener. Erfasse den Rahmen, hole bewusste Zustimmung zur Story-Aufschlüsselung ein, führe über eine kleine, geroutete Aufgabenwarteschlange in dauerhaften Dateien aus, verifiziere mit Nachweisen und schließe erst ab, wenn jedes Erfolgskriterium seinen End-to-End-Check bestanden hat.

Halte den dauerhaften Projektzustand anbieterneutral. Der Wechsel zwischen Codex, Claude Code oder einem anderen kompatiblen Agenten darf keine Konvertierung der pm/-Dateien erfordern.

Schnellstart

1. Überprüfe den Workspace. Wenn pm/ existiert, lies pm/STATE.md, dann pm/TASKS.md; repariere Lücken, anstatt das System neu zu generieren.
2. Wenn kein Projektsystem existiert, führe CP1 aus: Stelle die Ermittlungsfragen und entwirf den Rahmen in pm/PLAN.md.
3. Erstelle die vier kanonischen Dateien aus references/file-templates.md.
4. Treibe die Arbeit durch CP2-Aufschlüsselung, CP3-Warteschlange, die Ausführungsschleife und CP4-Endabnahme voran.

Operator-Checkpoint-Protokoll

Erstelle die Aufschlüsselung gemeinsam mit dem Bediener. Halte jede Genehmigung mit einem Datum in pm/PLAN.md oder pm/TASKS.md fest.

• CP1 — Rahmen. Ermittle und erhalte Genehmigung für das Ziel, die Erfolgskriterien, die Endchecks, den Umfang, die Einschränkungen und die strukturellen Annahmen.
• CP2 — Aufschlüsselung. Präsentiere Stories in der Sprache des Bedieners. Gib jeder Story Abnahmekriterien und verfolge sie zurück zu den Erfolgskriterien, die sie bedient. Kläre offene strukturelle Entscheidungen mit dem Bediener.
• CP3 — Warteschlange. Präsentiere die geordnete Aufgabenwarteschlange mit Routing-Stufen, bevor die Ausführung beginnt.
• CP4 — Endabnahme. Führe jeden CP1-Endcheck erneut End-to-End aus, verlinke Nachweise, präsentiere den Abnahmebericht und hole die Unterschrift ein. Abgeschlossene Aufgaben allein bedeuten nicht, dass das Projekt fertig ist.

Verwende diese festen Regeln:

• Fülle kleine Lücken innerhalb eines genehmigten Rahmens mit protokollierten Annahmen in pm/DECISIONS.md.
• Gib strukturelle Änderungen – Umfang, Stories, Erfolgskriterien oder Abnahmeschwelle – an den entsprechenden Checkpoint zurück und dokumentiere den Kompromiss.
• Frage bei CP1: Welches Ergebnis muss existieren und für wen? Wie wird der Bediener es persönlich verifizieren? Was ist außerhalb des Umfangs? Welche Einschränkungen sind fest? Was existiert bereits? Was ist am riskantesten oder unklarsten? Wie viel Überprüfung wünscht der Bediener?
• Stelle im Rettungsmodus den implizierten Rahmen und die Aufschlüsselung aus dem Workspace wieder her, präsentiere sie zur Bestätigung und baue dann die Warteschlange neu auf.

Kanonische Projektdateien

Verwalte vier Dateien unter pm/:

• pm/PLAN.md — Ziel, Erfolgskriterien, Umfang, Stories, Rückverfolgbarkeit, Genehmigungen
• pm/TASKS.md — geordnete Aufgabenwarteschlange, stabile IDs, Routing, Verifikation, Nachweise
• pm/STATE.md — aktueller Zustand, Übergabenotizen, Sitzungsprotokoll
• pm/DECISIONS.md — Entscheidungen, Annahmen, Risiken, Probleme, Änderungsprotokoll

Erstelle standardmäßig keine weiteren Kontrolldateien. Füge pm/CONSTRAINTS.md, pm/RELEASE.md oder pm/RESEARCH.md nur hinzu, wenn der entsprechende Zweig aktiv ist.

Halte die produktspezifische Eingabedatei – wie AGENTS.md oder CLAUDE.md – kurz und navigational: verweise auf pm/STATE.md, dann pm/TASKS.md, mit pm/PLAN.md als genehmigtem Umfang. Spiegle dauerhafte Informationen aus sitzungslokalen Planungswerkzeugen in pm/TASKS.md und pm/STATE.md wider.

Leite Arbeit nach Fähigkeit weiter

Weise eine anbieterneutrale Route:-Stufe zu, wenn jede Aufgabe in die Warteschlange aufgenommen wird:

Stufe	Verwenden für
heavy	Planung, Zerlegung, Architektur, mehrdeutiges Debugging, übergreifende Refactorings, riskante Überprüfung, Endabnahme
standard	abgegrenzte Implementierung, Tests, Änderungen mittlerer Komplexität
light	Repository-Suche, Zusammenfassungen, mechanische Bearbeitungen, Dokumentation, Formatierung, Log-Sichtung

Leite jede Aufgabe an die günstigste Stufe weiter, die sie zuverlässig abschließen kann:

• Halte den primären Thread ausreichend fähig, um zu leiten: Rahmen-Briefings, Arbeit weiterzuleiten, Nachweise zu beurteilen und freizugeben.
• Eskaliere eine Stufe nach zwei fehlgeschlagenen Versuchen oder einem Ergebnis mit geringem Vertrauen für dieselbe Aufgabe; dokumentiere die Eskalation.
• Erfordere, dass die Überprüferstufe mindestens der Schreiberstufe entspricht. Gib riskanten oder übergreifenden Änderungen eine heavy-Überprüfung mit frischem Kontext. Lasse niemals einen light-Mitarbeiter sich selbst genehmigen.
• Halte Modellnamen aus pm/ heraus; Produkt-Aliase und Preise ändern sich, während Fähigkeitsstufen nützlich bleiben.
• Lies references/agent-routing.md, bevor du Arbeiter für Codex, Claude Code oder einen anderen Agenten konfigurierst.

Baue zuerst Kontext auf

• Extrahiere das eigentliche Ziel, die Benutzer, die Abnahmeschwelle, Abhängigkeiten und Freigabeerwartungen.
• Behandle Daten, Budgets, Genehmigungen, Lieferantenpläne oder Veröffentlichungsfenster nur als erstklassige Eingaben, wenn sie explizit sind.
• Suche nach vorhandenen pm/-Dateien, Aufgaben-Briefings, Backlogs, Designs, ADRs, Teststrategien, Runbooks, Risikoprotokollen und Agentenanweisungsdateien, bevor du neue Artefakte erfindest.
• Bewerte bei Rettungsarbeiten die Klarheit des Ziels, den Umfang, Abhängigkeiten, die Qualität der Abnahme, Risikohygiene, Lesbarkeit des Kontexts, Berechtigungen und Freigabebereitschaft.

Wähle den kleinsten Kontrollmodus

• Standardmäßig solo-operator: ein Bediener steuert KI-Agenten.
• Füge external-constraint für ein echtes festes Datum, Compliance-Gate, Genehmigung, Lieferantenabhängigkeit, Kontingent oder Veröffentlichungsfenster hinzu.
• Füge feedback-heavy hinzu, wenn Entdeckung, Benutzerlernen oder UX-Iteration dominiert.
• Füge release-safety hinzu, wenn die Auslieferung einen Cutover, Rollback, Überwachung oder Betriebshinweise erfordert.

Größe der Ausführungseinheiten

• Verwende Stories für benutzersichtbaren Wert und Abnahme. Verwende Meilensteine nur, um Arbeit zu gruppieren. Führe durch Aufgaben aus.
• Mach jede Aufgabe so, dass sie in einen fokussierten Agentenlauf und eine schnelle Bedienerüberprüfung passt: ein Subsystem, eine Schnittstelle, ein Dokument oder eine Testoberfläche und ein überprüfbarer Diff.
• Gib jeder Aufgabe eine stabile ID, Story-Referenz, Routing-Stufe, Umfang, Abhängigkeit, Bedingung für "erledigt", genaue Verifikation, Nachweisfeld und expliziten Stoppunkt.
• Splitte vor der Ausführung, wenn eine Aufgabe nicht zusammenhängende Bereiche oder mehrere unabhängige Validierungen umfasst. Behalte die Historie: Unteraufgaben erhalten neue IDs; ersetzte Aufgaben werden zu superseded.
• Fülle nach Abschluss einer Aufgabe deren Nachweise und aktualisiere pm/STATE.md im selben Lauf.

Halte Rückverfolgbarkeit aufrecht

• Ordne jedes Erfolgskriterium mindestens einer Story zu und jede Story mindestens einer Aufgabe.
• Markiere eine Story nur dann als erledigt, wenn alle ihre Aufgaben und Abnahmekriterien mit Nachweisen verifiziert sind.
• Markiere das Projekt nur dann als erledigt, wenn CP4 jedes Erfolgskriterium End-to-End erneut verifiziert.

Führe eine Qualität-zuerst-Schleife aus

• Definiere den kleinsten glaubwürdigen Beweis vor der Implementierung: fehlgeschlagene Reproduktion, automatisierter Test, erwartete Ausgabe, Screenshot-Vergleich, Vertragsprüfung oder genaues manuelles Verfahren.
• Verwende erkunden -> planen -> implementieren -> verifizieren -> überprüfen -> dokumentieren.
• Dokumentiere Befehle, Ergebnisse, Screenshots, Metriken und Überprüfungsnotizen, nicht nur Schlussfolgerungen.
• Gib Änderungsbudgets für riskante Aufgaben an: erlaubte Dateien, stabile Schnittstellen, Datensicherheit, Rollback und Eskalationsauslöser.
• Pilotiere repetitive oder automatisierte Änderungen auf einem engen repräsentativen Ausschnitt, bevor du skalierst.
• Stoppe nach demselben Fehler zweimal und verbessere die Umgebung, Dokumentation, Regel oder den Validator; starte mit sauberem Kontext neu.
• Behandle wiederholte Agentenfehler als Systemfeedback. Verbessere den Prozess, nicht nur die aktuelle Antwort.

Delegiere sicher

• Delegiere nur autonomiereife, abgegrenzte Arbeit. Behalte Ziele, Zerlegung, Synthese und Freigabe im primären Thread.
• Gib jedem Arbeiter ein schriftliches Briefing: Aufgaben-ID, Ziel, Umfang, Einschränkungen, Verifikationsbefehle, erwartete Nachweise, Stoppunkt, Eskalationsauslöser und Routing-Stufe.
• Behalte winzige, eng gekoppelte oder hochinteraktive Arbeit im primären Thread, wenn der Delegierungsaufwand seinen Nutzen übersteigt.
• Bevorzuge deterministische Validatoren für Null-Ausnahme-Regeln wie erforderliche Tests, Pfadbeschränkungen, Formatierung oder Secret-Scannen.
• Durchsetze das Prinzip der geringsten Privilegien, Vertrauensgrenzen, Regeln für die Handhabung von Geheimnissen und explizite Bedienergenehmigung für riskante Aktionen.

Referenzen

• Lies references/file-templates.md beim Erstellen oder Reparieren von pm/.
• Lies references/worked-example.md für ein kompaktes End-to-End-Beispiel.
• Lies references/project-rulebook.md beim Auditieren oder Retten eines Projekts.
• Lies references/external-constraints.md nur für echte externe Einschränkungen oder Produktionsfreigaberisiko.
• Lies references/ai-agent-practices.md für tiefere Anleitung zu dauerhaftem Speicher, Kontext, Delegation, Evaluierungen und Schutzvorrichtungen.
• Lies references/agent-routing.md beim Abbilden von Stufen auf die aktuellen Fähigkeiten eines Produkts.
• Lies references/source-anchors.md, wenn Herkunft oder flüchtige Lieferantenanleitung wichtig ist.
• Lade nur die kleinste relevante Referenz.

Ausgabestandards

• Schreibe konkrete, entscheidungsreife Artefakte im Imperativ.
• Melde zuerst den Checkpoint-Status und Aufgaben-IDs vor Prosa-Status.
• Formatiere Aufgaben als: Aufgaben-ID, Aufgabe, Story, Route, Umfang, Abhängig von, Erledigt, wenn, Verifizieren mit, Nachweis, Stopp nach, Status.
• Bevorzuge einen überprüfbaren Diff pro Aufgabe.
• Halte Modellnamen aus dauerhaften Projektdateien heraus.
• Füge keine Terminpläne, Budgets, Genehmigungsworkflows, wiederkehrende Zeremonien oder Phasengatter hinzu, es sei denn, das Projekt benötigt sie wirklich.
• Überprüfe Behauptungen zu aktuellem Modell, Benchmark, Preis oder Lieferanten-Workflow anhand von Primärquellen, bevor du sie verwendest.