md-heal reference: roles, token optimization, todo sync

T3 reference for md-heal: the file role map (CLAUDE.md vs AGENTS.md vs README.md), token-optimization rule, and the todo-sync rule.

Steps