57 lines
2.0 KiB
Markdown
57 lines
2.0 KiB
Markdown
# 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
|