# Skill Update Memory

> Auto-update .AGENTS.md files based on code changes. Use when this capability is needed.

- Skill: `tomevault-io/skill-update-memory` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/skill-update-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/skill-update-memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/skill-update-memory

---

# 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:**
```bash
python3 .agent/skills/skill-update-memory/scripts/suggest_updates.py
```

**Bootstrap Migration Mode (optional):**
```bash
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:
1. **Identify Change Type:**
    - New File -> Create entry.
    - Modified Logic -> Update description/functions.
    - Deleted -> Mark as `(Deleted)`.
2. **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

```markdown
### [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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/matrixfounder) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->