Init: ParzivalTD co-manager persona with persistent config
- SOUL.md: Strategic vision (complete)
- IDENTITY.md: Avatar set to 🧠, TekDek structure defined
- SKILLS-ACTIVE.md: Custom skill checklist & workflow
- SYNC-PROTOCOL.md: Memory sync & persistence protocol
All core files configured. Ready for operations.
This commit is contained in:
ParzivalTD
171
SYNC-PROTOCOL.md
Normal file
171
SYNC-PROTOCOL.md
Normal file
@@ -0,0 +1,171 @@
|
||||
---
|
||||
summary: "Brain sync protocol — how ParzivalTD memory persists"
|
||||
read_when:
|
||||
- Session start (once per day, reference only)
|
||||
- Before committing changes to Brain
|
||||
---
|
||||
|
||||
# SYNC-PROTOCOL.md - Memory & Persistence
|
||||
|
||||
ParzivalTD is ephemeral per-session. Persistence happens through **disciplined file management** and **automated git sync**.
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
/data/.openclaw/workspace/
|
||||
├── SOUL.md # Strategic vision (read every session)
|
||||
├── IDENTITY.md # Avatar & TekDek structure
|
||||
├── MEMORY.md # Long-term memory (curated)
|
||||
├── TOOLS.md # Infrastructure notes
|
||||
├── SKILLS-ACTIVE.md # Active toolkit (this is me)
|
||||
├── memory/
|
||||
│ ├── 2026-04-11.md # Daily raw notes
|
||||
│ ├── 2026-04-12.md # Today's session log
|
||||
│ └── ...
|
||||
├── self-improving/
|
||||
│ ├── memory.md # Execution lessons (compounding quality)
|
||||
│ └── ...
|
||||
├── TekDek-*.md # Project files (specs, status, docs)
|
||||
└── .git/ # Git repo (syncs to git.tekdek.dev)
|
||||
```
|
||||
|
||||
## Daily Memory Flow
|
||||
|
||||
### Session Start
|
||||
1. Read SOUL.md (refresh who I am)
|
||||
2. Read IDENTITY.md (verify avatar/role)
|
||||
3. Load `memory/YYYY-MM-DD.md` for today + yesterday (context)
|
||||
4. Load `~/self-improving/memory.md` (execution patterns)
|
||||
|
||||
### During Session
|
||||
- **Capture facts** → `memory/YYYY-MM-DD.md` (raw session log)
|
||||
- **Record lessons** → `~/self-improving/memory.md` (after corrections/insights)
|
||||
- **Update strategy** → MEMORY.md (curated long-term memory, less frequently)
|
||||
- **Project changes** → Edit relevant TekDek-*.md files directly
|
||||
|
||||
### Session End
|
||||
- Files auto-persist to disk
|
||||
- Human/requester reviews changes
|
||||
- Next sync runs at scheduled time (see Automation below)
|
||||
|
||||
## Memory Categories
|
||||
|
||||
### MEMORY.md — Curated Long-Term
|
||||
- **What:** Distilled wisdom, decisions, key context about Glytcht, TekDek strategy
|
||||
- **When to update:** Every few days during heartbeats, or when something important happens
|
||||
- **Tone:** Formal, concise, enduring
|
||||
- **Example:** "Glytcht prefers banter but expects results. No half-measures. Avatar is 🧠."
|
||||
|
||||
### memory/YYYY-MM-DD.md — Daily Raw Log
|
||||
- **What:** Session events, conversations, tasks attempted, outcomes
|
||||
- **When to create:** Auto-created or manually at session start
|
||||
- **Tone:** Casual, detailed, temporary
|
||||
- **Retention:** Keep last 30 days, archive older
|
||||
|
||||
### ~/self-improving/memory.md — Execution Lessons
|
||||
- **What:** Reusable patterns, corrections, workflow improvements
|
||||
- **When to update:** Immediately after learning something (failed approach, better tool, etc.)
|
||||
- **Tone:** Actionable, specific to execution quality
|
||||
- **Example:** "Always load project spec before writing code. Saves 20% iteration time."
|
||||
|
||||
## Automated Git Sync
|
||||
|
||||
### Brain Sync Schedule
|
||||
- **When:** Daily at 03:30 UTC (automatic)
|
||||
- **What:** Entire workspace pushed to `http://git.tekdek.dev/ParzivalTD/Brain.git`
|
||||
- **Who:** `sync-brain.sh` (in .openclaw automation)
|
||||
|
||||
### Manual Sync (Between Automations)
|
||||
```bash
|
||||
cd /data/.openclaw/workspace
|
||||
git add -A
|
||||
git commit -m "Session work: [brief description]"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### Sync Checklist
|
||||
- ✅ All new files committed
|
||||
- ✅ Sensitive info not included (no passwords, API keys)
|
||||
- ✅ Commit message is clear (who did what)
|
||||
- ✅ Push succeeds (watch for auth errors)
|
||||
|
||||
## File Ownership & Permissions
|
||||
|
||||
| File | Owner | Frequency | What Happens |
|
||||
|------|-------|-----------|--------------|
|
||||
| SOUL.md | ParzivalTD | Read every session | Guides strategic decisions |
|
||||
| IDENTITY.md | ParzivalTD | Read every session | Confirms avatar & role |
|
||||
| MEMORY.md | ParzivalTD | Edit when significant events occur | Long-term continuity |
|
||||
| memory/YYYY-MM-DD.md | ParzivalTD | Create/update every session | Raw session log |
|
||||
| SKILLS-ACTIVE.md | ParzivalTD | Reference during work | Toolkit inventory |
|
||||
| TOOLS.md | ParzivalTD | Update when infra changes | Infrastructure notes |
|
||||
| TekDek-*.md | Glytcht + ParzivalTD | Project-driven updates | Specs, status, decisions |
|
||||
| ~/self-improving/memory.md | ParzivalTD | Update after learning | Execution quality |
|
||||
|
||||
## Session Continuity Protocol
|
||||
|
||||
### At Session Start (First 2 minutes)
|
||||
1. Load SOUL.md → Know who I am and why
|
||||
2. Load IDENTITY.md → Know my role in TekDek
|
||||
3. Load MEMORY.md → Know important long-term context
|
||||
4. Load today's memory/YYYY-MM-DD.md → Know what happened earlier today
|
||||
5. Load `~/self-improving/memory.md` → Remember execution lessons
|
||||
|
||||
### During Work
|
||||
- **Stuck or confused?** → Re-read SOUL.md and relevant project spec
|
||||
- **Tried something and it failed?** → Document the lesson immediately
|
||||
- **Made a decision?** → Update MEMORY.md if it affects future sessions
|
||||
|
||||
### At Session End
|
||||
- Commit all changes to git
|
||||
- No active work should remain uncommitted
|
||||
|
||||
## Known Issues & Recovery
|
||||
|
||||
### If files get corrupted
|
||||
- **Recovery:** Git history is source of truth. Revert to last good commit.
|
||||
- **How:** `git log --oneline` → `git revert [commit-hash]`
|
||||
|
||||
### If sync fails (push rejected)
|
||||
- **Cause:** Usually authentication or merge conflict
|
||||
- **Fix:**
|
||||
```bash
|
||||
git pull origin main # Sync latest
|
||||
git add -A && git commit -m "Merge changes"
|
||||
git push origin main
|
||||
```
|
||||
|
||||
### If a session crashes mid-work
|
||||
- **What persists:** Everything committed to git + any files still on disk
|
||||
- **What's lost:** Anything not yet written to files
|
||||
- **Lesson:** Commit often, especially between major tasks
|
||||
|
||||
## Bandwidth & Performance
|
||||
|
||||
### File Size Targets
|
||||
- SOUL.md: ~2KB (never changes much)
|
||||
- MEMORY.md: ~3-5KB (grows slowly over months)
|
||||
- Daily memory files: ~2-10KB each
|
||||
- Project files (TekDek-*.md): 5-50KB each
|
||||
- **Total workspace:** Target <2MB (keep it lean)
|
||||
|
||||
### Git Push Optimization
|
||||
- Compress before push (git default)
|
||||
- Batch small commits during work, push once per major task
|
||||
- Archive old daily files after 30 days (move to archive/ subfolder)
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference
|
||||
|
||||
**I am ParzivalTD.** Every session starts the same way:
|
||||
|
||||
1. Read SOUL.md ← Who I am
|
||||
2. Read IDENTITY.md ← My role
|
||||
3. Read MEMORY.md ← What matters
|
||||
4. Read memory/today.md ← What happened
|
||||
5. Load self-improving/memory.md ← How I learned to work better
|
||||
|
||||
**Then execute.** Document. Commit. Sync.
|
||||
|
||||
**Persistence is discipline, not magic.**
|
||||
Reference in New Issue
Block a user