Projektleitfaden

Ziel des Benutzers

Richten Sie einen dedizierten Projektarbeitsbereich ein, um kontextbezogene Erinnerungen zu organisieren, betriebliche Entscheidungen und aktive Aufgaben zu verfolgen, fokussierten Projektkontext in verbundenen Agenten abzurufen und zu überprüfen, dass das Entfernen von Projektverknüpfungen die grundlegenden persönlichen Erinnerungen unberührt lässt.

Verfügbarkeit und Voraussetzungen

Projektarbeitsbereiche sind für alle persönlichen Konten in der Memory Console unter https://xmemo.dev/me#projects sowie über unterstützte MCP-Client-Profile verfügbar:

• Persönliche Grenze: Projekte sind derzeit ausschließlich persönlich; der Versuch, ein Projekt mit team_id zu erstellen, wird vom Server abgewiesen (HTTP 400). Die Dokumentation enthält kein Versprechen für Team-Projekte.
• Unbegrenzte Kontingente: Die Erstellung von Arbeitsbereichen wird nicht durch numerische Tarifkontingente oder künstliche Projektlimits eingeschränkt. Konten stellen Arbeitsbereiche nach Bedarf bereit.
• Partitionierte Ansicht: Die Ansicht "Handlungsbedarf" (Attention Needed) und die Partitionen für Wissensspeicher (Knowledge) im Vergleich zu Arbeitsspeicher (Working) arbeiten, sofern für Ihr Konto aktiviert (der Modus zur Konvergenzauswertung ist standardmäßig deaktiviert).
• Agentenkonnektivität: Verbundene Agenten greifen auf Projektwerkzeuge zu, die ihrem Client-Profil gemäß config/mcp-documentation-contract.json entsprechen.

1. Zu Projekten in der Memory Console navigieren

Melden Sie sich bei Ihrem persönlichen Dashboard an und öffnen Sie https://xmemo.dev/me#projects. Wählen Sie in der linken Navigation den Bereich Workspace und klicken Sie auf Projects. Die Leiste kündigt an: "Browse project workspaces, context, and project memories." und zeigt Kennzahlen der obersten Ebene für Total Projects, Active, Attention Needed und Archived an.

https://xmemo.dev/me#projects
Workspace -> Projects -> Total Projects (0) | Active (0) | Attention Needed (—) | Archived (0)

2. Einen neuen persönlichen Projektarbeitsbereich bereitstellen

Klicken Sie im oberen Aktionsbereich auf Create New Project, um das Arbeitsbereichsfenster zu öffnen:

