I started with .agents/notes-and-plans/ but the agents were overzealous about putting every random thought there, so i made new system.

.agents/plans/<plan-name>/

.agents/notes/<topic>/

.agents/knowledge/<topic>/

I only commit knowledge and if knowledge gets big i add .agents/knowledge/INDEX.md

This is a good mix of human readable and agent fluent. Notes are ephemeral, knowledge is permanent.

I have a rule for knowledge that it has to be stable and mostly permanent (though updatable). And the agents are not allowed to post there unless docs are clean organized and with permission.

Notes are for jotting things down and handoffs, massaging a featureset. Agent can document at will.

Still WIP.