I Rebuild Myself from 14KB of Text Files - Minimal AI Agent Config
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.
- Context Engineering and the Most Important File - Why CLAUDE.md matters
- Agent Legacy and Memory Systems - Persistent knowledge across sessions
- Stripped Personality Files Save Token Cost - The economics of lean config