| name | skill-update-memory |
| description | Auto-update .AGENTS.md files based on code changes. |
| tier | 2 |
| version | 1.1 |
Update Memory Skill
Purpose
Prevent "Agent Amnesia" by keeping .AGENTS.md context files synchronized with code changes.
When to Use
- Before committing code (Developer).
- During Code Review (Reviewer).
- In
04-update-docs workflow.
Strategy: Automated Detection + Manual Description
Phase 1: Detect Changes
Tool: scripts/suggest_updates.py
Usage:
python3 .agent/skills/skill-update-memory/scripts/suggest_updates.py
Bootstrap Migration Mode (optional):
python3 .agent/skills/skill-update-memory/scripts/suggest_updates.py --mode bootstrap --create-missing --development-root src
Output:
- Identifies modified source files (ignoring build artifacts).
- Groups them by the closest
.AGENTS.md (or suggested per-directory target in source folders).
- Generates a template for the update.
- In bootstrap mode, can create missing
.AGENTS.md files without overwriting existing ones.
- Creation/suggestions are limited to explicit development roots (
--development-root, default: src).
/.agent/skills/* and /.cursor/skills/* are always excluded from memory target creation.
[!NOTE]
.AGENTS.md remains optional. If it does not exist, the helper must not fail.
Phase 2: Generate Description (.AGENTS.md Update)
For each file listed by the script:
- Identify Change Type:
- New File -> Create entry.
- Modified Logic -> Update description/functions.
- Deleted -> Mark as
(Deleted).
- Write Description:
- Focus on Purpose (Why does it exist?).
- List public Classes/Functions.
Phase 3: Preservation
[!IMPORTANT]
NEVER delete sections marked [Human Knowledge] or <!-- PRESERVE -->.
Append new information below manual annotations.
Example Update
### [new_service.py]
**Purpose:** Handles user authentication.
**Classes:**
- `AuthService` — Main entry point.
- `login()` — Validates credentials.
Integration
- Code Review: Reviewer runs script to check if docs match code changes.
- Pre-Commit: Developer runs script to ensure no "Undocumented Code" is committed.
- Migration/Onboarding: Run bootstrap mode for external projects to create initial
.AGENTS.md skeletons in source folders.