Lujker/road-map-journal

Roadmap und Arbeitstagebuch

Pflegen Sie einen nützlichen, aktuellen Plan und eine nachvollziehbare Aufzeichnung von Entscheidungen, ohne ein neues Layout aufzuzwingen. Befolgen Sie die Anweisungen des Benutzers und die Konventionen des Projekts. Bewahren Sie vorhandene Namen, Kennungen, Sprache, Links, nicht committete Änderungen und nicht zusammenhängende Inhalte. Verwenden Sie für einen neuen Plan die Sprache, die der Benutzer angibt oder vernünftigerweise andeutet; fragen Sie nach, wenn dies unklar ist. Erzwingen Sie keine Sprache.

Wann verwenden

Verwenden Sie dies für Anfragen zu einer Roadmap, einem Entwicklungsplan, einer Aufgabenliste, einem Arbeitstagebuch, dem Status eines Eintrags oder zur Fortsetzung geplanter Arbeit. Beispiele sind „Was ist als nächstes auf der Roadmap?“, „Setze den vereinbarten Eintrag fort“, «дорожная карта», «план разработки», «дневник разработки», «что дальше по плану?» und «продолжай разработку по плану». Bestimmen Sie den gewünschten Umfang aus dem Kontext; eine Statusfrage ist schreibgeschützt.

Zuerst entdecken

Identifizieren Sie das Projektverzeichnis und lesen Sie dessen Anweisungen. Finden Sie vorhandene Roadmaps, Aufgabenlisten, Eintragsnotizen und Übergabedokumente; Namen und Orte variieren. Lesen Sie den relevanten Eintrag, seine Abnahmekriterien, die aktuelle Aufgabenliste und verknüpfte Notizen. Überprüfen Sie die relevante Implementierung, den Versionskontrollstatus, falls verfügbar, und Nachweise, wenn die Anfrage eine Bewertung des aktuellen Zustands erfordert. Gehen Sie nicht von Git, einem bestimmten Verzeichnislayout oder einem bestimmten Statusvokabular aus. Folgen Sie bei mehreren Repositorys vorhandenen Links; fragen Sie nach einem unzugänglichen, maßgeblichen Ort, anstatt einen Ersatz zu erfinden.

Wählen Sie den Modus, der durch die Anfrage impliziert wird:

• Schreibgeschützt: Antworten Sie aus den relevanten Dokumenten und Nachweisen. Unterscheiden Sie aufgezeichnete Behauptungen von unabhängig überprüften Fakten; nehmen Sie keine Änderungen vor.
• Initialisieren: Wenn kein Plan existiert, besprechen Sie die gewünschte Arbeitsweise des Eigentümers und schlagen Sie eine geeignete Struktur, einen Ort, einen Umfang, erste Einträge und eine Reihenfolge vor; fügen Sie ggf. Tracks, Agentenrollen und erste Karten hinzu. Verwenden Sie für eine tiefergehende Erkundung grill-me, falls verfügbar und angemessen; falls nicht vorhanden, bieten Sie die Installation an, installieren Sie jedoch nicht ohne Erlaubnis und blockieren Sie nicht den Arbeitsablauf. Andernfalls ermöglichen Sie selbst eine prägnante, strukturierte Diskussion mit Empfehlungen für ungelöste Entscheidungen. Holen Sie die informierte Zustimmung des Benutzers ein, bevor Sie Dateien erstellen; erfinden Sie keine Prioritäten oder Zusagen.
• Übernehmen: Wenn bereits Planungsmaterial existiert, verwenden Sie es an Ort und Stelle. Wenn der Eigentümer eine umfassende Überprüfung wünscht, verwenden Sie dieselbe optionale strukturierte Diskussion wie bei der Initialisierung, zugeschnitten auf das, was ungelöst ist. Erklären Sie jede vorgeschlagene neue Datei, Migration oder umfassende Neufassung und holen Sie zuerst die informierte Zustimmung ein. Erstellen Sie nicht stillschweigend eine parallele Quelle der Wahrheit.
• Fortsetzen: Lesen Sie die neueste Anweisung, die aktive Aufgabenliste, die Eintragsnotizen und den relevanten aktuellen Zustand. Lösen Sie widersprüchliche oder veraltete Anweisungen gegen aktuelle Nachweise und die neueste Entscheidung des Benutzers auf; fragen Sie nach, wenn ein folgenreicher Konflikt bestehen bleibt. Wenn der Eintrag nicht bereits ausgewählt oder delegiert wurde, stimmen Sie vor der Implementierung einen zu. Ein gespeicherter Plan oder die Genehmigung zu dokumentieren ist keine Autorisierung, mit der Arbeit zu beginnen.
• Aktualisieren: Nehmen Sie die gewünschten, abgegrenzten Änderungen an vorhandenen Aufzeichnungen vor. Halten Sie den Status des Eintrags, die verbleibende Arbeit und die betroffenen Aufgabenlisteneinträge konsistent; bewahren Sie den Verlauf und die nicht zusammenhängende Reihenfolge. Erklären Sie bei einer neuen Datei oder einer umfassenden Neufassung die vorgeschlagene Änderung und holen Sie zuerst die informierte Zustimmung ein. Eine Anfrage, die auf einen Eintrag beschränkt ist, autorisiert nicht die Implementierung oder Neufassung des restlichen Plans.

Aufzeichnen und abgleichen

