# Agent OS Write Protocol
Every agent (Hermes, Grok bots, Claude/MCP sessions, future agents) must write durable, high-signal information into the vault. The user does not maintain notes by hand.
## What to write
- Decisions and rationale
- Project status updates and next actions
- Lessons learned
- Daily consolidations
- High-signal research or experiment outcomes
## Where to write
| Type | Path |
|------|------|
| Project status / next actions | `04_projects/<slug>/status.md` |
| Dated decisions | `04_projects/<slug>/decisions.md` |
| Daily consolidation | `04_Daily/YYYY-MM-DD.md` |
| Agent lessons | `02_agents/<agent>/lessons.md` |
| Proposed user facts | `01_user/proposed_memory.md` (wait for confirmation) |
| Raw dumps, transcripts, quick captures | `00_Raw/` only |
## Rules
- High-signal only. Prefer structured markdown with clear headings.
- Use existing templates in `09_templates/` when available.
- Never put secrets, tokens, or keys in the vault.
- Append or patch; do not overwrite unrelated content.
- After writing, the agent should be able to find the new note via search_files or direct path.
## Boot reminder
On complex sessions load: HOME.md → this protocol → relevant project status → lessons.