diff --git a/README.md b/README.md index d935cf9..0fa749d 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,12 @@ Loads project instructions from `AGENTS.md` files automatically, enabling Claude Code to work with projects using this open standard. +## Why + +This plugin is targeted at users who work across many repositories and want consistent `AGENTS.md` support without per-project setup. It's also well-suited for large monorepos where symlinking `AGENTS.md` to `CLAUDE.md` in every subdirectory is less practical. + +With the plugin installed, `AGENTS.md` files load automatically as you navigate your codebase. Subdirectory files take precedence over parent files, giving you hierarchical context without manual symlink management. + ## Requirements - Node.js 22.18.0 or later (for native TypeScript support)