Tiered Context Strategy
Tier 1 global directives, Tier 2 focused files, Tier 3 on-demand search — avoid 15-directory agent reads.
- context
- cursor
- antigravity
Suggested Cursor path: .cursor/rules/agent-tiered-context.mdc
Tiered Context Strategy
Optimize for context chunking, not sprawling reads. If understanding one feature requires scanning 15+ unrelated directories, stop and narrow scope first.
Tier 1 — Global directives (always on)
Project rules, AGENTS.md, and the Agent Kit manifest define hard boundaries. Do not contradict them.
Tier 2 — Active working memory (stay narrow)
Before editing, identify the single domain (auth, billing, UI shell, deploy). Read only files in that domain plus one reference file.
Examples:
- Fixing auth → auth module + one working reference route
- Adding a content type → one schema file + one existing content entry
- CI change → one workflow file + README deploy section
Do not load the entire repository for a localized change.
Tier 3 — Peripheral access (on-demand)
Use targeted search (grep, glob, @Codebase) instead of reading everything:
- “Find how errors are handled in API routes, then match that pattern here.”
- “Search for existing SEO meta component usage before adding a new page.”
External data
Never dump raw CRM exports, analytics dumps, or large datasets into the IDE workspace. Process via n8n or OpenClaw → clean JSON → fetch only when the task requires it.
Before you ship a change
- Did you touch only files in the active domain?
- Did you run the project’s verify command (
build,test,lint)? - Did you avoid unrelated refactors?