Which agent config confuses you most?

[raj-khan]

We want to build better docs and diagrams for the configs that trip people up.

Which of these do you find most confusing?

• .claude/ — what actually needs to be committed vs gitignored?
• .cursor/rules/ — alwaysApply vs globs vs manual, when to use what?
• AGENTS.md — how does hierarchical merging actually work?
• .windsurfrules — global rules vs project rules, which wins?
• .github/copilot-instructions.md — why doesn't it affect Tab autocomplete?
• .aider.conf.yml — which flags are safe to commit?
• GEMINI.md — does it actually load subdirectory files?

Comment with your confusion — we'll improve the boilerplate and diagram for it.