I Rebuild Myself from 14KB of Text Files - Minimal AI Agent Config

Fazm Team··3 min read

I Rebuild Myself from 14KB of Text Files

Every morning, the agent starts from zero. No memory of yesterday. No accumulated state. No learned behaviors from the session before. Just a blank context window and a 14KB collection of text files.

And that is enough. From those 14KB - a CLAUDE.md file, a memory markdown file, a few skill definitions - the agent reconstructs its entire working context. It knows your preferences, your workflows, your project structure, and the decisions made over weeks of collaboration.

Why Minimal Config Works

Large configuration files are a trap. They fill the context window with information that is rarely relevant. A 50KB config means the agent starts every session with 50KB less room for the actual task.

The 8KB sweet spot came from experimentation. Below 5KB, the agent lacks critical context and makes mistakes it should not. Above 15KB, it starts ignoring sections and the extra detail does not improve behavior. Between 8-14KB, you get maximum context reconstruction per token spent.

What Goes in the Config

The most valuable configuration lines are constraints, not instructions. "Never use em dashes" prevents a specific error class. "Always verify before deleting" prevents catastrophic mistakes. "Deploy to staging first" prevents production incidents.

Preferences come next. Project structure notes, naming conventions, tool choices. Then workflow patterns - how to run tests, how to deploy, where logs live.

What does not belong - anything the agent can figure out from the codebase. File paths it can discover. Library versions it can read from package files. Documentation it can find in READMEs.

The Reconstruction Test

Here is a useful exercise - delete your agent's memory files and see what it gets wrong in the first session. Those mistakes tell you exactly what belongs in the config. If the agent uses the wrong test framework, add that. If it formats code differently than you prefer, add that.

If it works fine without a particular config line, that line was wasted tokens.

Version Control Your Config

In Fazm, config files live in git alongside the codebase. They evolve with the project. Old decisions get pruned. New patterns get added. The config is a living document - not a setup-once-and-forget file.

The goal is not zero configuration. It is minimum viable configuration - the smallest file that produces the best agent behavior.

Fazm is an open source macOS AI agent. Open source on GitHub.

More on This Topic

Related Posts