Przejdź do treści
Biblioteka skilli
AI i agenci · Przegląd i audyt

dev10x:memory-maintenance

/dev10x:memory-maintenance

Audytuje pliki pamięci projektu i globalnej pod kątem nieaktualnych wzorców i sprzecznych instrukcji.

Repozytorium
dev10x-claude ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format15 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Audytuje pliki pamięci projektu i globalnej pod kątem nieaktualnych wzorców i sprzecznych instrukcji.

Oryginalny opis (EN)

Audit project and global memory files for stale patterns, version-pinned paths, contradictory instructions, and anti-patterns that cause skill bypass or permission friction. Reports findings and offers to clean up. TRIGGER when: user wants to audit memory health, after a plugin upgrade, or when agents keep bypassing skills despite memory instructions. DO NOT TRIGGER when: user wants to save or recall a specific memory (use the auto memory system directly).

Jak działa

  1. Overview
  2. Orchestration
  3. Phase 1: Discover Memory Files
  4. Phase 2: Analyze for Anti-Patterns
  5. Phase 3: Present Findings
  6. Phase 4: Apply Fixes
  7. Important Notes
Sekcje z nagłówków SKILL.md, w oryginale · 129 linii, 578 słów
Podgląd SKILL.md
---
name: dev10x:memory-maintenance
description: >
  Audit project and global memory files for stale patterns,
  version-pinned paths, contradictory instructions, and anti-patterns
  that cause skill bypass or permission friction. Reports findings
  and offers to clean up.
  TRIGGER when: user wants to audit memory health, after a plugin
  upgrade, or when agents keep bypassing skills despite memory
  instructions.
  DO NOT TRIGGER when: user wants to save or recall a specific
  memory (use the auto memory system directly).
user-invocable: true
invocation-name: dev10x:memory-maintenance
allowed-tools:
  - Read
  - Glob
  - Grep
  - AskUserQuestion
  - TaskCreate
  - TaskUpdate
  - Write
  - Edit
---

# dev10x:memory-maintenance — Memory Health Auditor

## Overview

Memory files accumulate over time and can become stale, contradictory,
or actively harmful. This skill audits memory files across all scopes
(global, project, plugin) and identifies issues that cause agents to
misbehave — particularly patterns that lead to skill bypass.

## Orchestration

**REQUIRED: Create tasks before ANY work.** Execute at startup:

1. `TaskCreate(subject="Discover memory files", activeForm="Discovering")`
2. `TaskCreate(subject="Analyze for anti-patterns", activeForm="Analyzing")`
3. `TaskCreate(subject="Present findings", activeForm="Presenting")`
4. `TaskCreate(subject="Apply fixes", activeForm="Applying fixes")`

## Phase 1: Discover Memory Files

Scan all memory locations:

1. Global memory: `~/.claude/memory/*.md`
2. Dev10x global config: `~/.config/Dev10x/**`
3. MEMORY.md index file: `~/.claude/memory/MEMORY.md`

Count files per scope and report.

## Phase 2: Analyze for Anti-Patterns

For each memory file, check for these categories:

### Category 1: Stale Plugin Paths

Search for hardcoded plugin cache paths with version numbers:

```
~/.claude/plugins/cache/Dev10x-Guru/dev10x-claude/0.XX.0/...
```

These break on plugin upgrades. Replace with:
- `${CLAUDE_PLUGIN_ROOT}/...` (in skill contexts)
- MCP tool calls (in memory instructions)
- Skill() invocations (in workflow instructions)

### Category 2: Script-Calling Instructions

Search for memory entries that instruct agents to call scripts
directly instead of using Skill() or MCP tools:

- Patterns: `Bash(`, `scripts/`, `.sh`, `.py` with execution
  context (not documentation references)
- Exceptions: Memory files documenting the feedback itself
  (like `feedback_use_skills_not_scripts.md`) are not violations

### Category 3: Contradictory Instructions

Search for memory entries that contradict each other:

- Two memories giving opposite advice for the same scenario
- A memory instruction that conflicts with a CLAUDE.md rule
- A memory instruction that conflicts with a skill's SKILL.md

### Category 4: Stale References

Search for references to things that no longer exist:

- Deleted files referenced in memory
- Renamed skills referenced by old name
- Closed tickets referenced as "in progress"
- Dates more than 30 days old on project memories

### Category 5: MEMORY.md Index Drift

Compare MEMORY.md index entries against actual files:

- Files listed in MEMORY.md that don't exist on disk
- Files on disk not listed in MEMORY.md
- Descriptions that don't match file content

## Phase 3: Present Findings

Display findings grouped by category and severity:

| Severity | Meaning |
|----------|---------|
| ERROR | Actively causing misbehavior |
| WARNING | Likely to cause issues |
| INFO | Maintenance opportunity |

**REQUIRED: Call `AskUserQuestion`** (do NOT use plain text).
Options:
- **Fix all non-INFO** (Recommended) — Auto-fix ERROR and WARNING
- **Review each** — Walk through findings one by one
- **Export report** — Save to temp file
- **Done** — No changes

## Phase 4: Apply Fixes

For each approved fix:

### Stale Plugin Paths
- Replace versioned paths with generic references
- Update the memory file in place via Edit tool

### Script-Calling Instructions
- Replace script paths with Skill() or MCP tool references
- Update the instruction to use the priority order:
  MCP tool → Skill() → gh CLI → Script (fallback only)

### MEMORY.md Index Drift
- Remove entries for deleted files
- Add entries for unlisted files
- Update descriptions to match content

### Stale References
- Flag for user review (don't auto-delete — may be intentional)
- Offer to update or remove

## Important Notes

- **Read-only by default** — only edit files after user approval
- Memory files use frontmatter (name, description, type) — preserve
  it when editing
- MEMORY.md has a 200-line truncation limit — keep it concise
- Some "stale" entries may be intentional historical records —
  flag but don't auto-remove without confirmation
Pliki w paczce (2)
  • SKILL.md 5 KB
  • evals/evals.json 2 KB

Wersje

W bazie nie ma innych skilli o nazwie dev10x:memory-maintenance.

Migawka bazy z 13.11.2026 · wersja paczki 7f1b0e7d14c3 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100audit-memory
    Sprawdza pliki reguł i pamięci agenta, np. CLAUDE.md i AGENTS.md, pod kątem nieaktualnych lub sprzecznych linii.
  • 90do-it-clean
    Sprawdza pliki instrukcji dla AI, jak CLAUDE.md, AGENTS.md, skille i ustawienia, pod kątem nieaktualnych, sprzecznych i zbędnych treści.
  • 98doc-drift
    Audytuje pamięć i dokumenty ładowane przez Claude Code: CLAUDE.md, MEMORY.md, skille, agenty i pluginy, szukając nieaktualnych i sprzecznych zapisów.
  • 100audit-memory
    Przegląda pamięć projektu co jakiś czas: szuka martwych linków, duplikatów i sprzecznych notatek oraz rozrośniętego AGENTS.md.
  • 84audit
    Audytuje warstwę instrukcji i pamięci Claude Code (CLAUDE.md, AGENTS.md, CLAUDE.local.md, .claude/rules/, auto-pamięć) według listy kontrolnej z oficjalnej dokumentacji, z akcjami audit, fix, update i report.
  • 84audit-instructions
    Audytuje instrukcje Claude Code (CLAUDE.md, AGENTS.md, reguły, skille, agenci, hooki) pod kątem nieaktualnych, błędnych lub sprzecznych zapisów, bez wprowadzania zmian.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.