Produktmanagement-Kompetenzen schreiben und pflegen, die gutes Urteilsvermögen vermitteln

## Begründungen und Beispiele behalten, die gutes Urteilsvermögen lehren ### Beiden Zielgruppen gerecht werden Eine Produktmanagement-Kompetenz sollte Fachkräften helfen, nützliche Arbeit zu erledigen und ihre Fähigkeiten weiterzuentwickeln. Gestalten Sie jede Kompetenz sowohl für den Menschen, der sein Urteilsvermögen ausbildet, als auch für den Agenten, der den Arbeitsablauf ausführt. Optimieren Sie nicht für eine Zielgruppe auf Kosten der anderen. Machen Sie die Überlegungen hinter dem Arbeitsablauf deutlich genug sichtbar, damit Empfehlungen vertrauenswürdig, erklärbar und übertragbar sind. Der Benutzer sollte verstehen, warum ein Ansatz funktioniert, und nicht lediglich ein fertiges Arbeitsergebnis erhalten. ### Die Lernstruktur schützen - Kürzen Sie Erklärungen nicht, wenn dadurch die Überlegungen entfallen, die für fundierte Entscheidungen erforderlich sind. - Bewahren Sie ausdrücklich benannte Antimuster, weil sie Benutzern vermitteln, was sie in realen Situationen erkennen und vermeiden sollten. - Verwenden Sie Beispiele, die den Denkprozess und nicht nur das Endergebnis zeigen. - Definieren Sie Fachbegriffe bei ihrem ersten Auftreten und benennen Sie Abwägungen ausdrücklich. - Halten Sie den Arbeitsablauf praktisch und für Agenten ausführbar, ohne die Anleitungsebene zu entfernen. Wenn Sie die Effizienz verbessern, entfernen Sie Wiederholungen, Fülltext und nebensächliche Hintergründe, bevor Sie Lektionen, Beispiele oder Fehlermuster entfernen. Ist unklar, ob ein Abschnitt eine didaktische Stütze oder unnötiger Ballast ist, behalten Sie ihn bei, bis seine Funktion verstanden wurde. ### Qualität in unterschiedlichen Zusammenhängen zeigen Nehmen Sie mindestens ein konkretes Beispiel auf, das zeigt, wie Nachweise zu einer Entscheidung führen. Ergänzen Sie eine vollständig ausgearbeitete Kompetenz um eine wiederverwendbare Vorlage und ausgearbeitete Beispiele aus zwei deutlich unterschiedlichen Geschäftsumfeldern, etwa einem Softwaredienst und einem physischen oder betrieblich geprägten Unternehmen. Verwenden Sie fiktive Organisationen und Daten. ## Jeder Kompetenz einen eigenen Ordner geben und erzeugte Listen nie von Hand ändern ### Maßgebliche Quellen von abgeleiteten Ergebnissen trennen Legen Sie jede Kompetenz in einem eigenen, einheitlich benannten Ordner ab, der ein maßgebliches Kompetenzdokument und alle kompetenzspezifischen Hilfsmittel oder Skripte enthält. Speichern Sie wiederverwendbare Orchestrierungsbefehle getrennt von den einzelnen Kompetenzen. Pflegen Sie Forschung, Benutzerdokumentation, Vorschauanwendungen und Veröffentlichungsartefakte in getrennten Bereichen mit klarer Zuständigkeit. Behandeln Sie erzeugte Kataloge, Indizes, Paketkopien und Verteilungsbündel als abgeleitete Artefakte. Erzeugen Sie diese aus den maßgeblichen Quellen neu, anstatt sie direkt zu bearbeiten. Verwenden Sie für Kompetenzordner kleingeschriebenes kebab-case und halten Sie den Ordnernamen mit dem deklarierten Namen der Kompetenz synchron. Bewahren Sie stabile Pfade, wann immer es möglich ist; benennen Sie eine Kompetenz nur bei Bedarf um und aktualisieren Sie anschließend sämtliche Verweise. ### Zuständigkeitsgrenzen einhalten Stellen Sie vor der Bearbeitung fest, welchem Repository oder Arbeitsbereich der Inhalt gehört. Eine gemeinsam genutzte Bibliothek, ein produktspezifisches Handbuch und ein Repository für die Verteilung können aufeinander verweisen und dennoch unterschiedliche maßgebliche Quellen haben. Arbeiten Sie am zuständigen Speicherort und behandeln Sie andere Orte als schreibgeschützte Referenzen, sofern die Aufgabe diese Grenze nicht ausdrücklich ändert. Leiten Sie die Struktur nicht allein aus einem vertrauten Verzeichnisnamen ab. Ziehen Sie vor strukturellen Entscheidungen die Definitionen, Beitragsregeln, Skripte und bestehenden Beispiele des jeweiligen Repositorys heran. ### Die spezifischste Fähigkeit finden Bevor Sie eigene Produktmanagement-Hinweise entwerfen, prüfen Sie die verfügbaren Kompetenzen und wählen Sie die am genauesten passende aus. Häufige Bereiche sind Produktfindung, Jobs to Be Done, Personas, Produktstrategie, Priorisierung, Entwicklungspläne, Anforderungsdokumente, Benutzergeschichten, Abnahmekriterien, Arbeit an Produkten mit künstlicher Intelligenz, Agenten-Arbeitsabläufe und die Abstimmung mit Interessengruppen. Behandeln Sie diese als Arbeitsabläufe für Anleitung und die Erstellung von Arbeitsergebnissen, nicht als allgemeine Aufgaben der Softwareentwicklung. ## Beispiele und typische Fehler aufnehmen und immer nur eine Frage stellen ### Einen einheitlichen Dokumentvertrag verwenden Geben Sie jeder Kompetenz eine klare Abfolge, beispielsweise Zweck, Eingabe, Schlüsselkonzepte, Anwendung, Beispiele, häufige Fallstricke und Quellen. Nehmen Sie die Frontmatter-Felder name, description und type auf. Wenn Zielplattformen diese Grenzen vorgeben, darf name höchstens 64 Zeichen und description höchstens 200 Zeichen umfassen. Verwenden Sie klare Markdown-Überschriften und kurze Absätze. Ergänzen Sie umschlossene Codeblöcke um Sprachkennungen. Formulieren Sie knapp und mit klarer Haltung, ohne notwendige Überlegungen, Bedingungen oder Beispiele zu opfern. ### Eingaben als Einladung und nicht als Hürde gestalten Der Abschnitt Eingabe sollte in verständlicher Sprache erläutern, was der Benutzer bereitstellen kann, und ein Aufrufbeispiel enthalten. Behandeln Sie Angaben, die bereits in der Anfrage stehen, als schon beantwortet. Lassen Sie teilweise oder vollständig fehlende Anfangseingaben zu. Erläutern Sie, wie der geführte Ablauf fehlende Angaben erfasst, statt den Benutzer zu blockieren. Vermeiden Sie laufzeitspezifische Platzhalter oder Vorlagensyntax, die in nicht unterstützten Umgebungen wörtlich erscheinen würden. ### Interaktive Abläufe bewusst gestalten Für eine interaktive Kompetenz gilt: - Stellen Sie jeweils eine Frage oder verwenden Sie kleine, inhaltlich zusammengehörige Gruppen. - Lassen Sie jede Antwort die nächste Frage bestimmen. - Bieten Sie nummerierte, kontextbezogene Empfehlungen für die nächsten Schritte an. - Ermöglichen Sie sowohl die Auswahl per Nummer als auch freie Eingaben. - Passen Sie den Arbeitsablauf an, wenn die Auswahl des Benutzers den maßgeblichen Pfad verändert. Gestalten Sie die Kompetenz eigenständig und ohne verborgene Annahmen für einen Agenten nutzbar. Nehmen Sie mindestens ein ausdrücklich benanntes Antimuster auf und erläutern Sie, warum es scheitert. ## Kompetenzen und Links vor dem Teilen mit den Werkzeugen der Bibliothek prüfen ### Den eigenen Prüfpfad der Bibliothek verwenden Bevorzugen Sie die im Repository dokumentierten Werkzeuge zur Ermittlung, Prüfung, Paketierung und zum Test der gesamten Bibliothek gegenüber behelfsmäßigen Kontrollen. Verwenden Sie Dateisuche und gezielte Verweissuchen, um vor dem Einreichen von Änderungen die Speicherorte der Kompetenzen und Querverweise zu überprüfen. Prüfen Sie, ob maßgebliche Kompetenzpfade aufgelöst werden können, Metadaten gültig sind, erforderliche Abschnitte vorhanden sind, Beispiele und Quellen stimmen und Verknüpfungen konsistent bleiben. Wenn keine automatisierten Tests verfügbar sind, führen Sie diese Prüfungen manuell durch, anstatt einen ungeprüften Erfolg zu behaupten. Führen Sie den Paket- und den Kataloggenerator über ihre gepflegten Einstiegspunkte aus. Wurde eine Vorschauanwendung geändert, führen Sie den betreffenden lokalen Vorschaupfad aus und prüfen Sie dessen Dokumentation. ### Kompatibilität und sichere Automatisierung bewahren Halten Sie plattformspezifische Paketierungsanforderungen ein, einschließlich der exakten Groß- und Kleinschreibung von Dateinamen, sofern dies verlangt wird. Halten Sie Hilfsskripte deterministisch, dokumentiert und frei von Netzwerkzugriffen, es sei denn, der Arbeitsablauf fordert und regelt diese ausdrücklich. Prüfen Sie Skripte und paketierte Inhalte auf Sicherheit, bevor Sie sie weitergeben oder ausführen. Entfernen Sie verwaltete Marktplatz-, Plug-in- oder Kompatibilitätsdateien nicht allein deshalb, weil sie unbeteiligt erscheinen. Bearbeiten Sie keine erzeugten Veröffentlichungsartefakte als Ersatz für die Korrektur ihrer maßgeblichen Quelle. ### Die tatsächliche maßgebliche Quelle prüfen Stützen Sie eine Änderung an einer Kategorie, einem Kompetenztyp oder einer Paketstruktur auf lokale Kriterien und die betreffende maßgebliche Kompetenz. Bevorzugen Sie Nachweise aus gepflegten Prüfprogrammen und Repository-Werkzeugen gegenüber persönlichen Konventionen. Gehört die angeforderte Arbeit in ein anderes Repository, beenden Sie Schreibvorgänge an der aktuellen Grenze und verlagern Sie die Änderung zur zuständigen Quelle. Referenzmaterial darf die Arbeit unterstützen, ohne selbst zum Bearbeitungsziel zu werden. ## Änderungen klein halten und vor der Veröffentlichung eine Checkliste abarbeiten ### Gut prüfbare Beiträge vorbereiten Halten Sie Änderungen klein, wartbar und auf den angegebenen Zweck begrenzt. Verwenden Sie klare Commit-Betreffzeilen im Imperativ. Eine Prüfanfrage sollte die Änderung zusammenfassen, relevante Vorgänge verknüpfen, den Kompetenztyp nennen und wesentliche Änderungen an Kompatibilität oder Verhalten hervorheben. Aktualisieren Sie beim Hinzufügen oder Umbenennen einer Kompetenz die Katalogeinträge, Anzahlen, Tabellen, Pfade und Querverweise. Prüfen Sie vor der Veröffentlichung, ob alle Verweise aufgelöst werden können. ### Eine vollständige Veröffentlichungsprüfliste anwenden - Prüfen Sie die maßgeblichen Kompetenzordner und Metadaten. - Erstellen Sie herunterladbare Pakete und erzeugte Kataloge aus der Quelle neu. - Bestätigen Sie, dass Beispiele, Quellen und Navigationsverknüpfungen weiterhin stimmen. - Prüfen Sie die Frontmatter-Syntax und alle plattformspezifischen Paketkopien. - Aktualisieren Sie die Oberflächendokumentation und Veröffentlichungshinweise, wenn sich eine Vorschauanwendung ändert. - Stellen Sie sicher, dass kein erzeugtes Artefakt, keine unbeteiligte Datei und keine unbeabsichtigte umfassende Ersetzung in die Änderung gelangt ist. ### Lernergebnisse als letzte Freigabebedingung verwenden Eine veröffentlichungsreife Kompetenz ist didaktisch, für Agenten ausführbar, eigenständig und praktisch. Sie enthält Überlegungen, mindestens ein ausgearbeitetes Beispiel, ein ausdrückliches Antimuster, definierte Fachbegriffe und sichtbare Abwägungen. Eine vollständig ausgearbeitete Kompetenz enthält außerdem eine wiederverwendbare Vorlage und Beispiele aus gegensätzlichen Bereichen. Entfernen Sie Erklärungen, Antimuster oder Beispiele nicht lediglich, um den Umfang zu verringern. Genehmigen Sie die Veröffentlichung nur, wenn die Kompetenz ein nützliches Ergebnis hervorbringt, das Urteilsvermögen des Benutzers stärkt und in allen unterstützten Umgebungen wartbar bleibt.