# skill-update-memory

> Auto-update .AGENTS.md files based on code changes.

- Author: Sergey K.
- Repository: MatrixFounder/Agents-development
- Version: 20260202141456
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/MatrixFounder/Agents-development
- Web: https://mule.run/skillshub/@@MatrixFounder/Agents-development~skill-update-memory:20260202141456

---

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

**Output:**
- Identifies modified source files (ignoring build artifacts).
- Groups them by the closest `.AGENTS.md`.
- Generates a template for the update.

### 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.