# 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