liveBook · Manning

Project memory file

As explained in Vibe Engineering

A memory file is a persistent project document that records information intended to be available across AI-agent sessions.

A project memory file is a persistent document that keeps important project guidance available across AI-agent sessions. It addresses a concrete failure: context compaction is lossy, so early instructions and bug-preventing conventions may disappear from conversation history. section 3.5.2

Repeatedly reciting a todo list is an appealing shortcut, but it can bloat the context and make an agent follow obsolete instructions too rigidly. Externalizing durable plans and rules turns ephemeral context engineering into persistent state engineering. section 3.5.2

Use memory files as a compact, deliberately maintained layer of project context:

  • Place critical project rules and conventions in a file that the agent rereads when a session starts. section 3.5.2
  • Treat the file as durable guidance rather than a transcript; conversation history remains vulnerable to compaction and summarization. section 3.5.2
  • Keep instructions flexible enough to support plan changes instead of forcing the agent to obey an outdated checklist. section 3.5.2

Session-reloaded project guidance

A CLAUDE.md file can hold project conventions that should survive conversation trimming. The agent reloads those rules at session start instead of depending on instructions mentioned once in an earlier exchange. section 3.5.2

How Vibe Engineering covers it

How deep it goes
Explains persistent-state behavior and compaction risks, but does not specify file schemas or maintenance procedures.
Examples
Uses project memory files and CLAUDE.md as examples of guidance reloaded at session start.
What you can do after
Operate/configure AI-agent workflows by placing critical project rules in a session-reloaded memory file.
How it connects
Connects memory files to context engineering, context compaction, persistent state, and project conventions.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Vibe Engineering. The section links point to the parts of the book it draws on.