Verwenden Sie die etablierte Anordnung des Projekts. Typischerweise fasst eine Roadmap Einträge und ihre aktuelle Reihenfolge zusammen; ein Tagebuch enthält Entscheidungen, Erkenntnisse, Nachweise und den Verlauf. Verlinken Sie anstatt lange Details zu duplizieren. Halten Sie Kennungen stabil. Löschen Sie keine Entscheidungen oder abgebrochene Arbeit stillschweigend: Markieren Sie sie als überholt oder abgebrochen, ggf. mit Grund.

Wenn sich eine Entscheidung, eine Pause oder eine Reihenfolge ändert, aktualisieren Sie betroffene aktuelle Zusammenfassungen und nächste Schritte innerhalb des autorisierten Umfangs; kennzeichnen Sie vorherige Anweisungen als historisch. Ein pausierter oder verschobener Plan darf nicht wie eine aktive Anweisung zum Fortfahren erscheinen. Priorisieren Sie nicht nicht zusammenhängende Arbeit nur neu, weil eine Notiz hinzugefügt wurde. Wenn eine notwendige Korrektur außerhalb des autorisierten Umfangs liegt, weisen Sie den Benutzer darauf hin, anstatt die Bearbeitung auszuweiten.

Sofern der Eigentümer keinen größeren Umfang autorisiert hat, arbeiten Sie an einem Eintrag nach dem anderen und beginnen Sie nicht automatisch mit dem nächsten. Eine abgeschlossene Unterstufe stellt nicht den übergeordneten Eintrag fertig; halten Sie den Rest fest. Halten Sie den Arbeitsmodus von Berechtigungen und Budgets getrennt: Die Autorisierung zur Fortsetzung ist keine pauschale Erlaubnis für Produktionsaktionen oder externe Schreibvorgänge. Halten Sie festgehaltene Fertigstellung, ausstehende Benutzerabnahme und vollständig akzeptierte Arbeit unterschiedlich. Halten Sie prägnante Kontrollpunkte bei Übergaben, Entscheidungen, verifizierten Ergebnissen und Blockern fest, einschließlich dessen, was bleibt und wie fortgesetzt wird; überprüfen Sie unsichere laufende Aktionen, bevor Sie sie wiederholen. Überprüfen Sie vor einem dateiübergreifenden Update in einem gemeinsamen Arbeitsverzeichnis sofort vor dem Schreiben den Versionskontrollstatus und modifizierte Pfade, wenden Sie enge Änderungen gegen frisch gelesenen Inhalt an, bewahren Sie nicht zusammenhängende Arbeit, und überprüfen Sie die abgegrenzten Änderungen, ohne zu committen oder zu veröffentlichen, sofern nicht autorisiert.

Lesen Sie für Arbeiten, die sich über mehrere Einträge, Agenten oder Sitzungen erstrecken, ein Budget haben oder bei denen der Eigentümer einen Track oder kontinuierlichen Modus autorisiert hat, zuerst Länger laufende Arbeit.

Status und Nachweise

Verwenden Sie das Statusvokabular des Projekts. Wenn keines existiert, schlagen Sie OFFEN, IN BEARBEITUNG, BLOCKIERT, TEILWEISE und ERLEDIGT vor, mit für das Projekt vereinbarten Bedeutungen. Zeichnen Sie den Status gemäß den Abnahmekriterien und tatsächlichen Nachweisen auf, nicht gemäß Absicht oder unbelegter Behauptung eines Beauftragten. Geben Sie für TEILWEISE an, was bleibt und ob es einen Blocker gibt. Halten Sie betroffene Statusreferenzen konsistent.

Zeichnen Sie tatsächlich durchgeführte Prüfungen, ihre Ergebnisse und ihren Umfang sowie ggf. die Person, die sie durchgeführt hat, auf. Nachweise können historisch oder von einem anderen Ausführenden stammen; kennzeichnen Sie ihre Quelle und Anwendbarkeit und geben Sie nicht an, dass sie erneut ausgeführt wurden. Wenn spätere Änderungen eine Prüfung ungültig machen, identifizieren oder führen Sie die entsprechende Überprüfung durch. Erfinden Sie niemals Befehle, Ergebnisse, Testzahlen, Genehmigungen oder Benutzerakzeptanz. Automatisierte Tests, freigegebener Code und Live-Betrieb sind unterschiedliche Behauptungen: Leiten Sie niemals Live-Akzeptanz aus Implementierung oder Tests ab. Wenn die erforderliche Abnahme nicht stattgefunden hat, behalten Sie TEILWEISE oder das Äquivalent des Projekts bei und geben Sie die fehlende Umgebung oder Genehmigung an.

Überprüfen Sie nach einer autorisierten Bearbeitung den betroffenen Status, die Aufgabenliste, die Links und die Konsistenz mit den Nachweisen und dem Umfang. Melden Sie Änderungen, tatsächlich durchgeführte Prüfungen und ungelöste Einträge. Behaupten Sie keine Überprüfung, die nicht durchgeführt wurde.

Referenzen

• Generische Vorlagen — optionale Ausgangspunkte, an das Projekt angepasst.
• Szenarien — prägnante Beispiele für Modus- und Umfangsentscheidungen.
• Länger laufende Arbeit — Tracks, Kontrollpunkte, Pause und Stopp, Abnahme, Budgets, gemeinsame Arbeitsverzeichnisse.
• Multi-Repository-Abgleich — Arbeit bewahren und aufgezeichneten, Git- und Live-Status über Arbeitsverzeichnisse hinweg unterscheiden.