rene/llm-gateway
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
llm-gateway/sync/README.md

2.0 KiB
Raw Blame History

Sync Handoff Folder

Zentraler Ort für Claude Code → Codex Handoff und Cross-Session Context.

Struktur

sync/
├── README.md                          # Diese Datei
├── CURRENT.md                         # Aktueller Context (aktive Session)
├── history/
│   └── YYYY-MM-DD-topic.md           # Historische Session-Snapshots
└── .context-vault/                    # (Optional) Encrypted Credentials

CURRENT.md Format

Must-have Felder:

  • # Claude Code Context — Aktuelle Arbeitsverzeichnis, Branches, Repos
  • ## Session Status — Welche Tasks aktiv, welche blockers
  • ## Next Safe Steps — Befehle für nächste LLM-Session (Codex, neue Claude-Session)
  • ## Erik / Server Status — Security-Status, Running Services, Known Issues
  • `## Changed Files** — Was wurde modified/untracked seit letztem Commit
  • ## Warnings / Blockers — Sicherheits- oder Deployement-Blocker

History Entries

Ein Entry pro Session/Tag:

  • Format: sync/history/YYYY-MM-DD-topic.md
  • Beispiele:
    • 2026-04-29-tiplm-robot-learning.md — Session über TIPLM Robot-Trainingspool
    • 2026-04-28-peercortex-dns-validation.md — Session über PeerCortex DNS-Features

Jeder Entry sollte enthalten:

  • Session Start: Zeitstempel, wer, was geplant war
  • Key Changes: Was wurde committed/deployed
  • Remaining: Was ist offen für nächste Session
  • Context Size: Tokens used in main context window

Usage

  1. Vor Handoff (Rene → Codex/neue Claude Session):

    • git checkout sync/CURRENT.md → Read
    • git pull origin main → Get latest
    • Mit CURRENT.md starten (hat alle Infos für nahtlose Fortsetzung)

  2. Nach Session (Claude Code):

    • sync/CURRENT.md aktualisieren
    • Neuer sync/history/ Entry wenn Major Session
    • Commit nur sync/* — keine Code-Changes (außer die sind separate commits)
    • Push zu Gitea origin main

  3. Codex Integration:

    • Reads CURRENT.md automatisch auf Start
    • Schreibt neue history Entries nach Session
    • Pusht automatisch zu Gitea