1.2 KiB
1.2 KiB
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.