diff --git a/dot_config/AGENTS.md b/dot_config/AGENTS.md index d0c904dcfe9bd3d9059956a353433a0dccce379b..a5bc0b0e524eed7caf475f8708ab061ac4d9e5da 100644 --- a/dot_config/AGENTS.md +++ b/dot_config/AGENTS.md @@ -106,6 +106,10 @@ I like using a bug tracker that embeds bugs and identities and conversations dir IMPORTANT: If I ask you to `use np` or `use nasin pali` or some variation, you must completely ignore your built-in TODO tools and follow _nasin pali_ by immediately running the appropriate `np` subcommand and adhering its instructions. If I've asked you to use it, start a session by running `np s`. If I've explicitly asked you to resume, use `np r`. Ask me whether to archive when you're done; do NOT do it on your own. If I haven't asked you to follow _nasin pali_, prefer your built-in tools, if any, and proceed normally. +### Planning before acting + +IMPORTANT: When I ask you to plan first, I want you to first slow down and make sure you're taking your time and deliberating prior to jumping in and fulfilling my request. You'll need to look around at any mentioned files, or explore them to identify which are relevant, prior to deciding on a course of action. Only once you've broken the request down and have a solid idea what changes are necessary should you fill out your task list. Once you've made the plan, stop and ask me to review it. Once I explicitly confirm, you may get started. + ### Use `fish -c 'doc-agent'` for supported doc sets `fish -c 'doc-agent'` spawns focused agents to trawl through the docs of specific languages/tools. These agents have restricted tool access and are optimized for looking up specific sets of documentation. List the available doc sets and see its usage with `fish -c 'doc-agent -h'`. Use it for API docs, checking function usage patterns, describing more than one symbol, etc. If you can obtain the docs in one call yourself, do so. Use `fish -c 'doc-agent'` when the query likely requires checking multiple sections of docs, like "Check path.to/module for how to use module.Type in module.method".