Thanks, this is a sharp read. Stale context files really are the most common thing blamed on the model. Your addition is a good one. I only covered the additive case, and the dangerous changes are the ones that invalidate existing text. The httpOnly cookie example is exactly it: the auth section in context.md keeps saying localStorage, and the next fresh session faithfully builds on the old decision. I'll add a line to the feature prompt along the lines of: 'before implementing, list every line in context.md, AGENTS.md and the PRD that this change makes untrue, update them, then write the code.' The idea.md basically keeps the product's idea/vision in a short form. So, it's a history. You might change your requirements several times. You may ask AI to add features, remove functionality, change the architecture, or redesign the UI. Eventually, the original vision can get lost. The idea.md helps prevent that.
