emaraschio/cursor-commands / .cursor/skill-contracts/update-memory-bank
update-memory-bank
VerifiedSync memory bank with repository state
Overview
Sync the memory bank with the current state of the repository and recent agent interactions. Run after significant work sessions, feature completions, or when context has drifted from reality.
Memory Bank Files
Each file has a distinct responsibility. Update only what changed:
| File | Purpose | Update when... |
|---|---|---|
activeContext.md | Current state, recent commits, active work | After any meaningful commits |
progress.md | Changelog, milestones, statistics | After feature completion |
techContext.md | Tech stack, tools, environment | Tech stack changes |
systemPatterns.md | Coding standards, patterns | New patterns established |
projectbrief.md | Project purpose and scope | Rarely, only on major scope shifts |
Steps
-
Gather current state
- Run
git log --oneline -15to capture recent commits - Note any new files, commands, or rules added since last update
- Check
activeContext.md"Last Updated" date to understand the gap
- Run
-
Update each relevant file
activeContext.md: Update "Last Updated" date, "Latest Commits" list, "Recent Focus Areas", and "Cursor Commands Inventory" count if it changedprogress.md: Add a changelog entry for the current month if work occurred; update statistics if counts changed- Other files: Only touch if their specific domain changed
-
Verify accuracy
- Confirm commit hashes and descriptions match
git logoutput - Remove stale "Active Work Items" that are now complete
- Ensure statistics (command count, etc.) reflect reality
- Confirm commit hashes and descriptions match
-
Commit
- Use format:
docs(memory-bank): update memory bank with latest changes - Stage only memory bank files:
git add .cursor/memory-bank/ - Push to remote after commit
- Use format:
Guardrails
- Record only verified state; do not invent commits, files, or statistics.
- Update only the files whose domain changed; leave unchanged files alone.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |