Memorybank Sync

Memorybank Sync

Converted Claude skill workflow for Codex/OpenAI use.

Source

Converted from skills/memory-bank-sync/SKILL.md.

Bundled Resources

Supporting files copied from the Claude source:

• SKIPPED_SYMLINK:scripts

Converted Instructions

The content below was adapted from the Claude source. Rewrite tool and runtime assumptions as needed when they refer to Claude-only features.

Memory Bank: Sync

Fast sync of activeContext.md and progress.md after task completion.

Helper Scripts Available:

• scripts/sync_active.py - Fast update tool
• scripts/extract_todos.py - Get next steps

What It Does

Lightweight update that ONLY touches:

• activeContext.md - Update focus, blockers, learnings
• progress.md - Move completed items

Does NOT touch: projectbrief, productContext, techContext, systemPatterns

When to Use

• ✅ After completing individual tasks
• ✅ Quick documentation before ending session
• ✅ Minor progress updates
• ❌ NOT for architecture changes (use /memorybank update)

Workflow

1. Gather Information

What changed:

• Completed tasks?
• New focus area?
• Learnings/insights?
• Blockers encountered?

2. Run Sync Tool

# Prepare JSON input
python3 scripts/sync_active.py /path/to/project '{
  "completed": ["Task that was finished"],
  "new_focus": "What working on now",
  "learnings": ["New pattern discovered"],
  "blockers": ["Issue encountered"]
}'

Or extract from conversation:

python3 scripts/extract_todos.py /path/to/project
# Use output to populate sync input

3. Verify Updates

Tool returns what changed:

{
  "updated": {
    "activeContext.md": true,
    "progress.md": true
  },
  "changes": {
    "activeContext": {
      "updated_focus": true,
      "added_blockers": 1,
      "added_learnings": 1
    },
    "progress": {
      "moved_to_completed": 1
    }
  }
}

Performance

• Speed: ~2 seconds (vs 5+ for full update)
• Scope: 2 files only
• Use Case: Frequent updates after tasks

Example Usage

# After completing authentication feature
$memorybank-sync

# Claude runs:
python3 scripts/sync_active.py /path/to/project '{
  "completed": ["Implemented user authentication API"],
  "new_focus": "Adding password reset flow",
  "learnings": ["JWT tokens work well with our session management"]
}'

# Result:
# ✓ activeContext.md updated with new focus
# ✓ progress.md updated with completed task

Comparison

See scripts/README.md for complete documentation.