@AGENTS.md
Everything tool-neutral lives in AGENTS.md (imported above). Keep it that way: only add
things here that are specific to Claude Code, and put any new project rule in AGENTS.md
so other agents and human contributors pick it up too.
- Use the plain
flutter/dartcommands inAGENTS.md. They are what CI runs and what a contributor will have. If this checkout happens to carry a local fvm pin (.fvmrcis gitignored, so it may or may not) prefix withfvm. Do not add one, and do not tell anyone they need fvm to work on this repo. flutter runforflutter_cache_manager/example/is long-running — ask before starting it and don't leave it running in the background.
- Prefer the file tools (Read / Edit / Grep / Glob) over
cat/sed/grepin Bash for reading and editing repo files. - Use the
Exploresubagent for wide searches across both packages; the tree is small enough that targetedGrepis usually faster for anything narrower. - Run
/code-reviewon the diff before handing work over, and/security-reviewwhen a change touches download/HTTP (lib/src/web/) or on-disk persistence (lib/src/storage/).
-
Follow the forking + PR workflow in
AGENTS.md; don't push toBaseflow/flutter_cache_managerbranches directly unless the maintainer asks for it in that session. -
End commit messages with:
Co-Authored-By: Claude <noreply@anthropic.com> -
End PR descriptions with:
🤖 Generated with [Claude Code](https://claude.com/claude-code)