liveBook · Manning

State externalization

As explained in Vibe Engineering

State externalization is an agent-workflow pattern that persists project information outside ephemeral conversation sessions in durable artifacts such as files.

State externalization persists project information in durable artifacts outside ephemeral agent sessions, allowing each task to load only the context it needs instead of growing one conversation indefinitely. section 3.5.3

A disciplined implementation separates durable project knowledge from temporary working context:

  • Persist plans, conventions, specifications, decisions, and operational knowledge in files. section 3.5.3
  • Start fresh subagents for individual tasks rather than maintaining one accumulating conversation. section 3.5.3
  • Load the relevant files into each context window as a working register, then clear that temporary context. section 3.5.3
Figure 3.11 The context pyramid: five interdependent layers of the Context Fabric. Each layer rests on the ones below it - a gap low in the pyramid undermines everything above, no matter how complete the upper layers are.

The context pyramid organizes externalized knowledge into system, code, organizational, historical, and operational layers; gaps in lower layers weaken higher-level context. section 3.5.3

How Vibe Engineering covers it

How deep it goes
Defines the pattern, contrasts working registers with memory banks, and identifies five knowledge layers without specifying a complete implementation procedure.
Examples
Uses planning directories, skill files, CLAUDE.md, AGENTS.md, specifications, plans, conventions, decisions, and operational records.
What it assumes
Assumes familiarity with agent sessions and context windows while distinguishing durable project artifacts from temporary conversational state.
What you can do after
Apply it by storing project intelligence in files and loading task-specific context into fresh agent sessions.
How it connects
Connects context windows, subagents, project state, MCP, Markdown, and structured project knowledge.

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.