catering-agents-platform

Imported from AlexanderSmyslowski/catering-agents-platform (AGENTS.md). Install upstream with npx skills add AlexanderSmyslowski/catering-agents-platform. Copyright stays with the author.

AGENTS.md

Zweck

Diese Datei richtet die Arbeit fuer ChatGPT, Hermes Agent, Codex 5.4 mini und aehnliche Agenten auf einen konsistenten Repo-Workflow aus.

Strategische Leitentscheidung STR-001 (2026-09-19)

Vor Priorisierung, weiterer Servertrennung oder neuer Härtung die kanonische STR-001-Fassung in AgenturOS zusätzlich lesen. Diese Referenz ergänzt die folgende Lesereihenfolge; sie ersetzt weder memory.md als Betriebs-/Projektstand noch eingefrorene Verträge und Freigabegrenzen.

AgenturOS bleibt das Hauptprojekt. Catering bleibt ein eigenständiges angebundenes Fachsystem. Infrastrukturarbeit nur für konkrete Betriebsrisiken oder notwendige Produkt-/Integrationsblocker vorziehen; keine vollständige Migration aller Anwendungen als pauschale Voraussetzung erfinden. Erfüllte Arbeitspakete abschließen, nicht durch theoretische Zusatzhärtung unbegrenzt erweitern. Sicherheits-, Datenintegritäts- und verbindliche Abnahmeprüfungen bleiben erhalten.

Ein zusätzlicher Catering-Server ist eine bevorzugt zu prüfende Richtung, keine bereits freigegebene Beschaffung oder Migration. Aus STR-001 keine Server-, Netzwerk-, Timer-, Daten- oder Deploymentaktion ableiten. Bei älteren Arbeitsbranches die aktuelle Strategiefassung separat lesend laden; allein dafür keinen Rebase, Merge oder Wechsel des geprüften Arbeitsstands ausführen.

Die vollständige Entscheidung wird nur in AgenturOS gepflegt. Dieser Abschnitt ist ein Einstiegshinweis, keine zweite Beschlussfassung und kein neuer Live-Status. Fehlt der Zugriff, die Grenze benennen, keine aktuelle Kenntnis erfinden und unabhängige freigegebene Arbeit fortsetzen. Lokale Hub-/Agenteninstallationen werden durch diesen Repositoryhinweis nicht automatisch aktualisiert.

Central Agent Data Hub

Dieses Repo ist im Central Agent Data Hub unter dem Projekt-Slug catering-agents-platform angebunden.

Vor substanzieller Arbeit zuerst den Hub-Kontext laden:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/agent_start.sh \
  --project catering-agents-platform \
  --query "<aktueller arbeitsfokus>"

Wenn noch kein Fokus formuliert ist:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/agent_start.sh \
  --project catering-agents-platform

Nach substanzieller Arbeit eine Abschluss-/Uebergabe-Sicht erzeugen:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/agent_finish.sh \
  --project catering-agents-platform

Nur gepruefte, nicht-sensitive Erinnerungen duerfen in den Hub zurueckgeschrieben werden:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/project_remember.sh \
  --project catering-agents-platform \
  --type fact \
  --text "Gepruefte Erinnerung." \
  --source "nicht-sensitive Quelle"

Keine Passwoerter, Tokens, FTP-Daten, privaten Kundendaten, rohen Rechnungsdaten oder Deployment-Secrets im Hub speichern. memory.md bleibt die fuehrende detaillierte Repo-Memory; der Hub ist die kanal- und agentenuebergreifende Start-/Finish- und kuratierte Writeback-Schicht.

Pflicht-Lesereihenfolge

1. memory.md
2. HANDOFF_PROMPT.md
3. README.md
4. danach die fuer den aktuellen Schritt relevanten Dateien

Verbindliche Arbeitsregeln

• Arbeite am realen Repo-Iststand.
• Keine Halluzinationen.
• Keine neuen Features ohne expliziten Auftrag.
• Keine grossen Refactorings ohne direkten Phasenbezug.
• Trenne strikt zwischen:
  • umgesetzt
  • fachlich beschrieben
  • offen
  • out of scope
• Kleine echte Bausteine vor grossen Architekturverschiebungen.
• Keine neue Persistenzwelt / kein Prisma ohne ausdrueckliche Entscheidung.
• Governance additiv, nicht als zweiter Kern.
• Finalize ist nicht gleich Freigabe.

Aktueller Governance-Anker

• ApprovalRequestRecord bleibt fuehrende Freigabewahrheit.
• SpecGovernanceStateRecord bleibt Statusspur.
• Der Governance-Pfad ist bis einschliesslich Stufe 6c umgesetzt und fachlich gruen / abnahmefaehig.
• SpecChangeSetRecord bleibt Aenderungseinheit.
• Die aktuelle Phase ist eine Konsolidierungsphase ohne neue Fachlogik.
• M1 Owned Memory Foundation ist im aktuellen Ausbaustand vorerst konsolidiert und abgeschlossen.
• Keine neue Produktflaeche, keine neue Roadmap und keine Scope-Ausweitung ohne ausdruecklichen Auftrag.

Memory-Disziplin

• memory.md ist die fuehrende Kurzreferenz.
• Bei jeder relevanten Neuerung muss memory.md versioniert fortgeschrieben werden.
• Bestehende Historie nicht still ueberschreiben.
• Neue Versionen unten in der Versionshistorie anhaengen.
• Fuer markante Zwischenstaende zusaetzlich einen Snapshot unter docs/agent-memory/ anlegen.

Handoff-Disziplin

• Ein neues Chatfenster oder ein neuer Agent beginnt immer mit dem Lesen von memory.md, HANDOFF_PROMPT.md und README.md.
• Vor Umsetzung erst den aktuellen Repo-Iststand pruefen.
• Erst danach den kleinsten sinnvollen Schritt ausfuehren.

Was aktuell out of scope bleibt

• Snapshots / lastHardApproved als Fachausbau
• Hard-Approve
• Point-of-no-return-Ausbau
• ChangeItem-Persistenz
• ChangeItem-Anzeige
• zusaetzliche Governance-Workflows
• neue API-Endpunkte ausser bei ausdruecklichem Auftrag
• neue Persistenzsysteme / Prisma

Central Agent Data Hub

Project slug: catering-agents-platform

Run Card: /Users/alexandersmyslowski/Projects/central-agent-data-hub/docs/agent-run-card.md

Use the Run Card rhythm for substantial work: start with Hub context, work inside one project boundary, finish with review, and write back only reviewed, non-sensitive memory.

Use the shared Hub before and after substantial project work:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/agent_start.sh --project catering-agents-platform --query "<current focus>"
/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/agent_start.sh --project catering-agents-platform --query "<current focus>" --review
/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/agent_finish.sh --project catering-agents-platform --review

For reviewed, non-sensitive memory candidates, dry-run first:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/project_remember.sh \
  --project catering-agents-platform \
  --type fact \
  --text "Reviewed memory candidate." \
  --source "non-sensitive source" \
  --dry-run

Then write only curated memory:

/Users/alexandersmyslowski/Projects/central-agent-data-hub/scripts/project_remember.sh \
  --project catering-agents-platform \
  --type fact \
  --text "Reviewed memory candidate." \
  --source "non-sensitive source"

Never store passwords, API keys, tokens, FTP credentials, private customer data, raw invoice data, deployment secrets, unreviewed claims, or assumptions copied from another project.