What problem does it solve?
AI agents lose context between turns in long iterative tasks, repeating mistakes and forgetting feedback. This Skill enforces durable, file-based memory so lessons, hypotheses, and state survive across an entire session.
Core Features & Use Cases
- Mandatory file persistence: Requires an actual filesystem write to MENTAL_MODEL.md before every response, even when the final answer must follow a strict JSON schema.
- Structured note-taking: Records goals, feedback, durable lessons, commands tried, failures, hypotheses, and the next concrete action.
- Hygiene rules: Keeps the file compact, prunes stale notes, and forbids secrets or large data dumps.
- Use Case: During a multi-round debugging or benchmarking session, the agent reads its notes at the start of each turn and updates them before replying, so it never re-runs a failed command or loses track of a confirmed hypothesis.
Quick Start
Ask the agent to work through an iterative debugging task while maintaining its findings in a MENTAL_MODEL.md file in the workspace.