Globaler Kontext gehört außerhalb von APC

APC ist die portable Kontext-Ebene. APX ist die lokale Runtime-Ebene.

Um diese gesund zu halten, befolgen Sie eine Regel: Wenn etwas ein frisches Klonen überstehen muss, legen Sie es in APC. Wenn es von einem bestimmten Benutzer, einer Maschine oder einem Prozess abhängt, halten Sie es außerhalb von APC.

Projekte wachsen, und die Versuchung folgt. Vielleicht möchten Sie noch eine Einstellung oder einen lokalen Pfad hinzufügen. Wenn Sie nicht streng sind, wird Ihr Repo zu einem Sammelsurium an Maschinendaten. Das macht das Repo instabil.

APC enthält die dem Projekt gehörende Bedeutung. Es ist der gemeinsame Vertrag, den ein Repository mit sich führt.

Guter APC-Inhalt umfasst:

  • Projektidentität
  • Agenten-Rollen
  • Wiederverwendbare Fähigkeiten
  • Kuratierter Projekt-Speicher
  • MCP-Hinweise auf Projektebene
  • Repository-weite Anweisungen in AGENTS.md

Ein Teammitglied oder eine neue Maschine sollte diese Fakten direkt nach einem Checkout lesen können.

Globaler Kontext ist anders. Er gehört einem Benutzer oder einer Workstation.

Beispiele für globalen Kontext:

  • API-Schlüssel
  • Editor-Einstellungen
  • Lokale Aliase
  • Maschinenspezifische Tool-Pfade
  • Privater Runtime-Speicher
  • Caches
  • Sitzungsprotokolle
  • Nachrichten-Logs

APX hält diesen Zustand lokal. Es speichert den Runtime-Zustand unter ~/.apx/. Dadurch bleibt das Projekt teilbar.

Das Vermischen dieser Ebenen verursacht drei Probleme:

  1. Die Portabilität geht verloren. Ein Repo, das von einer lokalen Konfiguration abhängt, ist schwer vertrauenswürdig.
  2. Reviews werden unübersichtlich. Pull Requests sollten Projektentscheidungen zeigen, nicht den Ballast der Workstation.
  3. Geheimnisse gelangen nach außen. Das Speichern lokaler Details macht es leicht, die falschen Dateien zu committen.

Bevor Sie eine Einstellung hinzufügen, fragen Sie sich: Würde ein anderer Mitwirkender dies sofort nach dem Klonen benötigen?

Wenn ja, verwenden Sie APC.

  • Ein Reviewer-Agent für jedes Klon? APC.
  • Ein persönlicher API-Schlüssel? Nicht APC.
  • Eine Projektentscheidung über Berechtigungen? APC.
  • Ein lokaler Browser-Pfad? Nicht APC.
  • Ein gemeinsamer MCP-Hinweis? APC.
  • Ein Run-Cache? Nicht APC.

Diese Regel macht die Automatisierung dauerhaft. APC liefert Ihnen portable Bedeutung. APX liefert Ihnen den lokalen Zustand.

Ziehen Sie eine klare Grenze. Das macht Ihren Stack einfacher zu debuggen, zu teilen und zwischen Tools zu verschieben.

Verwenden Sie APC für Kontext, der mit dem Repo mitreist. Wenn er persönlich oder flüchtig ist, halten Sie ihn lokal.

Source: https://dev.to/agentprojectcontext/global-context-belongs-outside-apc-4fg8

Optional learning community: https://t.me/GyaanSetuAi