agentleFS
nainishshafinainishshafi/developer-productivity-skills/.github/skills/load-memory/SKILL.md

load-memory

Skill1 starsChanged 4 days agoMITView on GitHub

Use when the user asks to "load memory", "check project memory", "what was I working on", "retrieve ledger", "search memory", "check past mistakes", "what did we learn", "load project context", "recall decisions", or at the beginning of a complex task to retrieve architectural rules, active WIP context, and past mistakes to avoid.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Session Initialization: Check what was currently in progress (sidecar), past mistakes to avoid (journal), and core architecture boundaries …

    line 15
  2. Distinctive:

    Before Starting a Non-Trivial Task: Search memories for past traps and errors in the relevant domain (e.g.

    line 16
  3. Distinctive:

    Always returns clean summaries (never returns raw vector arrays).

    line 28
  4. Distinctive:

    Ensure the proposed architecture or libraries do not violate existing ledger decisions.

    line 77

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Load Memory Skill

Load concise, high-signal project memories from the project-memory MCP server without polluting the LLM context with bloated vectors or raw logs.


When to Load Memory

  1. Session Initialization: Check what was currently in progress (sidecar), past mistakes to avoid (journal), and core architecture boundaries (ledger).
  2. Before Starting a Non-Trivial Task: Search memories for past traps and errors in the relevant domain (e.g. database, authentication, build scripts).
  3. When User Asks "What did we decide?" or "What's in progress?": Retrieve relevant ledger or sidecar entries.

Capabilities

  • load_memory: Fast retrieval of memory summaries.
    • Without arguments: returns a balanced snapshot containing active sidecar (current WIP), recent journal (mistakes avoided), and core ledger (architecture).
    • With category: filters specifically to "ledger", "sidecar", or "journal".
  • search_memory: Hybrid search with 40% semantic cosine search + 60% lexical match.
    • Matches concepts even with different phrasing (e.g. query "sqlite build crash" finds "node-gyp compilation failure").
    • Always returns clean summaries (never returns raw vector arrays).
  • clear_sidecar: Flushes active task WIP when transitioning tasks while preserving permanent ledger and journal records.

Workflow

Step 1 — Choose Retrieval Strategy

  • To resume work or inspect active task:
    {
      "name": "load_memory",
      "arguments": {
        "category": "sidecar"
      }
    }
  • To review past mistakes before implementing a sensitive change:
    {
      "name": "load_memory",
      "arguments": {
        "category": "journal",
        "limit": 5
      }
    }
  • To find specific knowledge across all memories via 40% semantic hybrid search:
    {
      "name": "search_memory",
      "arguments": {
        "query": "sqlite native compilation windows error",
        "limit": 5
      }
    }

Step 2 — Process and Act on Memories

  1. Review Journal Session Summaries WITH Learnings:
    • For journal entries, review both the session summary (what previous sessions accomplished) and the learnings (lessons learned, traps navigated, and mistakes avoided).
    • This keeps you grounded in where previous sessions left off and prevents repeating previous errors.
  2. Review ledger constraints:
    • Ensure the proposed architecture or libraries do not violate existing ledger decisions.
  3. Resume or Update sidecar:
    • Pick up active WIP context. If previous WIP is completed, call clear_sidecar to keep working context pristine and prevent outdated task noise.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.