• Projektname: Geben Sie einen aussagekräftigen Projektnamen ein (z. B. "Incident Response Automation"). Das Feld zeigt an: "Required, 1-128 characters." und validiert gegen Steuerzeichen und Pfadtrennzeichen (/ oder \).
• Vorschau der Projektkennung: Überprüfen Sie die Vorschau-Kennung (#incident-response-automation). Der Hilfetext bestätigt: "Non-authoritative preview. The backend server assigns the authoritative project key."
• Beschreibung: Geben Sie optional eine Zielbeschreibung mit bis zu 2000 Zeichen ein (z. B. "Operational runbooks, triage checklists, and automated incident response workflows.").
• Übermittlung: Klicken Sie auf Create Project. Der Server weist die kanonische Kennung zu und öffnet die Projektdetailansicht.

3. Erinnerungen, TODOs und Entscheidungen verknüpfen

Sobald der Arbeitsbereich bereitgestellt ist, befüllen Sie ihn mit bereichsbezogenem Kontext, anstehenden Aufgaben und Architekturentscheidungen:

• Eine Erinnerung verknüpfen: Erstellen Sie eine synthetische Betriebs-Runbook-Erinnerung mit dem Projektbereich (scope: "incident-response-automation"): "Runbook policy: P0 production outages trigger immediate secondary on-call escalation after 15 minutes of unacknowledged alerts."
• Ein TODO aufzeichnen: Fügen Sie in der Projektdetailansicht oder über einen Agenten eine Aufgabe hinzu: "Draft post-incident review template for payment gateway timeouts."
• Eine Entscheidung aufzeichnen: Protokollieren Sie eine Architekturentscheidung: "Use PagerDuty webhook adapter for primary incident ingestion."
• Hero-Kennzahlen prüfen: Die Leiste spiegelt Live-Gesamtsummen wider: Memories: 1, Open TODOs: 1, Decisions: 1.

await client.remember(
  "Runbook policy: P0 production outages trigger immediate secondary on-call escalation after 15 minutes of unacknowledged alerts.",
  {
    path: "projects/incident-response-automation/runbooks/p0-escalation",
    scope: "incident-response-automation",
  },
);

4. Kontextuellen Agentenabruf überprüfen

Verbinden Sie einen autorisierten Agenten-Client, um zu überprüfen, dass der Projektabruf die bereichsbezogenen Datensätze ohne projektübergreifendes Rauschen zurückgibt:

• Cursor oder Ordinary Full: Agenten rufen get_project_context(project_id="incident-response-automation") auf, um aktive Erinnerungen, anstehende TODOs und aufgezeichnete Entscheidungen abzurufen.
• ChatGPT oder Generic Public: Agenten rufen get_project_summary(project_id="incident-response-automation") oder open_project_workspace auf, um den Zusammenfassungsstatus zu prüfen.
• ChatGPT-In-Chat-Widget: Das interaktive In-Chat-Widget, das von open_project_workspace geöffnet wird, stellt Inline-Aufgabenkarten direkt innerhalb der Konversation bereit; es unterscheidet sich von der vollständigen Web-Memory Console unter https://xmemo.dev/me#projects.

{
  "project_id": "incident-response-automation",
  "status": "active",
  "memories_count": 1,
  "open_todos": 1,
  "decisions": 1,
  "summary": "Operational runbooks, triage checklists, and automated incident response workflows."
}

5. Erinnerung trennen und zerstörungsfreie Entfernung überprüfen

Überprüfen Sie, dass das Entfernen einer Projekterinnerung die Zuordnung zum Arbeitsbereich aufhebt, während der zugrunde liegende persönliche Erinnerungsdatensatz erhalten bleibt:

• Speicherleiste öffnen: Wählen Sie in der Projektspeicherliste das Betriebs-Runbook-Element aus, um die Detailansicht anzuzeigen.
• Entfernung initiieren: Klicken Sie in den Aktionen der Leiste auf Remove from Project.
• Trennung bestätigen: Das Bestätigungsfenster öffnet sich mit der Überschrift "Remove from Project" und dem Untertitel "This memory will be disassociated from this project workspace.". Beachten Sie den Hinweis: "The memory content remains in your personal memory archive, but will no longer appear in this project context."
• Bestätigung ausführen: Klicken Sie auf Remove. Der Projektspeicherzähler verringert sich auf 0.
• Globale Persistenz überprüfen: Navigieren Sie zu Ihrem persönlichen Speicherarchiv (/me#memory) und bestätigen Sie, dass die Runbook-Erinnerung intakt und abrufbar bleibt.

Beobachtbares Ergebnis

Nach Abschluss dieses Workflows weist Ihr Arbeitsbereich eine vollständige betriebliche Isolation auf:

• Arbeitsbereichsstatus: Das Projekt wird unter aktiven Projekten (Active) mit dem kanonischen Slug #incident-response-automation aufgeführt.
• Kontextuelle Isolation: Verbundene Agenten fragen den Projektkontext ab und erhalten bereichsbezogene Fakten ohne Kontamination durch nicht verwandte Projekte.
• Datensicherheit: Das Aufheben der Verknüpfung von Erinnerungsdatensätzen aus einem Arbeitsbereich verringert die Projektsummen erfolgreich, während persönliche Erinnerungsdatensätze dauerhaft in Ihrem Archiv erhalten bleiben.

Worauf Agenten zugreifen können

Die Verfügbarkeit von Agentenwerkzeugen hängt strikt vom konfigurierten Client-Profil in config/mcp-documentation-contract.json ab:

• Profile chatgpt-public, generic-public und public-only: Stellen project, get_project_summary und open_project_workspace bereit.
• Profil claude-plugin: Stellt project und get_project_context bereit.
• Profile cursor-plugin und ordinary-full: Stellen get_project_context, update_project_todo und update_project_decision bereit.
• Profilgrenzen: Andere Client-Profile stellen keine Projektwerkzeuge bereit. Der Versuch, nicht vereinbarte Werkzeuge aufzurufen, führt zu Ablehnungen bei der Werkzeugerkennung.

Freigabe- und Lebenszyklusgrenzen

Projektarbeitsbereiche setzen explizite Betriebs- und Datengrenzen durch:

• Persönliche Grenze: Alle Arbeitsbereiche sind derzeit ausschließlich persönlich. Team-Arbeitsbereiche werden nicht unterstützt und Anfragen mit team_id schlagen bei der Validierung fehl.
• Lebenszyklusstatus: Der Memory Explorer kategorisiert Datensätze in die Status Active, Superseded, Expired und Archived.
• Kurationspartitionen: Sofern für Ihr Konto aktiviert, bieten Arbeitsbereiche Wissensspeicher- (Knowledge) und Arbeitsspeicher-Partitionen (Working). Die Knowledge-Partition enthält persistente Konventionen; die Working-Partition speichert flüchtigen Sitzungszustand.
• Unterscheidung von Wissensbasen: Projektpartitionen kategorisieren episodische Erinnerungen aus Konversationen. Im Gegensatz dazu bieten Wissensbasen eine formale, versionierte Dokumentenverwaltung mit Multi-Revisions-Momentaufnahmen. Für kuratierte Dokumentationen konsultieren Sie /docs/concepts/knowledge-bases.
• Kontingentgrenze: Persönliche Projektarbeitsbereiche unterliegen keinen numerischen Kontingenten.

Fehlerbehebung

Häufige Grenzfälle und Wiederherstellungsmaßnahmen:

• Doppelter Projektname (HTTP 409): Der Server weist doppelte Projektnamen ab mit "A project with this name or identifier already exists in your workspace.". Geben Sie einen eindeutigen Projektnamen an.
• Ungültiger Projektname (HTTP 400): Projektnamen dürfen keine Schrägstriche (/ oder \) enthalten, 128 Zeichen nicht überschreiten und keine reservierten Token (_project, ., ..) verwenden. Korrigieren Sie den Namen im Erstellungsdialog.
• Werkzeugdiskrepanz im Client-Profil: Wenn ein Agent get_project_context nicht finden kann, überprüfen Sie das aktive Client-Profil. Das Profil chatgpt-public stellt get_project_summary bereit, während get_project_context unter cursor-plugin und ordinary-full bereitgestellt wird.
• Versionskonflikt (HTTP 409): Wenn eine andere Sitzung das Projekt oder die Erinnerung gleichzeitig ändert, zeigt die Leiste "Modified elsewhere, please reload" neben einer Schaltfläche zum Neuladen an. Klicken Sie auf Reload, um den Zustand zu aktualisieren.

Verwandte Referenzen

Für ergänzende Funktionen und technische Referenzen erkunden Sie:

• Konzeptreferenz zu Projekten: Architekturdetails und Bereichskonventionen unter /docs/concepts/projects.
• Leitfaden zur Memory Console: Vollständiger Rundgang durch die Konsole unter /docs/guides/memory-console.
• Leitfaden zu Wissensbasen: Verwaltung kuratierter Referenzdokumentationen unter /docs/concepts/knowledge-bases.
• REST-API für Projekte: Authentifizierte programmgesteuerte Endpunkte unter /docs/api/projects.