# Planprüfung & Prüfpfad Rufen Sie Projektbeschränkungen ab, vergleichen Sie vorgeschlagene Pläne mit Nachweisen, verfolgen Sie Lebenszyklusergebnisse (geplant, eingereicht, zusammengeführt, freigegeben, verifiziert) und speichern Sie genehmigte Ergebnisse mit Herkunftsnachweis. - Canonical: https://docs.xmemo.dev/de/docs/guides/plan-review-and-audit - Locale: de-DE - Content-Locale: de-DE - Canonical-Content-Digest: 175b0b54be778ea414d888fa51982bb437637db88fc7fe769ca86ce36f314e63 - Edition-Digest: b21f6a814e8382c82e03f3cd7e0870dbe9d074072572accda32eefcf7bf748cc - Source-Revision: sha256:fe7c573aca1054f57d1a9a3473cb5469fb99b6d0edc9e97966d5f99565482dbd ## Ziel des Benutzers und Workflow-Grenzen Dieser praktische Workflow leitet Entwickler und prüfende Agenten dabei an, Softwarevorschläge, technische Spezifikationen und Architekturpläne anhand empirischer Repository-Nachweise zu überprüfen. Prüfer vergleichen Planbehauptungen mit gespeicherten Projektbeschränkungen, verfolgen Änderungen über diskrete Lebenszyklusphasen (planned, submitted, merged, released, verified) und persistieren genehmigte Konsensentscheidungen mit unveränderlicher Herkunftszuordnung. ## Verfügbarkeit und Voraussetzungen Prüf- und Planprüfungsfunktionen stehen über MCP-Client-Profile und die eigenständige Skill-CLI zur Verfügung: - MCP-Profile cursor-plugin und ordinary-full: Bieten umfassende Prüffunktionen: get_project_context (schreibgeschütztes Projektpaket), recall_context, search_knowledge, update_project_decision (überführt Entscheidungen: resolve, supersede, reopen), update_project_todo (überführt Arbeitselemente: accept, assign, block, unblock, complete, cancel) und query_audit (überprüft Ereignisse und Konsolidierungsprotokolle). - MCP-Profil claude-plugin: Umfasst get_project_context, recall_context, create_pending_decision, resolve_decision, record_event, remember, recall und todo. - MCP-Profile generic-public, chatgpt-public und public-only: Unterstützen get_project_summary(project_id, focus) mit focus="blockers" oder focus="status" für kurze Zusammenfassungen sowie memory_overview für Statistiken. - Eigenständiger Skill (Claude Code, Codex, OpenClaw): Wortgetreue Befehle aus der bereitgestellten 1.1.35 help.mjs: recall-context (Zeilen 84-87), search (Zeilen 80-83), remember (Zeilen 72-75), update (Zeilen 44-47), todo-add/list/done (Zeilen 112-123) und activity/stats (Zeilen 64-71). - Voraussetzungen: Lesebereich (memory:read) zum Abfragen von Projektkontexten und dem Prüfverlauf; Schreibbereich (memory:write) zum Aufzeichnen von Entscheidungen und Aktualisieren von Arbeitselementen. ## Eine vollständige Aufgabe: Prüfung eines Dienstmigrationsplans In diesem synthetischen Prüfungsablauf prüft ein Agent einen Vorschlag zur Authentifizierungsaktualisierung für das Projekt proj_security_core, validiert Behauptungen anhand von Repository-Beschränkungen, überführt Arbeitselemente und speichert das genehmigte Ergebnis. ## Projektbeschränkungen und Prüfverlauf abrufen Rufen Sie festgelegte Projektrichtlinien ab und untersuchen Sie die Herkunft früherer Entscheidungen mithilfe von recall-context oder get_project_context: ```bash node scripts/xmemo-skill.mjs recall-context --query "token revocation policy session lifetime proj_security_core" --max_items 6 --max_tokens 2500 ``` ## Status des Arbeitselements überführen und Entscheidung aufzeichnen Markieren Sie das Prüfungs-TODO als erledigt und speichern Sie den maßgeblichen Beschluss mit Herkunftsnachweis: ```bash node scripts/xmemo-skill.mjs todo-done --id todo_rev_401 node scripts/xmemo-skill.mjs remember --content "Approved plan auth_migration_v3: enforced 24h token revocation, strict mutual TLS, and zero unauthenticated fallback. Verified by reviewer audit." --path "plans/auth_migration_v3" ``` ## Beobachtbares Ergebnis Ein strukturierter Planprüfpfad erzeugt einen unveränderlichen, überprüfbaren Pfad, der diskrete Meilensteine des Lebenszyklus widerspiegelt: - Fünf eindeutige Meilensteinstatus: Pläne und Arbeitselemente durchlaufen explizite Phasen: planned (entworfene Spezifikation) -> submitted (formelle Prüfung angefordert) -> merged (Implementierung integriert) -> released (paketiert und bereitgestellt) -> verified (Validierung nach der Bereitstellung bestanden). Verwechseln Sie planned niemals mit released oder verified. - Deterministischer Prüfpfad: query_audit gibt strukturierte Datensätze zurück, die den Ereigniszeitstempel, die agierende agent_id, die Ziel-Memory-/Entscheidungs-ID und Vorher-/Nachher-Zustands-Diffs enthalten. - Herkunftserhaltung: Beim Abfragen von Erinnerungen mit recall oder recall_context legt das Ergebnis unveränderliche Herkunftsmetadaten offen, die die genaue autorisierende Sitzung und den Zeitstempel identifizieren. ## Worauf Agenten zugreifen können Agenten, die Planprüfungen und Audits durchführen, interagieren mit strukturierten, abgegrenzten Darstellungen: - Nur-Anhängen-Prüfprotokoll: Prüfereignisprotokolle sind rein fortlaufend (append-only). Agenten können historische Entscheidungsprüfungsdatensätze weder überschreiben, manipulieren noch löschen. - Versions-DAGs und Ersetzung: Das Aktualisieren einer bestehenden Entscheidung oder Erinnerung erstellt eine neue Version, die mit ihrem Vorgänger verknüpft ist; frühere Zustände bleiben als ersetzte Versionen abrufbar (list_memory_versions in cursor-plugin / ordinary-full). - Evidenzbasierter Kontext: Recall-Werkzeuge liefern sachliche Nachweise aus Projekterinnerungen und verhindern, dass Agenten unbestätigte Modellinferenzen mit erfassten Projektentscheidungen verwechseln. ## Freigabe- und Speichergrenzen Prüfungsdatensätze und Entscheidungen unterliegen strengen Mandanten- und Projektpartitionen: - Projektbereichsbegrenzung: An project:proj_security_core gebundene Entscheidungen und Arbeitselemente bleiben von nicht verwandten persönlichen Projekten oder externen Team-Bereichen isoliert. - Ausschluss temporärer Notizen: Temporäre Entwickler-Notizen (Scratchpads), lokale Debugging-Protokolle und flüchtige Gedanken dürfen nicht in dauerhafte Entscheidungsdatensätze geschrieben werden. - Unveränderlichkeit der Zuweisung: Der Server versieht jede Entscheidung mit der authentifizierten Anrufer-Identität owner_identity und source_identity; Clients können andere Agenten weder vortäuschen noch imitieren. ## Fehlerbehebung Verwalten Sie Prüfungsdiskrepanzen und Überprüfungskonflikte über standardmäßige Lösungspfade: - Nicht verifizierte Planbehauptungen oder Widersprüche: Wenn ein vorgeschlagener Plan bestehenden Architektur-Entscheidungen widerspricht, schließen Sie die Entscheidung nicht ab. Überführen Sie die Entscheidung mit action="supersede" oder action="reopen" zusammen mit einer detaillierten resolution_note, die die Diskrepanz beschreibt. - Fehlende Arbeitselement- oder Entscheidungs-ID: Wenn eine referenzierte todo_id oder decision_id nicht gefunden werden kann, fragen Sie aktive Elemente über todo-list (Skill) oder get_project_context(project_id="proj_security_core") ab, um die kanonische ID zu lokalisieren. - Berechtigung im Bereich verweigert: Wenn einem Agenten Schreibberechtigungen für das Zielprojekt fehlen, gibt update_project_decision HTTP 403 Forbidden zurück. Wenden Sie sich zur Rollenzuweisung an den Projektadministrator. ## Verwandte Referenzen Weitere Informationen zu Sicherheitskonzepten, Herkunftsdetails und zur Verwaltung von Arbeitselementen finden Sie in den folgenden Leitfäden: - Herkunft und Zuordnung: /docs/concepts/provenance-attribution für Details zur Anrufer-Herkunft. - TODO-Arbeitselemente-Referenz: /docs/tools/todos für die Nachverfolgung von Projektaufgaben. - Hauptbuch-Transaktionsreferenz: /docs/tools/ledger für Finanz- und Ressourcenprüfungen. - Wiederaufnahme und Agentenübergabe: /docs/guides/resume-and-handoff für Workflows zur Sitzungs-Checkpoint-Erstellung. - Projektleitfaden: /docs/concepts/projects für die Organisation von Projektarbeitsbereichen. ## ChatGPT-Benutzer Geben Sie ChatGPT dauerhaften Zugriff auf Ihre XMemo-Präferenzen, Projektfakten, Entscheidungen und TODOs, ohne Bearer-Token in einen Chat einzufügen. Verbinden Sie den gehosteten XMemo-MCP-Server über den OAuth-Ablauf der ChatGPT-/OpenAI-App und genehmigen Sie anschließend die Berechtigungen memory:read und memory:write für Ihr XMemo-Konto. Speichern Sie eine synthetische Präferenz oder Projektnotiz, starten Sie einen neuen Chat und fordern Sie ChatGPT auf, diese vor der Fortsetzung der Arbeit über XMemo abzurufen. Wenn OAuth fehlschlägt oder Tools nicht angezeigt werden, melden Sie sich in der Host-App vom MCP-Server ab, verbinden Sie die XMemo-Server-URL erneut und versuchen Sie es noch einmal, bevor Sie direkte Token erstellen. ## Copilot- / Codex-Entwickler Übertragen Sie Repository-Entscheidungen, Programmierkonventionen, Bugfix-Notizen und den Aufgabenverlauf zwischen IDE- und CLI-Agenten. Verwenden Sie OAuth für VS Code / GitHub Copilot und Gemini CLI, sofern verfügbar. Behalten Sie für Copilot CLI, Codex, Cursor oder andere direkte MCP-Clients XMEMO_KEY in der lokalen Umgebung oder im Secret-Store und setzen Sie eine stabile XMEMO_AGENT_INSTANCE_ID. Erfassen Sie eine Codebasis-Entscheidung oder einen Bugfix und fordern Sie den nächsten IDE- oder CLI-Agenten auf, den relevanten XMemo-Kontext vor dem Bearbeiten abzurufen. Wenn Abrufe leer bleiben, überprüfen Sie den ausgewählten MCP-Konfigurationspfad, die Umgebungsvariable XMEMO_KEY für direkte Clients und veraltete OAuth-Anmeldedaten in der Host-App. ## Verantwortlicher für Team- / Enterprise-Pilotprojekte Evaluieren Sie geteilten Speicher mit Kontokontrollen, Quellenzuordnung, Export-/Lösch-Workflows und prüfersicheren Einrichtungsnachweisen. Erstellen oder betreten Sie den geschützten XMemo-Arbeitsbereich, laden Sie freigegebene Benutzer ein und verbinden Sie jeden Client über OAuth oder bereichsbezogene direkte Anmeldedaten gemäß den Bereitschafts-Badges. Lassen Sie ein Mitglied des Pilotprojekts eine synthetische Team-Erinnerung speichern, bestätigen Sie die Quellenzuordnung in XMemo und prüfen Sie anschließend Lösch-/Export- sowie Support-Pfade. Wenn ein Mitglied keine Verbindung herstellen kann, prüfen Sie Rollenberechtigungen, OAuth-Genehmigung, Client-Bereitschaftsstatus und Support-Hinweise, bevor Sie ein neues Token ausstellen. ## Betreiber autonomer Agenten Ermöglichen Sie es Headless- oder zeitgesteuerten Agenten, Fortschritte aufzuzeichnen, frühere Entscheidungen abzurufen und eine stabile, nicht-geheime Instanzidentität beizubehalten. Rufen Sie /api/v1/mcp/config/autonomous-agent ab. Bevorzugen Sie auth_modes.oauth, wenn der Runner OAuth + benutzerdefinierte Header unterstützt; verwenden Sie auth_modes.xmemo_key mit XMEMO_KEY aus einem Secret-Store nur für vollständig autonome Headless-Runner. Führen Sie eine synthetische Aufgabe aus, die den Fortschritt in XMemo schreibt, starten Sie den Runner neu und bestätigen Sie, dass er diesen Fortschritt unter Verwendung derselben XMEMO_AGENT_INSTANCE_ID abruft. Wenn sich die Zuordnung ändert oder Abrufe über Instanzen hinweg aufgeteilt werden, speichern Sie XMEMO_AGENT_INSTANCE_ID außerhalb von Git und stellen Sie sicher, dass der Runner diese nicht bei jedem Start neu generiert.