memory-discipline

Organizes persistent agent memory into a MEMORY.md index and typed topic entries.

Updated May 26, 2026
One-click install
npx skills add https://github.com/robot-denny/ai-sketchlab --skill memory-discipline-robot-denny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: memory-discipline
Source: https://github.com/robot-denny/ai-sketchlab/tree/main/.agents/skills/memory-discipline
Command: npx skills add https://github.com/robot-denny/ai-sketchlab --skill memory-discipline-robot-denny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents with persistent project memory often accumulate stale, speculative, or repeated-wrong findings that erode trust in their reviews. This Skill defines how to write, organize, and calibrate that memory so it stays accurate and actionable across sessions. ## Core Features & Use Cases - Memory layout: A MEMORY.md index (max 200 lines, one line per topic) plus one Markdown file per topic, organized semantically rather than chronologically. - Entry format: Each entry records a claim, its reasoning (Why), an operational consequence (How to apply), a type, and a date. - Three entry types: pattern (defects to flag), false-positive-suppression (wrong findings to stop raising), and fixed-with-guard (resolved issues watched for regression). - Use Case: After a reviewer repeatedly flags a module-level cache as a concurrency bug in a single-worker runner, record a false-positive-suppression entry so the finding is never raised again. ## Quick Start Ask the agent to record a recurring review finding in project memory using the memory-discipline entry format with its Why and How-to-apply lines.

Frequently Asked Questions about memory-discipline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure persistent agent memory files?

Use a MEMORY.md index loaded every session, capped at 200 lines, with one line per topic file. Topic files are organized semantically by subject area, never chronologically by session or date.

What format should an agent memory entry use?

Each entry states a claim, one or two sentences of detail, a Why line giving the underlying reason, a How-to-apply line describing the operational consequence, a type (pattern, false-positive-suppression, or fixed-with-guard), and a recorded date.

What should not be saved in agent project memory?

Do not save session-specific context, unverified conclusions drawn from a single file, content duplicating project guidance, or facts the repository already records such as code structure and git history.

Why does renaming an agent break its persistent memory?

Per-agent memory is keyed by directory name, so renaming an agent without renaming its memory directory leaves the memory on disk unread while review appears to work normally. The directory must be renamed to match.

When should a false-positive-suppression entry be recorded?

Record one whenever a previously raised finding turned out to be wrong, with a How-to-apply line starting with 'Do not flag' or 'Accept'. This calibration prevents repeating wrong findings and preserves trust in valid ones.