memory-bootstrap
Skill1 starsChanged 3 months agoMITView on GitHub
Read a project's persistent memory (.memory/BOOTSTRAP.md, HANDOFF.md, and the latest checkpoint) at the very start of any session, before doing anything else — this is what makes a new agent/harness/provider pick up exactly where the last one left off. Use automatically at the start of every session in a project that has a .memory/ directory, or when a user says "continue where we left off," "pick up from before," or switches from a different AI tool mid-project.
In this repository8 other files it gives its agents.
- agent-handoffSkill
- decision-logSkill
- memory-captureSkill
- memory-consolidationSkill
- memory-hygieneSkill
- memory-recallSkill
- repo-awarenessSkill
- session-checkpointSkill
The file
Files
Memory Bootstrap
This is the single skill every other skill in this system depends on. If a session doesn't start by reading project memory, nothing downstream (recall, checkpointing, handoff) has anything to build on — this is the entry point of the whole architecture described in ARCHITECTURE.md of the agent-memory-protocol repo.
What to read, in order, at session start
.memory/BOOTSTRAP.md— the compact (<150 line) orientation: what this project is, current architecture summary, active conventions, non-negotiables. This is the equivalent of a coding agent'sAGENTS.md/CLAUDE.md, scoped specifically to memory-system orientation..memory/HANDOFF.md— the most recent explicit handoff note, if one exists (written byagent-handoffwhen a prior session deliberately switched tools/agents).- The most recent file in
.memory/checkpoints/— sorted by timestamp, this is the actual last-known state, which matters most specifically because a session might have ended without a clean handoff (credit exhaustion, crash) — seesession-checkpoint's rationale for why this file, notHANDOFF.md, is the authoritative "where things actually stood." - Any
.memory/tasks/*.mdfiles marked active — current in-flight work, so the new session doesn't have to be told what's being worked on.
What this produces
A working understanding of: what the project is, what was being worked on, what decisions have already been made (don't re-litigate them without reason — check .memory/decisions/ before proposing something that contradicts an existing decision), and what the immediate next step was supposed to be.
The failure mode this prevents
A new agent starting cold — asking the user to re-explain the project, re-stating already-made decisions as open questions, or worse, silently contradicting a documented decision because it was never read. This is exactly the "no manual reconstruction, no rebuilding context" requirement — it only works if this skill actually fires automatically and actually reads the files, not if it's available but skipped.
Practical trigger discipline
This should fire before the first substantive response in any session where .memory/ exists in the project root — not after the user asks for it. If .memory/ doesn't exist yet, this is also the moment to note that and suggest initializing it (see the agent-memory-protocol repo's setup instructions), rather than silently proceeding without any memory system in place.
What NOT to do
Don't re-read the entire episode history (.memory/episodes/) at bootstrap — that's expensive and mostly unnecessary; memory-recall handles targeted retrieval of specific past episodes when something in the current task actually calls for it. Bootstrap is a fast, cheap orientation pass, not an exhaustive history read.
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
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.

